@spfunctions/cli 1.1.7 → 1.1.9

package/dist/client.d.ts

@@ -18,6 +18,7 @@ export declare class SFClient {
     injectSignal(id: string, type: string, content: string, source?: string): Promise<any>;
     evaluate(id: string): 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>;
     publish(id: string, slug: string, description?: string): Promise<any>;
     unpublish(id: string): Promise<any>;

package/dist/client.js

@@ -65,6 +65,9 @@ class SFClient {
     async getFeed(hours = 24, limit = 200) {
         return this.request('GET', `/api/feed?hours=${hours}&limit=${limit}`);
     }
+    async getChanges(id, since) {
+        return this.request('GET', `/api/thesis/${id}/changes?since=${encodeURIComponent(since)}`);
+    }
     async updateThesis(id, data) {
         return this.request('PATCH', `/api/thesis/${id}`, data);
     }

package/dist/commands/agent.js

@@ -433,6 +433,13 @@ async function agentCommand(thesisId, opts) {
     let isProcessing = false;
     // Cache for positions (fetched by /pos or get_positions tool)
     let cachedPositions = null;
+    // ── Heartbeat polling state ───────────────────────────────────────────────
+    // Background poll delta endpoint every 60s.
+    // If confidence changed ≥ 3%, auto-trigger agent analysis.
+    // If agent is busy (isProcessing), queue and deliver after agent finishes.
+    let lastPollTimestamp = new Date().toISOString();
+    let pendingHeartbeatDelta = null; // queued delta when agent is busy
+    let heartbeatPollTimer = null;
     // ── Inline confirmation mechanism ─────────────────────────────────────────
     // Tools can call promptUser() during execution to ask the user a question.
     // This temporarily unlocks the editor, waits for input, then resumes.
@@ -710,8 +717,18 @@ async function agentCommand(thesisId, opts) {
                     }
                 }
                 cachedPositions = positions;
+                const formatted = positions.map((p) => ({
+                    ticker: p.ticker,
+                    side: p.side,
+                    quantity: p.quantity,
+                    avg_price: `${p.average_price_paid}¢`,
+                    current_price: `${p.current_value}¢`,
+                    unrealized_pnl: `$${(p.unrealized_pnl / 100).toFixed(2)}`,
+                    total_cost: `$${(p.total_cost / 100).toFixed(2)}`,
+                    realized_pnl: `$${(p.realized_pnl / 100).toFixed(2)}`,
+                }));
                 return {
-                    content: [{ type: 'text', text: JSON.stringify(positions, null, 2) }],
+                    content: [{ type: 'text', text: JSON.stringify(formatted, null, 2) }],
                     details: {},
                 };
             },
@@ -1188,6 +1205,7 @@ Short-term markets (weekly/monthly contracts) settle into hard data that calibra
 - If a causal tree node probability seriously contradicts the market price, point it out.
 - Use Chinese if the user writes in Chinese, English if they write in English.
 - For any question about prices, positions, or P&L, ALWAYS call a tool to get fresh data first. Never answer price-related questions using the cached data in this system prompt.
+- Prices are in cents (e.g. 35¢). P&L, cost, and balance are in dollars (e.g. $90.66). Tool outputs are pre-formatted with units — do not re-convert.
 - Align tables. Be precise with numbers to the cent.
 
 ## Strategy rules
@@ -1328,6 +1346,12 @@ ${ctx.lastEvaluation?.summary ? `Latest evaluation summary: ${ctx.lastEvaluation
             isProcessing = false;
             persistSession();
             flushRender();
+            // Deliver queued heartbeat notification if any
+            if (pendingHeartbeatDelta) {
+                const delta = pendingHeartbeatDelta;
+                pendingHeartbeatDelta = null;
+                handleHeartbeatDelta(delta);
+            }
         }
         if (event.type === 'tool_execution_start') {
             const toolLine = new MutableLine(C.zinc600(`  \u26A1 ${event.toolName}...`));
@@ -1865,6 +1889,8 @@ Output a structured summary. Be concise but preserve every important detail —
     };
     // ── Ctrl+C handler ─────────────────────────────────────────────────────────
     function cleanup() {
+        if (heartbeatPollTimer)
+            clearInterval(heartbeatPollTimer);
         if (currentLoader)
             currentLoader.stop();
         persistSession();
@@ -1949,6 +1975,59 @@ Output a structured summary. Be concise but preserve every important detail —
     addSystemText(buildWelcomeDashboard(latestContext, initialPositions));
     addSystemText(' ' + sessionStatus);
     addSpacer();
+    // ── Heartbeat delta handler ───────────────────────────────────────────────
+    const HEARTBEAT_CONFIDENCE_THRESHOLD = 0.03; // 3%
+    function handleHeartbeatDelta(delta) {
+        const absDelta = Math.abs(delta.confidenceDelta || 0);
+        const confPct = Math.round((delta.confidence || 0) * 100);
+        const deltaPct = Math.round((delta.confidenceDelta || 0) * 100);
+        const sign = deltaPct > 0 ? '+' : '';
+        if (absDelta >= HEARTBEAT_CONFIDENCE_THRESHOLD) {
+            // Big change → auto-trigger agent analysis
+            const arrow = deltaPct > 0 ? '\u25B2' : '\u25BC';
+            const color = deltaPct > 0 ? C.emerald : C.red;
+            addSystemText(color(`  ${arrow} Heartbeat: confidence ${sign}${deltaPct}% → ${confPct}%`));
+            if (delta.latestSummary) {
+                addSystemText(C.zinc400(`  ${delta.latestSummary.slice(0, 100)}`));
+            }
+            addSpacer();
+            // Update header
+            headerBar.setFromContext({ ...latestContext, confidence: delta.confidence, lastEvaluation: { confidenceDelta: delta.confidenceDelta } }, initialPositions || undefined);
+            tui.requestRender();
+            // Auto-trigger agent
+            isProcessing = true;
+            const prompt = `[HEARTBEAT ALERT] Confidence just changed ${sign}${deltaPct}% to ${confPct}%. ${delta.evaluationCount} evaluation(s) since last check. Latest: "${(delta.latestSummary || '').slice(0, 150)}". Briefly analyze what happened and whether any action is needed. Be concise.`;
+            agent.prompt(prompt).catch((err) => {
+                addSystemText(C.red(`Error: ${err.message}`));
+                isProcessing = false;
+            });
+        }
+        else if (absDelta > 0) {
+            // Small change → silent notification line only
+            addSystemText(C.zinc600(`  \u2500 heartbeat: ${confPct}% (${sign}${deltaPct}%) \u2014 ${delta.evaluationCount || 0} eval(s)`));
+            tui.requestRender();
+        }
+        // absDelta === 0: truly nothing changed, stay silent
+    }
+    // ── Start heartbeat polling ───────────────────────────────────────────────
+    heartbeatPollTimer = setInterval(async () => {
+        try {
+            const delta = await sfClient.getChanges(resolvedThesisId, lastPollTimestamp);
+            lastPollTimestamp = new Date().toISOString();
+            if (!delta.changed)
+                return;
+            if (isProcessing || pendingPrompt) {
+                // Agent is busy — queue for delivery after agent_end
+                pendingHeartbeatDelta = delta;
+            }
+            else {
+                handleHeartbeatDelta(delta);
+            }
+        }
+        catch {
+            // Silent — don't spam errors from background polling
+        }
+    }, 60_000); // every 60 seconds
     // ── Start TUI ──────────────────────────────────────────────────────────────
     tui.start();
 }
@@ -2069,7 +2148,14 @@ async function runPlainTextAgent(params) {
                         pos.unrealized_pnl = Math.round((livePrice - pos.average_price_paid) * pos.quantity);
                     }
                 }
-                return { content: [{ type: 'text', text: JSON.stringify(positions, null, 2) }], details: {} };
+                const formatted = positions.map((p) => ({
+                    ticker: p.ticker, side: p.side, quantity: p.quantity,
+                    avg_price: `${p.average_price_paid}¢`, current_price: `${p.current_value}¢`,
+                    unrealized_pnl: `$${(p.unrealized_pnl / 100).toFixed(2)}`,
+                    total_cost: `$${(p.total_cost / 100).toFixed(2)}`,
+                    realized_pnl: `$${(p.realized_pnl / 100).toFixed(2)}`,
+                }));
+                return { content: [{ type: 'text', text: JSON.stringify(formatted, null, 2) }], details: {} };
             },
         },
         {
@@ -2241,7 +2327,7 @@ ${edgesSummary}
 
 ${ctx.lastEvaluation?.summary ? `Latest evaluation: ${ctx.lastEvaluation.summary.slice(0, 300)}` : ''}
 
-Rules: Be concise. Use tools when needed. Don't ask "anything else?".`;
+Rules: Be concise. Use tools when needed. Don't ask "anything else?". Prices are in cents (e.g. 35¢). P&L, cost, and balance are in dollars (e.g. $90.66). Tool outputs are pre-formatted with units — do not re-convert.`;
     // ── Create agent ──────────────────────────────────────────────────────────
     const agent = new Agent({
         initialState: { systemPrompt, model, tools, thinkingLevel: 'off' },

package/package.json

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