@spfunctions/cli 1.1.7 → 1.1.8

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.
@@ -1328,6 +1335,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 +1878,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 +1964,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();
 }

package/package.json

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