@spfunctions/cli 1.7.4 → 1.7.7

package/dist/client.d.ts

@@ -27,6 +27,22 @@ export declare class SFClient {
     createStrategyAPI(id: string, data: Record<string, unknown>): Promise<any>;
     updateStrategyAPI(thesisId: string, strategyId: string, data: Record<string, unknown>): Promise<any>;
     deleteStrategyAPI(thesisId: string, strategyId: string): Promise<any>;
+    searchX(query: string, opts?: {
+        mode?: string;
+        hours?: number;
+        limit?: number;
+    }): Promise<any>;
+    getXVolume(query: string, opts?: {
+        hours?: number;
+        granularity?: string;
+    }): Promise<any>;
+    searchXNews(query: string, opts?: {
+        limit?: number;
+    }): Promise<any>;
+    getXAccount(username: string, opts?: {
+        hours?: number;
+        limit?: number;
+    }): Promise<any>;
 }
 export declare function kalshiFetchAllSeries(): Promise<any[]>;
 export declare function kalshiFetchEvents(seriesTicker: string): Promise<any[]>;

package/dist/client.js

@@ -107,6 +107,28 @@ class SFClient {
     async deleteStrategyAPI(thesisId, strategyId) {
         return this.request('DELETE', `/api/thesis/${thesisId}/strategies/${strategyId}`);
     }
+    // ── X (Twitter) operations ──
+    async searchX(query, opts) {
+        const mode = opts?.mode || 'summary';
+        const hours = opts?.hours || 24;
+        const limit = opts?.limit || 20;
+        return this.request('GET', `/api/x/search?q=${encodeURIComponent(query)}&mode=${mode}&hours=${hours}&limit=${limit}`);
+    }
+    async getXVolume(query, opts) {
+        const hours = opts?.hours || 72;
+        const granularity = opts?.granularity || 'hour';
+        return this.request('GET', `/api/x/volume?q=${encodeURIComponent(query)}&hours=${hours}&granularity=${granularity}`);
+    }
+    async searchXNews(query, opts) {
+        const limit = opts?.limit || 10;
+        return this.request('GET', `/api/x/news?q=${encodeURIComponent(query)}&limit=${limit}`);
+    }
+    async getXAccount(username, opts) {
+        const user = username.replace(/^@/, '');
+        const hours = opts?.hours || 24;
+        const limit = opts?.limit || 20;
+        return this.request('GET', `/api/x/account?username=${user}&hours=${hours}&limit=${limit}`);
+    }
 }
 exports.SFClient = SFClient;
 // ===== Kalshi Public API (no auth) =====

package/dist/commands/agent.js

@@ -770,6 +770,17 @@ async function agentCommand(thesisId, opts) {
                 return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
             },
         },
+        {
+            name: 'get_markets',
+            label: 'Traditional Markets',
+            description: 'Get traditional market prices via Databento: S&P 500 (SPY), VIX (VIXY), 20Y Treasury (TLT), Gold (GLD), Oil (USO). Daily close + 1-day change.',
+            parameters: emptyParams,
+            execute: async () => {
+                const { fetchTraditionalMarkets } = await import('../client.js');
+                const data = await fetchTraditionalMarkets();
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'inject_signal',
             label: 'Inject Signal',
@@ -1490,6 +1501,57 @@ async function agentCommand(thesisId, opts) {
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], details: {} };
         },
     });
+    // ── X (Twitter) tools ─────────────────────────────────────────────────────
+    tools.push({
+        name: 'search_x',
+        label: 'X Search',
+        description: 'Search X (Twitter) for recent discussions on a topic. Returns top posts with engagement metrics, sentiment analysis, and key themes. Use for social signal research on any prediction market topic.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query (e.g. "iran oil", "fed rate cut", "$BTC")' }),
+            mode: Type.Optional(Type.String({ description: '"summary" (default, with AI analysis) or "raw" (just posts)' })),
+            hours: Type.Optional(Type.Number({ description: 'Hours of history (default 24)' })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const data = await sfClient.searchX(params.query, { mode: params.mode, hours: params.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_volume',
+        label: 'X Volume',
+        description: 'Get X discussion volume trend for a topic — total posts, velocity change vs prior period, peak time, and hourly timeseries. Use to detect social momentum shifts.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            hours: Type.Optional(Type.Number({ description: 'Hours of history (default 72)' })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const data = await sfClient.getXVolume(params.query, { hours: params.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_news',
+        label: 'X News',
+        description: 'Get news stories trending on X — titles, summaries, categories, and ticker mentions. Use for breaking news and narrative tracking.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            limit: Type.Optional(Type.Number({ description: 'Max stories (default 10)' })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const data = await sfClient.searchXNews(params.query, { limit: params.limit });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_account',
+        label: 'X Account',
+        description: 'Get recent posts from a specific X account. Use to track key opinion leaders, officials, or analysts.',
+        parameters: Type.Object({
+            username: Type.String({ description: 'X username (with or without @)' }),
+            hours: Type.Optional(Type.Number({ description: 'Hours of history (default 24)' })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const data = await sfClient.getXAccount(params.username, { hours: params.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    });
     // ── Trading tools (conditional on tradingEnabled) ──────────────────────────
     const config = (0, config_js_1.loadConfig)();
     if (config.tradingEnabled) {
@@ -1622,9 +1684,12 @@ When discussing an edge, always state contract expiry and next identifiable cata
 
 ### Research workflow
 For complex questions, chain multiple tool calls:
-1. get_context 2. inspect_book 3. get_liquidity 4. web_search 5. synthesize
+1. get_context 2. inspect_book 3. get_liquidity 4. web_search 5. search_x 6. synthesize
 Don't answer a complex question with a single tool call.
 
+### Social signal research
+Use search_x to check X/Twitter sentiment on any topic — especially useful for geopolitical events, macro shifts, and breaking news that moves prediction markets. Use x_volume to detect discussion spikes (velocity > 1 = increasing attention). Use x_account to track specific analysts or officials.
+
 ### Conditional rules
 - Portfolio/positions questions: flag correlated exposure — positions sharing upstream causal nodes are not independent bets.
 - No catalyst visible within 30 days + edge not improving: flag "stale capital risk."
@@ -2584,6 +2649,16 @@ async function runPlainTextAgent(params) {
                 return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
             },
         },
+        {
+            name: 'get_markets', label: 'Traditional Markets',
+            description: 'Traditional market prices via Databento: SPY, VIX, Treasury, Gold, Oil. Daily close + change.',
+            parameters: emptyParams,
+            execute: async () => {
+                const { fetchTraditionalMarkets } = await import('../client.js');
+                const data = await fetchTraditionalMarkets();
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
         {
             name: 'inject_signal', label: 'Inject Signal',
             description: 'Inject a signal into the thesis',
@@ -3169,6 +3244,53 @@ async function runPlainTextAgent(params) {
             },
         },
     ];
+    // ── X (Twitter) tools for plain mode ──────────────────────────────────────
+    tools.push({
+        name: 'search_x', label: 'X Search',
+        description: 'Search X (Twitter) for recent discussions. Returns posts, sentiment, themes.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            mode: Type.Optional(Type.String({ description: '"summary" or "raw"' })),
+            hours: Type.Optional(Type.Number({ description: 'Hours (default 24)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.searchX(p.query, { mode: p.mode, hours: p.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_volume', label: 'X Volume',
+        description: 'X discussion volume trend — total posts, velocity, peak time, timeseries.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            hours: Type.Optional(Type.Number({ description: 'Hours (default 72)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.getXVolume(p.query, { hours: p.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_news', label: 'X News',
+        description: 'News stories trending on X — titles, summaries, tickers.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            limit: Type.Optional(Type.Number({ description: 'Max stories (default 10)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.searchXNews(p.query, { limit: p.limit });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_account', label: 'X Account',
+        description: 'Recent posts from a specific X account.',
+        parameters: Type.Object({
+            username: Type.String({ description: 'X username (with or without @)' }),
+            hours: Type.Optional(Type.Number({ description: 'Hours (default 24)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.getXAccount(p.username, { hours: p.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    });
     // ── Trading tools (conditional on tradingEnabled) for plain mode ──────────
     const config = (0, config_js_1.loadConfig)();
     if (config.tradingEnabled) {
@@ -3270,7 +3392,8 @@ Kill conditions: each causal node has a falsifier. Check these first when evalua
 
 Always state contract expiry and next catalyst. No catalyst = flag capital lock risk.
 
-For complex questions, chain: get_context -> inspect_book -> get_liquidity -> web_search -> synthesize.
+For complex questions, chain: get_context -> inspect_book -> get_liquidity -> web_search -> search_x -> synthesize.
+Use search_x for social sentiment on any topic. Use x_volume to detect discussion spikes. Use x_account to track key people.
 
 Flag correlated exposure across positions sharing upstream nodes. If nothing to do, say so.
 

package/dist/commands/query.js

@@ -49,16 +49,29 @@ async function queryCommand(q, opts) {
         }
         console.log();
     }
-    // Markets
-    if (data.markets?.length > 0) {
+    // Markets — show each venue separately
+    const formatMarket = (m) => {
+        const venue = m.venue === 'kalshi' ? '\x1b[36mK\x1b[39m' : '\x1b[35mP\x1b[39m';
+        const vol = m.volume > 1_000_000 ? `${(m.volume / 1_000_000).toFixed(1)}M` :
+            m.volume > 1_000 ? `${(m.volume / 1_000).toFixed(0)}K` :
+                String(Math.round(m.volume));
+        const ticker = m.ticker ? ` ${m.ticker}` : '';
+        console.log(`    ${venue} ${String(m.price).padStart(3)}¢  vol ${vol.padStart(6)}  ${m.title.slice(0, 55)}${ticker}`);
+    };
+    const kalshiList = data.kalshi || [];
+    const polyList = data.polymarket || [];
+    const hasMarkets = kalshiList.length > 0 || polyList.length > 0;
+    if (hasMarkets) {
         console.log('  \x1b[1mMarkets\x1b[22m');
-        for (const m of data.markets.slice(0, 8)) {
-            const venue = m.venue === 'kalshi' ? '\x1b[36mK\x1b[39m' : '\x1b[35mP\x1b[39m';
-            const vol = m.volume > 1_000_000 ? `${(m.volume / 1_000_000).toFixed(1)}M` :
-                m.volume > 1_000 ? `${(m.volume / 1_000).toFixed(0)}K` :
-                    String(m.volume);
-            const ticker = m.ticker ? ` ${m.ticker}` : '';
-            console.log(`    ${venue} ${String(m.price).padStart(3)}¢  vol ${vol.padStart(6)}  ${m.title.slice(0, 55)}${ticker}`);
+        if (kalshiList.length > 0) {
+            for (const m of kalshiList.slice(0, 8))
+                formatMarket(m);
+        }
+        if (polyList.length > 0) {
+            if (kalshiList.length > 0)
+                console.log(); // separator between venues
+            for (const m of polyList.slice(0, 8))
+                formatMarket(m);
         }
         console.log();
     }

package/dist/commands/x.d.ts

@@ -0,0 +1,28 @@
+/**
+ * sf x "query"         — Search X discussions
+ * sf x-volume "query"  — Discussion volume trend
+ * sf x-news "query"    — X news stories
+ * sf x-account @user   — Track account posts
+ *
+ * All use authenticated /api/x/* endpoints via SFClient.
+ */
+export declare function xSearchCommand(query: string, opts?: {
+    json?: boolean;
+    raw?: boolean;
+    hours?: string;
+    limit?: string;
+}): Promise<void>;
+export declare function xVolumeCommand(query: string, opts?: {
+    json?: boolean;
+    hours?: string;
+    granularity?: string;
+}): Promise<void>;
+export declare function xNewsCommand(query: string, opts?: {
+    json?: boolean;
+    limit?: string;
+}): Promise<void>;
+export declare function xAccountCommand(username: string, opts?: {
+    json?: boolean;
+    hours?: string;
+    limit?: string;
+}): Promise<void>;

package/dist/commands/x.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * sf x "query"         — Search X discussions
+ * sf x-volume "query"  — Discussion volume trend
+ * sf x-news "query"    — X news stories
+ * sf x-account @user   — Track account posts
+ *
+ * All use authenticated /api/x/* endpoints via SFClient.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xSearchCommand = xSearchCommand;
+exports.xVolumeCommand = xVolumeCommand;
+exports.xNewsCommand = xNewsCommand;
+exports.xAccountCommand = xAccountCommand;
+const BASE_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function getApiKey() {
+    const key = process.env.SF_API_KEY || '';
+    if (!key) {
+        console.error('  API key required. Run: sf setup');
+        process.exit(1);
+    }
+    return key;
+}
+async function apiFetch(path) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        headers: { 'Authorization': `Bearer ${getApiKey()}` },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`${res.status}: ${text}`);
+    }
+    return res.json();
+}
+// ── sf x "query" ─────────────────────────────────────────────────────────────
+async function xSearchCommand(query, opts) {
+    const mode = opts?.raw ? 'raw' : 'summary';
+    const hours = opts?.hours || '24';
+    const limit = opts?.limit || '20';
+    const data = await apiFetch(`/api/x/search?q=${encodeURIComponent(query)}&mode=${mode}&hours=${hours}&limit=${limit}`);
+    if (opts?.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    // Summary
+    if (data.summary) {
+        console.log(`\n  \x1b[1m\x1b[36mX: ${query}\x1b[0m\n`);
+        console.log(`  ${data.summary}\n`);
+        if (data.sentiment) {
+            const colors = { bullish: '\x1b[32m', bearish: '\x1b[31m', mixed: '\x1b[33m', neutral: '\x1b[2m' };
+            console.log(`  Sentiment: ${colors[data.sentiment] || ''}${data.sentiment}\x1b[0m`);
+        }
+        if (data.keyThemes?.length) {
+            console.log(`  Themes: ${data.keyThemes.join(', ')}`);
+        }
+        console.log();
+    }
+    // Posts
+    const posts = data.posts || [];
+    if (posts.length > 0) {
+        console.log(`  \x1b[1mTop posts\x1b[22m (${posts.length})\n`);
+        for (const p of posts.slice(0, 10)) {
+            const likes = p.metrics?.likes || 0;
+            const rt = p.metrics?.retweets || 0;
+            const followers = p.authorFollowers ? ` (${formatNum(p.authorFollowers)})` : '';
+            console.log(`  \x1b[36m@${p.authorUsername}\x1b[0m${followers}`);
+            console.log(`    ${p.text.slice(0, 140)}${p.text.length > 140 ? '...' : ''}`);
+            console.log(`    \x1b[2m♥ ${likes}  ↻ ${rt}\x1b[0m\n`);
+        }
+    }
+    // Volume
+    if (data.volume) {
+        const v = data.volume;
+        const vel = v.velocityChange > 1
+            ? `\x1b[32m+${Math.round((v.velocityChange - 1) * 100)}%\x1b[0m`
+            : `\x1b[31m${Math.round((v.velocityChange - 1) * 100)}%\x1b[0m`;
+        console.log(`  \x1b[2mVolume: ${formatNum(v.totalCount)} posts (${hours}h) | Velocity: ${vel} | Peak: ${v.peak?.count}\x1b[0m\n`);
+    }
+    // News
+    const news = data.news || [];
+    if (news.length > 0) {
+        console.log(`  \x1b[1mX News\x1b[22m (${news.length})\n`);
+        for (const n of news.slice(0, 5)) {
+            const tickers = n.tickers?.length ? ` \x1b[33m${n.tickers.join(' ')}\x1b[0m` : '';
+            console.log(`  ${n.title}${tickers}`);
+            console.log(`    \x1b[2m${n.summary.slice(0, 120)}...\x1b[0m\n`);
+        }
+    }
+}
+// ── sf x-volume "query" ──────────────────────────────────────────────────────
+async function xVolumeCommand(query, opts) {
+    const hours = opts?.hours || '72';
+    const granularity = opts?.granularity || 'hour';
+    const data = await apiFetch(`/api/x/volume?q=${encodeURIComponent(query)}&hours=${hours}&granularity=${granularity}`);
+    if (opts?.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    console.log(`\n  \x1b[1m\x1b[36mX Volume: ${query}\x1b[0m\n`);
+    console.log(`  Total: ${formatNum(data.totalCount)} posts (${hours}h)`);
+    const vel = data.velocityChange > 1
+        ? `\x1b[32m+${Math.round((data.velocityChange - 1) * 100)}%\x1b[0m`
+        : `\x1b[31m${Math.round((data.velocityChange - 1) * 100)}%\x1b[0m`;
+    console.log(`  Velocity: ${vel}`);
+    console.log(`  Peak: ${data.peak?.count} at ${data.peak?.time?.slice(11, 16) || '?'}\n`);
+    // Histogram
+    const ts = data.timeseries || [];
+    if (ts.length > 0) {
+        const maxCount = Math.max(...ts.map((b) => b.count));
+        const barWidth = 40;
+        for (const b of ts.slice(-24)) {
+            const t = (b.time || '').slice(11, 16) || '?';
+            const w = maxCount > 0 ? Math.round((b.count / maxCount) * barWidth) : 0;
+            const bar = '▓'.repeat(w);
+            const count = String(b.count).padStart(6);
+            console.log(`  ${t} ${count} ${bar}`);
+        }
+    }
+    console.log();
+}
+// ── sf x-news "query" ────────────────────────────────────────────────────────
+async function xNewsCommand(query, opts) {
+    const limit = opts?.limit || '10';
+    const data = await apiFetch(`/api/x/news?q=${encodeURIComponent(query)}&limit=${limit}`);
+    if (opts?.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const stories = data.stories || [];
+    console.log(`\n  \x1b[1m\x1b[36mX News: ${query}\x1b[0m  (${stories.length} stories)\n`);
+    for (const s of stories) {
+        const tickers = s.tickers?.length ? ` \x1b[33m${s.tickers.join(' ')}\x1b[0m` : '';
+        const cats = s.categories?.length ? `\x1b[2m[${s.categories.join(', ')}]\x1b[0m` : '';
+        console.log(`  \x1b[1m${s.title}\x1b[22m${tickers} ${cats}`);
+        console.log(`    ${s.summary.slice(0, 200)}${s.summary.length > 200 ? '...' : ''}`);
+        console.log();
+    }
+}
+// ── sf x-account @username ───────────────────────────────────────────────────
+async function xAccountCommand(username, opts) {
+    // Strip @ if present
+    const user = username.replace(/^@/, '');
+    const hours = opts?.hours || '24';
+    const limit = opts?.limit || '20';
+    const data = await apiFetch(`/api/x/account?username=${user}&hours=${hours}&limit=${limit}`);
+    if (opts?.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const posts = data.posts || [];
+    console.log(`\n  \x1b[1m\x1b[36m@${user}\x1b[0m  (${posts.length} posts, last ${hours}h)\n`);
+    for (const p of posts) {
+        const likes = p.metrics?.likes || 0;
+        const rt = p.metrics?.retweets || 0;
+        const time = p.createdAt?.slice(11, 16) || '';
+        console.log(`  \x1b[2m${time}\x1b[0m  ${p.text.slice(0, 140)}${p.text.length > 140 ? '...' : ''}`);
+        console.log(`        \x1b[2m♥ ${likes}  ↻ ${rt}\x1b[0m\n`);
+    }
+}
+// ── Util ─────────────────────────────────────────────────────────────────────
+function formatNum(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}K`;
+    return String(n);
+}

package/dist/index.js

@@ -59,6 +59,7 @@ const augment_js_1 = require("./commands/augment.js");
 const telegram_js_1 = require("./commands/telegram.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");
 const utils_js_1 = require("./utils.js");
 // ── Apply ~/.sf/config.json to process.env BEFORE any command ────────────────
 // This means client.ts, kalshi.ts, agent.ts keep reading process.env and just work.
@@ -119,6 +120,12 @@ const GROUPED_HELP = `
   \x1b[36mprompt\x1b[39m [id]                Dynamic system prompt for any agent
   \x1b[36mtelegram\x1b[39m                   Telegram bot for monitoring
 
+\x1b[1mX / Twitter\x1b[22m
+  \x1b[36mx\x1b[39m "query"                  Search X discussions (summary + raw mode)
+  \x1b[36mx-volume\x1b[39m "query"            Discussion volume and velocity trend
+  \x1b[36mx-news\x1b[39m "query"              X news stories (Grok-aggregated)
+  \x1b[36mx-account\x1b[39m @username          Recent posts from a specific account
+
 \x1b[1mInfo\x1b[22m
   \x1b[36mfeed\x1b[39m                       Evaluation history stream
   \x1b[36mmilestones\x1b[39m                 Upcoming Kalshi events
@@ -134,9 +141,13 @@ program
     .option('--api-url <url>', 'API base URL (or set SF_API_URL env var)')
     .configureHelp({
     formatHelp: (cmd, helper) => {
-        if (cmd.parent)
-            return helper.formatHelp(cmd, helper);
-        return GROUPED_HELP;
+        // Root command (sf --help) → show grouped help
+        // Subcommands (sf query --help) → default behavior
+        if (!cmd.parent)
+            return GROUPED_HELP;
+        const { Help } = require('commander');
+        const defaultHelper = new Help();
+        return defaultHelper.formatHelp(cmd, helper);
     },
 })
     .action(async () => {
@@ -656,6 +667,46 @@ program
     .action(async (opts) => {
     await run(() => (0, telegram_js_1.telegramCommand)(opts));
 });
+// ── sf x "query" ─────────────────────────────────────────────────────────────
+program
+    .command('x <query>')
+    .description('Search X/Twitter discussions about a topic')
+    .option('--json', 'JSON output')
+    .option('--raw', 'Raw mode (no LLM summary)')
+    .option('--hours <n>', 'Hours to search back (default 24)', '24')
+    .option('--limit <n>', 'Max results (default 20)', '20')
+    .action(async (query, opts) => {
+    await run(() => (0, x_js_1.xSearchCommand)(query, opts));
+});
+// ── sf x-volume "query" ──────────────────────────────────────────────────────
+program
+    .command('x-volume <query>')
+    .description('X/Twitter discussion volume and velocity trend')
+    .option('--json', 'JSON output')
+    .option('--hours <n>', 'Hours to look back (default 72)', '72')
+    .option('--granularity <g>', 'minute|hour|day (default hour)', 'hour')
+    .action(async (query, opts) => {
+    await run(() => (0, x_js_1.xVolumeCommand)(query, opts));
+});
+// ── sf x-news "query" ────────────────────────────────────────────────────────
+program
+    .command('x-news <query>')
+    .description('X/Twitter news stories (Grok-aggregated)')
+    .option('--json', 'JSON output')
+    .option('--limit <n>', 'Max stories (default 10)', '10')
+    .action(async (query, opts) => {
+    await run(() => (0, x_js_1.xNewsCommand)(query, opts));
+});
+// ── sf x-account @username ───────────────────────────────────────────────────
+program
+    .command('x-account <username>')
+    .description('Recent posts from a specific X/Twitter account')
+    .option('--json', 'JSON output')
+    .option('--hours <n>', 'Hours to look back (default 24)', '24')
+    .option('--limit <n>', 'Max posts (default 20)', '20')
+    .action(async (username, opts) => {
+    await run(() => (0, x_js_1.xAccountCommand)(username, opts));
+});
 // ── sf strategies ─────────────────────────────────────────────────────────────
 (0, strategies_js_1.registerStrategies)(program);
 // ── Error wrapper ─────────────────────────────────────────────────────────────

package/dist/telegram/agent-bridge.js

@@ -58,6 +58,16 @@ async function buildTools(sfClient, thesisId, latestContext) {
                 return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
             },
         },
+        {
+            name: 'get_markets', label: 'Markets',
+            description: 'Traditional market prices: SPY, VIX, Treasury, Gold, Oil.',
+            parameters: emptyParams,
+            execute: async () => {
+                const { fetchTraditionalMarkets } = await import('../client.js');
+                const data = await fetchTraditionalMarkets();
+                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',
@@ -294,6 +304,53 @@ async function buildTools(sfClient, thesisId, latestContext) {
             },
         },
     ];
+    // ── X (Twitter) tools ──
+    tools.push({
+        name: 'search_x', label: 'X Search',
+        description: 'Search X (Twitter) for recent discussions. Returns posts, sentiment, themes.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            mode: Type.Optional(Type.String({ description: '"summary" or "raw"' })),
+            hours: Type.Optional(Type.Number({ description: 'Hours (default 24)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.searchX(p.query, { mode: p.mode, hours: p.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_volume', label: 'X Volume',
+        description: 'X discussion volume trend — total posts, velocity, peak time.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            hours: Type.Optional(Type.Number({ description: 'Hours (default 72)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.getXVolume(p.query, { hours: p.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_news', label: 'X News',
+        description: 'News stories trending on X — titles, summaries, tickers.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'Search query' }),
+            limit: Type.Optional(Type.Number({ description: 'Max stories (default 10)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.searchXNews(p.query, { limit: p.limit });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    }, {
+        name: 'x_account', label: 'X Account',
+        description: 'Recent posts from a specific X account.',
+        parameters: Type.Object({
+            username: Type.String({ description: 'X username (with or without @)' }),
+            hours: Type.Optional(Type.Number({ description: 'Hours (default 24)' })),
+        }),
+        execute: async (_id, p) => {
+            const data = await sfClient.getXAccount(p.username, { hours: p.hours });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
+    });
     // Trading tools (only if enabled)
     if (config.tradingEnabled) {
         tools.push({
@@ -394,6 +451,7 @@ Price: depth >= 500 = consensus, < 100 = unreliable, spread > 5 = noisy.
 - Keep Telegram messages SHORT — bullet points, no walls of text.
 - Prices in cents (¢). P&L in dollars ($). Don't re-convert tool output units.
 - Call tools for fresh data. Never guess prices or P&L from this prompt.
+- Use search_x for X/Twitter sentiment. Use x_volume for discussion spikes. Use x_account to track key people.
 - You don't know user's positions. Call get_positions before discussing trades.
 - If user mentions news, inject_signal immediately. Don't ask "should I?"
 - If user says "evaluate" or "run it", trigger immediately.

package/package.json

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