@spfunctions/cli 1.6.1 → 1.7.2

package/dist/client.d.ts

@@ -33,3 +33,6 @@ export declare function kalshiFetchEvents(seriesTicker: string): Promise<any[]>;
 export declare function kalshiFetchMarket(ticker: string): Promise<any>;
 export declare function kalshiFetchMarketsBySeries(seriesTicker: string): Promise<any[]>;
 export declare function kalshiFetchMarketsByEvent(eventTicker: string): Promise<any[]>;
+export declare function fetchGlobalContext(): Promise<any>;
+export declare function fetchQuery(q: string): Promise<any>;
+export declare function fetchTraditionalMarkets(): Promise<any>;

package/dist/client.js

@@ -12,6 +12,9 @@ exports.kalshiFetchEvents = kalshiFetchEvents;
 exports.kalshiFetchMarket = kalshiFetchMarket;
 exports.kalshiFetchMarketsBySeries = kalshiFetchMarketsBySeries;
 exports.kalshiFetchMarketsByEvent = kalshiFetchMarketsByEvent;
+exports.fetchGlobalContext = fetchGlobalContext;
+exports.fetchQuery = fetchQuery;
+exports.fetchTraditionalMarkets = fetchTraditionalMarkets;
 const DEFAULT_API_URL = 'https://simplefunctions.dev';
 const KALSHI_BASE = 'https://api.elections.kalshi.com/trade-api/v2';
 // ===== SF API Client =====
@@ -154,3 +157,21 @@ async function kalshiFetchMarketsByEvent(eventTicker) {
     });
     return data.markets || [];
 }
+// ===== Public Endpoints (no auth) =====
+const SF_PUBLIC_BASE = 'https://simplefunctions.dev';
+async function fetchGlobalContext() {
+    const res = await fetch(`${SF_PUBLIC_BASE}/api/public/context`);
+    if (!res.ok)
+        throw new Error(`Context API error: ${res.status}`);
+    return res.json();
+}
+async function fetchQuery(q) {
+    const res = await fetch(`${SF_PUBLIC_BASE}/api/public/query?q=${encodeURIComponent(q)}`);
+    if (!res.ok)
+        throw new Error(`Query API error: ${res.status}`);
+    return res.json();
+}
+async function fetchTraditionalMarkets() {
+    const ctx = await fetchGlobalContext();
+    return ctx.traditionalMarkets || [];
+}

package/dist/commands/agent.js

@@ -746,6 +746,30 @@ async function agentCommand(thesisId, opts) {
                 };
             },
         },
+        {
+            name: 'global_context',
+            label: 'Market Snapshot',
+            description: 'Global market snapshot — top movers, expiring contracts, milestones, liquidity, signals. No thesis needed.',
+            parameters: emptyParams,
+            execute: async () => {
+                const { fetchGlobalContext } = await import('../client.js');
+                const data = await fetchGlobalContext();
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
+        {
+            name: 'query',
+            label: 'Query',
+            description: 'LLM-enhanced prediction market knowledge search. Ask any question about prediction markets, macro, geopolitics. Returns structured answer with live market prices, thesis data, and key factors.',
+            parameters: Type.Object({
+                q: Type.String({ description: 'Natural language query (e.g. "iran oil prices", "fed rate cut 2026")' }),
+            }),
+            execute: async (_toolCallId, params) => {
+                const { fetchQuery } = await import('../client.js');
+                const data = await fetchQuery(params.q);
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'inject_signal',
             label: 'Inject Signal',
@@ -2540,6 +2564,26 @@ async function runPlainTextAgent(params) {
                 return { content: [{ type: 'text', text: JSON.stringify(ctx, null, 2) }], details: {} };
             },
         },
+        {
+            name: 'global_context', label: 'Market Snapshot',
+            description: 'Global market snapshot — top movers, expiring contracts, milestones, liquidity, signals. No thesis needed.',
+            parameters: emptyParams,
+            execute: async () => {
+                const { fetchGlobalContext } = await import('../client.js');
+                const data = await fetchGlobalContext();
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
+        {
+            name: 'query', label: 'Query',
+            description: 'LLM-enhanced prediction market knowledge search. Returns structured answer with live prices, thesis data, key factors.',
+            parameters: Type.Object({ q: Type.String({ description: 'Natural language query' }) }),
+            execute: async (_id, p) => {
+                const { fetchQuery } = await import('../client.js');
+                const data = await fetchQuery(p.q);
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'inject_signal', label: 'Inject Signal',
             description: 'Inject a signal into the thesis',

package/dist/commands/context.d.ts

@@ -1,4 +1,4 @@
-export declare function contextCommand(id: string, opts: {
+export declare function contextCommand(id: string | undefined, opts: {
     json?: boolean;
     apiKey?: string;
     apiUrl?: string;

package/dist/commands/context.js

@@ -5,6 +5,64 @@ const client_js_1 = require("../client.js");
 const kalshi_js_1 = require("../kalshi.js");
 const utils_js_1 = require("../utils.js");
 async function contextCommand(id, opts) {
+    // No thesis ID → global market snapshot
+    if (!id) {
+        const res = await fetch('https://simplefunctions.dev/api/public/context');
+        if (!res.ok) {
+            console.error(`  Error: ${res.status} ${await res.text()}`);
+            return;
+        }
+        const data = await res.json();
+        if (opts.json) {
+            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)}`);
+            }
+            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)}`);
+            }
+            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}`);
+            }
+            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)}`);
+            }
+            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}`);
+            }
+            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`);
+        return;
+    }
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const ctx = await client.getContext(id);
     if (opts.json) {

package/dist/commands/query.js

@@ -62,11 +62,18 @@ async function queryCommand(q, opts) {
         }
         console.log();
     }
-    // Thesis
-    if (data.thesis) {
+    // Theses
+    if (data.theses?.length > 0) {
+        console.log(`  \x1b[1mTheses\x1b[22m`);
+        for (const t of data.theses.slice(0, 3)) {
+            console.log(`    ${t.confidence || '?'}%  ${String(t.edges || 0).padStart(2)} edges  ${t.title.slice(0, 50)}`);
+        }
+        console.log();
+    }
+    else if (data.thesis) {
+        // Backward compat
         const t = data.thesis;
         console.log(`  \x1b[1mThesis\x1b[22m`);
-        console.log(`    ${t.title.slice(0, 60)}`);
         console.log(`    ${t.confidence}% confidence  ${t.edges} edges  /thesis/${t.slug}`);
         console.log();
     }

package/dist/commands/trade.js

@@ -5,6 +5,9 @@ exports.sellCommand = sellCommand;
 const kalshi_js_1 = require("../kalshi.js");
 const config_js_1 = require("../config.js");
 const utils_js_1 = require("../utils.js");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
 async function buyCommand(ticker, qty, opts) {
     (0, config_js_1.requireTrading)();
     await executeOrder(ticker, qty, 'buy', opts);
@@ -62,6 +65,27 @@ async function executeOrder(ticker, qty, action, opts) {
         if (order.fill_count_fp)
             console.log(`  Filled: ${order.fill_count_fp}/${order.initial_count_fp || quantity}`);
         console.log();
+        // Auto-log trade to journal
+        try {
+            const journalDir = (0, path_1.join)((0, os_1.homedir)(), '.sf');
+            if (!(0, fs_1.existsSync)(journalDir))
+                (0, fs_1.mkdirSync)(journalDir, { recursive: true });
+            const entry = JSON.stringify({
+                ts: new Date().toISOString(),
+                action,
+                ticker,
+                side,
+                quantity,
+                price: priceCents || null,
+                type: orderType,
+                orderId: order.order_id || null,
+                status: order.status || null,
+                filled: order.fill_count_fp || null,
+            }) + '\n';
+            (0, fs_1.appendFileSync)((0, path_1.join)(journalDir, 'trade-journal.jsonl'), entry);
+            console.log(`  ${utils_js_1.c.dim}Trade logged to ~/.sf/trade-journal.jsonl${utils_js_1.c.reset}`);
+        }
+        catch { /* journal logging is best-effort */ }
     }
     catch (err) {
         const msg = err.message || String(err);

package/dist/index.js

@@ -77,7 +77,7 @@ const GROUPED_HELP = `
 \x1b[1mThesis\x1b[22m
   \x1b[36mlist\x1b[39m                       List all theses
   \x1b[36mget\x1b[39m <id>                   Full thesis details
-  \x1b[36mcontext\x1b[39m <id> [--json]      Thesis snapshot \x1b[2m(primary for agents)\x1b[22m
+  \x1b[36mcontext\x1b[39m [id] [--json]      Market snapshot (no id) or thesis context (with id)
   \x1b[36mcreate\x1b[39m "thesis"            Create a new thesis
   \x1b[36msignal\x1b[39m <id> "content"      Inject a signal
   \x1b[36mevaluate\x1b[39m <id>              Trigger deep evaluation
@@ -221,7 +221,7 @@ async function interactiveEntry() {
     console.log();
 }
 // ── Pre-action guard: check configuration ────────────────────────────────────
-const NO_CONFIG_COMMANDS = new Set(['setup', 'help', 'scan', 'explore', 'query', 'milestones', 'forecast', 'settlements', 'balance', 'orders', 'fills', 'schedule', 'announcements', 'history', 'liquidity', 'book', 'prompt', 'sf']);
+const NO_CONFIG_COMMANDS = new Set(['setup', 'help', 'scan', 'explore', 'query', 'context', '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))
@@ -279,10 +279,10 @@ program
     const g = cmd.optsWithGlobals();
     await run(() => (0, get_js_1.getCommand)(id, { json: opts.json, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
-// ── sf context <id> ───────────────────────────────────────────────────────────
+// ── sf context [id] ───────────────────────────────────────────────────────────
 program
-    .command('context <id>')
-    .description('Get thesis context snapshot (primary command for agents)')
+    .command('context [id]')
+    .description('Context snapshot. With ID: thesis-specific. Without: global market snapshot (no auth)')
     .option('--json', 'Output raw JSON')
     .action(async (id, opts, cmd) => {
     const g = cmd.optsWithGlobals();

package/dist/telegram/agent-bridge.js

@@ -38,6 +38,26 @@ async function buildTools(sfClient, thesisId, latestContext) {
                 return { content: [{ type: 'text', text: JSON.stringify(ctx, null, 2) }], details: {} };
             },
         },
+        {
+            name: 'global_context', label: 'Snapshot',
+            description: 'Global market snapshot — movers, expiring, milestones, liquidity, signals. No thesis needed.',
+            parameters: emptyParams,
+            execute: async () => {
+                const { fetchGlobalContext } = await import('../client.js');
+                const data = await fetchGlobalContext();
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
+        {
+            name: 'query', label: 'Query',
+            description: 'LLM-enhanced prediction market search. Returns answer, live prices, key factors.',
+            parameters: Type.Object({ q: Type.String({ description: 'Question' }) }),
+            execute: async (_id, p) => {
+                const { fetchQuery } = await import('../client.js');
+                const data = await fetchQuery(p.q);
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'inject_signal', label: 'Signal',
             description: 'Inject a signal (news, note, observation) into the thesis',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spfunctions/cli",
-  "version": "1.6.1",
+  "version": "1.7.2",
   "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"