@spfunctions/cli 1.7.12 → 1.7.14

package/dist/client.d.ts

@@ -17,6 +17,8 @@ export declare class SFClient {
     createThesis(rawThesis: string, sync?: boolean): Promise<any>;
     injectSignal(id: string, type: string, content: string, source?: string): Promise<any>;
     evaluate(id: string): Promise<any>;
+    getHeartbeatConfig(id: string): Promise<any>;
+    updateHeartbeatConfig(id: string, config: Record<string, unknown>): Promise<any>;
     getFeed(hours?: number, limit?: number): Promise<any>;
     getChanges(id: string, since: string): Promise<any>;
     updateThesis(id: string, data: Record<string, unknown>): Promise<any>;

package/dist/client.js

@@ -74,6 +74,12 @@ class SFClient {
     async evaluate(id) {
         return this.request('POST', `/api/thesis/${id}/evaluate`);
     }
+    async getHeartbeatConfig(id) {
+        return this.request('GET', `/api/thesis/${id}/heartbeat`);
+    }
+    async updateHeartbeatConfig(id, config) {
+        return this.request('PATCH', `/api/thesis/${id}/heartbeat`, config);
+    }
     async getFeed(hours = 24, limit = 200) {
         return this.request('GET', `/api/feed?hours=${hours}&limit=${limit}`);
     }

package/dist/commands/agent.js

@@ -1588,6 +1588,37 @@ async function agentCommand(thesisId, opts) {
             const data = await sfClient.getXAccount(params.username, { hours: params.hours });
             return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
         },
+    }, {
+        name: 'heartbeat_config',
+        label: 'Heartbeat Config',
+        description: 'View or update heartbeat settings for a thesis: scan intervals, model tier, budget cap, pause/resume. Also shows this month\'s cost breakdown.',
+        parameters: Type.Object({
+            thesisId: Type.String({ description: 'Thesis ID' }),
+            newsIntervalMin: Type.Optional(Type.Number({ description: 'News scan interval in minutes (15-1440)' })),
+            xIntervalMin: Type.Optional(Type.Number({ description: 'X scan interval in minutes (60-1440)' })),
+            evalModelTier: Type.Optional(Type.String({ description: 'Eval model: cheap, medium, or heavy' })),
+            monthlyBudgetUsd: Type.Optional(Type.Number({ description: 'Monthly budget cap in USD (0 = unlimited)' })),
+            paused: Type.Optional(Type.Boolean({ description: 'Pause (true) or resume (false) heartbeat' })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const hasUpdates = params.newsIntervalMin || params.xIntervalMin || params.evalModelTier || params.monthlyBudgetUsd !== undefined || params.paused !== undefined;
+            if (hasUpdates) {
+                const updates = {};
+                if (params.newsIntervalMin)
+                    updates.newsIntervalMin = params.newsIntervalMin;
+                if (params.xIntervalMin)
+                    updates.xIntervalMin = params.xIntervalMin;
+                if (params.evalModelTier)
+                    updates.evalModelTier = params.evalModelTier;
+                if (params.monthlyBudgetUsd !== undefined)
+                    updates.monthlyBudgetUsd = params.monthlyBudgetUsd;
+                if (params.paused !== undefined)
+                    updates.paused = params.paused;
+                await sfClient.updateHeartbeatConfig(params.thesisId, updates);
+            }
+            const data = await sfClient.getHeartbeatConfig(params.thesisId);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
     });
     // ── Trading tools (conditional on tradingEnabled) ──────────────────────────
     const config = (0, config_js_1.loadConfig)();
@@ -1727,6 +1758,9 @@ 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.
 
+### Heartbeat config
+Use heartbeat_config to view or adjust per-thesis heartbeat settings: news/X scan intervals, evaluation model tier (cheap/medium/heavy), monthly budget cap, pause/resume. Also shows this month's cost breakdown (LLM calls, search calls, tokens, spend). Useful when the user asks about costs, wants to slow down/speed up monitoring, or if you detect budget overrun.
+
 ### 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."
@@ -3345,6 +3379,36 @@ async function runPlainTextAgent(params) {
             const data = await sfClient.getXAccount(p.username, { hours: p.hours });
             return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
         },
+    }, {
+        name: 'heartbeat_config', label: 'Heartbeat Config',
+        description: 'View or update heartbeat settings: scan intervals, model tier, budget cap, pause/resume. Shows cost breakdown.',
+        parameters: Type.Object({
+            thesisId: Type.String({ description: 'Thesis ID' }),
+            newsIntervalMin: Type.Optional(Type.Number({ description: 'News scan interval (15-1440 min)' })),
+            xIntervalMin: Type.Optional(Type.Number({ description: 'X scan interval (60-1440 min)' })),
+            evalModelTier: Type.Optional(Type.String({ description: 'cheap, medium, or heavy' })),
+            monthlyBudgetUsd: Type.Optional(Type.Number({ description: 'Monthly budget (0 = unlimited)' })),
+            paused: Type.Optional(Type.Boolean({ description: 'Pause or resume heartbeat' })),
+        }),
+        execute: async (_id, p) => {
+            const hasUp = p.newsIntervalMin || p.xIntervalMin || p.evalModelTier || p.monthlyBudgetUsd !== undefined || p.paused !== undefined;
+            if (hasUp) {
+                const u = {};
+                if (p.newsIntervalMin)
+                    u.newsIntervalMin = p.newsIntervalMin;
+                if (p.xIntervalMin)
+                    u.xIntervalMin = p.xIntervalMin;
+                if (p.evalModelTier)
+                    u.evalModelTier = p.evalModelTier;
+                if (p.monthlyBudgetUsd !== undefined)
+                    u.monthlyBudgetUsd = p.monthlyBudgetUsd;
+                if (p.paused !== undefined)
+                    u.paused = p.paused;
+                await sfClient.updateHeartbeatConfig(p.thesisId, u);
+            }
+            const data = await sfClient.getHeartbeatConfig(p.thesisId);
+            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)();
@@ -3449,6 +3513,7 @@ Always state contract expiry and next catalyst. No catalyst = flag capital lock
 
 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.
+Use heartbeat_config to view/adjust scan intervals, model tier, budget cap, or check cost breakdown.
 
 Flag correlated exposure across positions sharing upstream nodes. If nothing to do, say so.
 

package/dist/commands/heartbeat.d.ts

@@ -0,0 +1,20 @@
+/**
+ * sf heartbeat <thesisId> — View/update per-thesis heartbeat config & costs.
+ *
+ * Examples:
+ *   sf heartbeat abc123                     — show config + costs
+ *   sf heartbeat abc123 --news-interval 30  — set news scan to 30 min
+ *   sf heartbeat abc123 --model heavy       — use heavy model for eval
+ *   sf heartbeat abc123 --budget 5          — $5/month cap
+ *   sf heartbeat abc123 --pause             — pause heartbeat
+ *   sf heartbeat abc123 --resume            — resume heartbeat
+ */
+import type { SFClient } from '../client.js';
+export declare function heartbeatCommand(sfClient: SFClient, thesisId: string, opts: {
+    newsInterval?: string;
+    xInterval?: string;
+    model?: string;
+    budget?: string;
+    pause?: boolean;
+    resume?: boolean;
+}): Promise<void>;

package/dist/commands/heartbeat.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * sf heartbeat <thesisId> — View/update per-thesis heartbeat config & costs.
+ *
+ * Examples:
+ *   sf heartbeat abc123                     — show config + costs
+ *   sf heartbeat abc123 --news-interval 30  — set news scan to 30 min
+ *   sf heartbeat abc123 --model heavy       — use heavy model for eval
+ *   sf heartbeat abc123 --budget 5          — $5/month cap
+ *   sf heartbeat abc123 --pause             — pause heartbeat
+ *   sf heartbeat abc123 --resume            — resume heartbeat
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.heartbeatCommand = heartbeatCommand;
+const utils_js_1 = require("../utils.js");
+async function heartbeatCommand(sfClient, thesisId, opts) {
+    // Check if any update flags were passed
+    const hasUpdates = opts.newsInterval || opts.xInterval || opts.model || opts.budget !== undefined || opts.pause || opts.resume;
+    if (hasUpdates) {
+        const updates = {};
+        if (opts.newsInterval)
+            updates.newsIntervalMin = parseInt(opts.newsInterval, 10);
+        if (opts.xInterval)
+            updates.xIntervalMin = parseInt(opts.xInterval, 10);
+        if (opts.model)
+            updates.evalModelTier = opts.model;
+        if (opts.budget !== undefined)
+            updates.monthlyBudgetUsd = parseFloat(opts.budget);
+        if (opts.pause)
+            updates.paused = true;
+        if (opts.resume)
+            updates.paused = false;
+        try {
+            const result = await sfClient.updateHeartbeatConfig(thesisId, updates);
+            console.log(`\n  ${utils_js_1.c.green}✓${utils_js_1.c.reset} Updated heartbeat config`);
+            console.log(`  ${utils_js_1.c.dim}Updated fields: ${result.updated.join(', ')}${utils_js_1.c.reset}\n`);
+        }
+        catch (err) {
+            console.error(`  ${utils_js_1.c.red}✗ ${err.message}${utils_js_1.c.reset}`);
+            return;
+        }
+    }
+    // Always show current config
+    try {
+        const data = await sfClient.getHeartbeatConfig(thesisId);
+        const cfg = data.config;
+        const costs = data.costs;
+        console.log(`\n  ${utils_js_1.c.bold}Heartbeat Config${utils_js_1.c.reset} ${utils_js_1.c.dim}(${thesisId.slice(0, 8)})${utils_js_1.c.reset}`);
+        console.log();
+        // Config
+        const statusIcon = cfg.paused ? `${utils_js_1.c.red}⏸ paused${utils_js_1.c.reset}` : `${utils_js_1.c.green}▶ active${utils_js_1.c.reset}`;
+        console.log(`  Status         ${statusIcon}`);
+        console.log(`  News interval  ${utils_js_1.c.cyan}${cfg.newsIntervalMin}${utils_js_1.c.reset} min ${utils_js_1.c.dim}(${cfg.newsIntervalMin === data.defaults.newsIntervalMin ? 'default' : 'custom'})${utils_js_1.c.reset}`);
+        console.log(`  X interval     ${utils_js_1.c.cyan}${cfg.xIntervalMin}${utils_js_1.c.reset} min ${utils_js_1.c.dim}(${cfg.xIntervalMin === data.defaults.xIntervalMin ? 'default' : 'custom'})${utils_js_1.c.reset}`);
+        console.log(`  Eval model     ${utils_js_1.c.cyan}${cfg.evalModelTier}${utils_js_1.c.reset} ${utils_js_1.c.dim}(${cfg.evalModelTier === data.defaults.evalModelTier ? 'default' : 'custom'})${utils_js_1.c.reset}`);
+        console.log(`  Monthly budget ${cfg.monthlyBudgetUsd > 0 ? `${utils_js_1.c.cyan}$${cfg.monthlyBudgetUsd}${utils_js_1.c.reset}` : `${utils_js_1.c.dim}unlimited${utils_js_1.c.reset}`}`);
+        console.log();
+        // Costs
+        console.log(`  ${utils_js_1.c.bold}This Month${utils_js_1.c.reset}`);
+        console.log(`  Total cost     ${utils_js_1.c.cyan}$${costs.monthlyTotal.toFixed(4)}${utils_js_1.c.reset}`);
+        console.log(`  LLM calls      ${costs.llmCalls}`);
+        console.log(`  Search calls   ${costs.searchCalls}`);
+        console.log(`  Tokens         ${utils_js_1.c.dim}${costs.inputTokens.toLocaleString()} in / ${costs.outputTokens.toLocaleString()} out${utils_js_1.c.reset}`);
+        if (costs.budgetRemaining !== null) {
+            const pct = cfg.monthlyBudgetUsd > 0 ? Math.round((costs.monthlyTotal / cfg.monthlyBudgetUsd) * 100) : 0;
+            console.log(`  Budget used    ${pct}% ${utils_js_1.c.dim}($${costs.budgetRemaining.toFixed(2)} remaining)${utils_js_1.c.reset}`);
+        }
+        console.log();
+    }
+    catch (err) {
+        console.error(`  ${utils_js_1.c.red}✗ ${err.message}${utils_js_1.c.reset}`);
+    }
+}

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 delta_js_1 = require("./commands/delta.js");
 const login_js_1 = require("./commands/login.js");
+const heartbeat_js_1 = require("./commands/heartbeat.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");
@@ -88,6 +89,7 @@ const GROUPED_HELP = `
   \x1b[36mevaluate\x1b[39m <id>              Trigger deep evaluation
   \x1b[36maugment\x1b[39m <id>               Evolve causal tree with new nodes
   \x1b[36mpublish\x1b[39m / \x1b[36munpublish\x1b[39m <id>  Manage public visibility
+  \x1b[36mheartbeat\x1b[39m <id>             View/configure heartbeat settings & costs
 
 \x1b[1mSearch\x1b[22m
   \x1b[36mquery\x1b[39m "question"            LLM-enhanced market knowledge search \x1b[2m(no auth)\x1b[22m
@@ -342,6 +344,30 @@ program
     const g = cmd.optsWithGlobals();
     await run(() => (0, evaluate_js_1.evaluateCommand)(id, { apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
+// ── sf heartbeat <id> ─────────────────────────────────────────────────────────
+program
+    .command('heartbeat <id>')
+    .description('View/configure per-thesis heartbeat settings and costs')
+    .option('--news-interval <min>', 'News scan interval in minutes (15-1440)')
+    .option('--x-interval <min>', 'X/social scan interval in minutes (60-1440)')
+    .option('--model <tier>', 'Eval model tier: cheap, medium, heavy')
+    .option('--budget <usd>', 'Monthly budget cap in USD (0 = unlimited)')
+    .option('--pause', 'Pause heartbeat')
+    .option('--resume', 'Resume heartbeat')
+    .action(async (id, opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => {
+        const client = new client_js_1.SFClient(g.apiKey, g.apiUrl);
+        return (0, heartbeat_js_1.heartbeatCommand)(client, id, {
+            newsInterval: opts.newsInterval,
+            xInterval: opts.xInterval,
+            model: opts.model,
+            budget: opts.budget,
+            pause: opts.pause,
+            resume: opts.resume,
+        });
+    });
+});
 // ── sf scan [query] ───────────────────────────────────────────────────────────
 program
     .command('scan [query]')

package/dist/telegram/agent-bridge.js

@@ -362,6 +362,36 @@ async function buildTools(sfClient, thesisId, latestContext) {
             const data = await sfClient.getXAccount(p.username, { hours: p.hours });
             return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
         },
+    }, {
+        name: 'heartbeat_config', label: 'Heartbeat Config',
+        description: 'View or update heartbeat settings: scan intervals, model tier, budget cap, pause/resume. Shows cost breakdown.',
+        parameters: Type.Object({
+            thesisId: Type.String({ description: 'Thesis ID' }),
+            newsIntervalMin: Type.Optional(Type.Number({ description: 'News scan interval (15-1440 min)' })),
+            xIntervalMin: Type.Optional(Type.Number({ description: 'X scan interval (60-1440 min)' })),
+            evalModelTier: Type.Optional(Type.String({ description: 'cheap, medium, or heavy' })),
+            monthlyBudgetUsd: Type.Optional(Type.Number({ description: 'Monthly budget (0 = unlimited)' })),
+            paused: Type.Optional(Type.Boolean({ description: 'Pause or resume heartbeat' })),
+        }),
+        execute: async (_id, p) => {
+            const hasUp = p.newsIntervalMin || p.xIntervalMin || p.evalModelTier || p.monthlyBudgetUsd !== undefined || p.paused !== undefined;
+            if (hasUp) {
+                const u = {};
+                if (p.newsIntervalMin)
+                    u.newsIntervalMin = p.newsIntervalMin;
+                if (p.xIntervalMin)
+                    u.xIntervalMin = p.xIntervalMin;
+                if (p.evalModelTier)
+                    u.evalModelTier = p.evalModelTier;
+                if (p.monthlyBudgetUsd !== undefined)
+                    u.monthlyBudgetUsd = p.monthlyBudgetUsd;
+                if (p.paused !== undefined)
+                    u.paused = p.paused;
+                await sfClient.updateHeartbeatConfig(p.thesisId, u);
+            }
+            const data = await sfClient.getHeartbeatConfig(p.thesisId);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+        },
     });
     // Trading tools (only if enabled)
     if (config.tradingEnabled) {
@@ -470,6 +500,7 @@ Price: depth >= 500 = consensus, < 100 = unreliable, spread > 5 = noisy.
 - 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.
+- Use heartbeat_config to view/adjust scan intervals, model tier, budget cap, or check cost breakdown.
 - 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.12",
+  "version": "1.7.14",
   "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"