@spfunctions/cli 1.5.0 → 1.5.2

package/README.md

@@ -2,6 +2,8 @@
 
 Prediction market intelligence CLI. Build causal thesis models, scan Kalshi/Polymarket for mispricings, detect edges, and trade — all from the terminal.
 
+![demo](https://raw.githubusercontent.com/spfunctions/simplefunctions-cli/main/demo.gif)
+
 ## Quick Start
 
 ```bash

package/dist/client.js

@@ -37,8 +37,17 @@ class SFClient {
             body: body ? JSON.stringify(body) : undefined,
         });
         if (!res.ok) {
-            const text = await res.text();
-            throw new Error(`API error ${res.status}: ${text}`);
+            let errorBody = null;
+            try {
+                const text = await res.text();
+                errorBody = text ? JSON.parse(text) : null;
+            }
+            catch { /* not JSON */ }
+            const err = new Error(errorBody?.error || errorBody?.message || `API error ${res.status}`);
+            err.status = res.status;
+            err.code = errorBody?.code || `HTTP_${res.status}`;
+            err.details = errorBody;
+            throw err;
         }
         return res.json();
     }

package/dist/client.test.js

@@ -66,7 +66,7 @@ vitest_1.vi.stubGlobal('fetch', mockFetch);
             status: 404,
             text: () => Promise.resolve('Not found'),
         });
-        await (0, vitest_1.expect)(client.getThesis('bad-id')).rejects.toThrow('API error 404: Not found');
+        await (0, vitest_1.expect)(client.getThesis('bad-id')).rejects.toThrow('API error 404');
     });
     (0, vitest_1.it)('getContext calls correct path', async () => {
         mockFetch.mockResolvedValue({

package/dist/commands/agent.js

@@ -3180,22 +3180,34 @@ async function runPlainTextAgent(params) {
         .map((n) => `  ${n.id} ${(n.label || '').slice(0, 40)} \u2014 ${Math.round(n.probability * 100)}%`)
         .join('\n') || '  (no causal tree)';
     const conf = typeof ctx.confidence === 'number' ? Math.round(ctx.confidence * 100) : 0;
-    const systemPrompt = `You are a prediction market trading assistant. Help the user make correct trading decisions.
+    const systemPrompt = `You are a prediction market trading assistant. Your job is not to please the user — it is to help them see reality clearly and make correct trading decisions.
 
-Current thesis: ${ctx.thesis || ctx.rawThesis || 'N/A'}
-ID: ${resolvedThesisId}
-Confidence: ${conf}%
-Status: ${ctx.status}
+## Framework
+Each thesis has a causal tree. Every node is a hypothesis with a probability. Edge = thesis-implied price - market price. Positive edge = market underprices. Contracts with large edge + good liquidity = most tradeable.
+executableEdge = edge after subtracting bid-ask spread. A big theoretical edge with wide spread may not be worth entering.
+
+## Rules
+- Be concise. Use tools for fresh data. Don't guess prices.
+- If user mentions news, inject_signal immediately.
+- If user says "evaluate", trigger immediately. Don't confirm.
+- Don't end with "anything else?"
+- If an edge is narrowing or disappearing, say so proactively.
+- Use Chinese if user writes Chinese, English if English.
+- Prices in cents (¢). P&L in dollars ($). Don't re-convert tool output.
+- When a trade idea emerges, create_strategy to record it.
+${config.tradingEnabled ? '- Trading ENABLED. You have place_order and cancel_order tools.' : '- Trading DISABLED. Tell user: sf setup --enable-trading'}
 
-Causal tree nodes:
+## Current State
+Thesis: ${ctx.thesis || ctx.rawThesis || 'N/A'}
+ID: ${resolvedThesisId} | Confidence: ${conf}% | Status: ${ctx.status}
+
+Causal nodes:
 ${nodesSummary}
 
 Top edges:
 ${edgesSummary}
 
-${ctx.lastEvaluation?.summary ? `Latest evaluation: ${ctx.lastEvaluation.summary.slice(0, 300)}` : ''}
-
-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.`;
+${ctx.lastEvaluation?.summary ? `Latest eval: ${ctx.lastEvaluation.summary.slice(0, 300)}` : ''}`;
     // ── Create agent ──────────────────────────────────────────────────────────
     const agent = new Agent({
         initialState: { systemPrompt, model, tools, thinkingLevel: 'off' },

package/dist/commands/create.d.ts

@@ -1,5 +1,7 @@
 export declare function createCommand(thesis: string, opts: {
     async?: boolean;
+    json?: boolean;
+    timeout?: number;
     apiKey?: string;
     apiUrl?: string;
 }): Promise<void>;

package/dist/commands/create.js

@@ -6,15 +6,27 @@ const utils_js_1 = require("../utils.js");
 async function createCommand(thesis, opts) {
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const sync = !opts.async;
-    if (sync) {
-        console.log(`${utils_js_1.c.dim}Creating thesis (sync mode — waiting for formation)...${utils_js_1.c.reset}`);
-    }
-    else {
-        console.log(`${utils_js_1.c.dim}Creating thesis (async mode)...${utils_js_1.c.reset}`);
+    if (!opts.json) {
+        if (sync) {
+            console.log(`${utils_js_1.c.dim}Creating thesis (sync mode — waiting for formation)...${utils_js_1.c.reset}`);
+        }
+        else {
+            console.log(`${utils_js_1.c.dim}Creating thesis (async mode)...${utils_js_1.c.reset}`);
+        }
     }
     const result = await client.createThesis(thesis, sync);
+    const id = result.thesis?.id || result.thesisId || result.id || null;
+    if (opts.json) {
+        console.log(JSON.stringify({ id, status: result.thesis?.status || result.status || 'forming', result }, null, 2));
+        return;
+    }
+    if (!id) {
+        console.error(`${utils_js_1.c.red}✗${utils_js_1.c.reset} Thesis creation returned no ID.`);
+        console.error(`${utils_js_1.c.dim}Response: ${JSON.stringify(result).slice(0, 200)}${utils_js_1.c.reset}`);
+        process.exit(1);
+    }
     console.log(`\n${utils_js_1.c.green}✓${utils_js_1.c.reset} Thesis created`);
-    console.log(`  ${utils_js_1.c.bold}ID:${utils_js_1.c.reset}     ${result.thesis?.id || result.id}`);
+    console.log(`  ${utils_js_1.c.bold}ID:${utils_js_1.c.reset}     ${id}`);
     console.log(`  ${utils_js_1.c.bold}Status:${utils_js_1.c.reset} ${result.thesis?.status || result.status}`);
     if (result.thesis?.confidence) {
         console.log(`  ${utils_js_1.c.bold}Confidence:${utils_js_1.c.reset} ${Math.round(parseFloat(result.thesis.confidence) * 100)}%`);
@@ -25,7 +37,6 @@ async function createCommand(thesis, opts) {
     if (result.thesis?.edgeAnalysis?.edges) {
         console.log(`  ${utils_js_1.c.bold}Edges:${utils_js_1.c.reset}  ${result.thesis.edgeAnalysis.edges.length}`);
     }
-    const id = result.thesis?.id || result.id;
     console.log(`\n${utils_js_1.c.dim}View: sf get ${(0, utils_js_1.shortId)(id)}${utils_js_1.c.reset}`);
     console.log(`${utils_js_1.c.dim}Context: sf context ${(0, utils_js_1.shortId)(id)}${utils_js_1.c.reset}`);
 }

package/dist/commands/list.d.ts

@@ -1,4 +1,5 @@
 export declare function listCommand(opts: {
+    json?: boolean;
     apiKey?: string;
     apiUrl?: string;
 }): Promise<void>;

package/dist/commands/list.js

@@ -6,6 +6,10 @@ const utils_js_1 = require("../utils.js");
 async function listCommand(opts) {
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const { theses } = await client.listTheses();
+    if (opts.json) {
+        console.log(JSON.stringify(theses, null, 2));
+        return;
+    }
     if (theses.length === 0) {
         console.log(`${utils_js_1.c.dim}No theses found.${utils_js_1.c.reset}`);
         return;

package/dist/index.js

@@ -165,9 +165,10 @@ program
 program
     .command('list')
     .description('List all theses')
-    .action(async (_opts, cmd) => {
+    .option('--json', 'JSON output')
+    .action(async (opts, cmd) => {
     const g = cmd.optsWithGlobals();
-    await run(() => (0, list_js_1.listCommand)({ apiKey: g.apiKey, apiUrl: g.apiUrl }));
+    await run(() => (0, list_js_1.listCommand)({ json: opts.json, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
 // ── sf get <id> ───────────────────────────────────────────────────────────────
 program
@@ -192,9 +193,10 @@ program
     .command('create <thesis>')
     .description('Create a new thesis (sync by default — waits for formation)')
     .option('--async', 'Async mode — return immediately without waiting')
+    .option('--json', 'JSON output')
     .action(async (thesis, opts, cmd) => {
     const g = cmd.optsWithGlobals();
-    await run(() => (0, create_js_1.createCommand)(thesis, { async: opts.async, apiKey: g.apiKey, apiUrl: g.apiUrl }));
+    await run(() => (0, create_js_1.createCommand)(thesis, { async: opts.async, json: opts.json, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
 // ── sf signal <id> <content> ──────────────────────────────────────────────────
 program
@@ -516,6 +518,15 @@ async function run(fn) {
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
+        // If --json flag is present, output structured JSON error
+        if (process.argv.includes('--json')) {
+            console.log(JSON.stringify({
+                error: msg,
+                code: err.code || 'CLI_ERROR',
+                status: err.status || 1,
+            }));
+            process.exit(1);
+        }
         (0, utils_js_1.die)(msg);
     }
 }

package/dist/telegram/agent-bridge.js

@@ -274,6 +274,53 @@ async function buildTools(sfClient, thesisId, latestContext) {
             },
         },
     ];
+    // Trading tools (only if enabled)
+    if (config.tradingEnabled) {
+        tools.push({
+            name: 'place_order',
+            label: 'Place Order',
+            description: 'Place a buy or sell order on Kalshi. Requires trading to be enabled. Always confirm with user before placing.',
+            parameters: Type.Object({
+                ticker: Type.String({ description: 'Market ticker (e.g. KXWTIMAX-26DEC31-T135)' }),
+                side: Type.String({ description: 'yes or no' }),
+                action: Type.String({ description: 'buy or sell' }),
+                count: Type.Number({ description: 'Number of contracts' }),
+                yes_price: Type.Number({ description: 'Price in cents (1-99)' }),
+            }),
+            execute: async (_id, p) => {
+                try {
+                    const result = await kalshi.createOrder({
+                        ticker: p.ticker,
+                        side: p.side,
+                        action: p.action,
+                        type: 'limit',
+                        count: p.count,
+                        yes_price: p.yes_price,
+                    });
+                    return { content: [{ type: 'text', text: `✓ Order placed: ${(result.order || result).order_id || 'OK'}\n${p.action.toUpperCase()} ${p.count}x ${p.ticker} ${p.side.toUpperCase()} @ ${p.yes_price}¢` }], details: {} };
+                }
+                catch (err) {
+                    return { content: [{ type: 'text', text: `✗ Order failed: ${err.message}` }], details: {} };
+                }
+            },
+        }, {
+            name: 'cancel_order',
+            label: 'Cancel Order',
+            description: 'Cancel a resting order on Kalshi.',
+            parameters: Type.Object({
+                orderId: Type.String({ description: 'Order ID to cancel' }),
+            }),
+            execute: async (_id, p) => {
+                try {
+                    await kalshi.cancelOrder(p.orderId);
+                    return { content: [{ type: 'text', text: `✓ Order ${p.orderId} cancelled.` }], details: {} };
+                }
+                catch (err) {
+                    return { content: [{ type: 'text', text: `✗ Cancel failed: ${err.message}` }], details: {} };
+                }
+            },
+        });
+    }
     return tools;
 }
 async function getOrCreateAgent(sfClient, session) {
@@ -303,17 +350,43 @@ async function getOrCreateAgent(sfClient, session) {
             supportsImages: true, supportsTools: true,
         };
     }
-    const systemPrompt = `You are a prediction market trading assistant on Telegram. Be concise.
+    const edgesSummary = (ctx.edges || [])
+        .sort((a, b) => Math.abs(b.edge) - Math.abs(a.edge))
+        .slice(0, 5)
+        .map((e) => `  ${(e.market || '').slice(0, 35)} | ${e.venue || 'kalshi'} | mkt ${e.marketPrice}¢ → thesis ${e.thesisPrice}¢ | edge ${e.edge > 0 ? '+' : ''}${e.edge}`)
+        .join('\n') || '  (no edges)';
+    const nodesSummary = (ctx.causalTree?.nodes || [])
+        .filter((n) => n.depth === 0 || !n.depth)
+        .slice(0, 5)
+        .map((n) => `  ${n.id} ${(n.label || '').slice(0, 35)} — ${Math.round((n.probability || 0.5) * 100)}%`)
+        .join('\n') || '  (no causal tree)';
+    const systemPrompt = `You are a prediction market trading assistant on Telegram. Your job is to help the user see reality clearly and make correct trading decisions.
 
-Thesis: ${(ctx.thesis || ctx.rawThesis || 'N/A').slice(0, 200)}
-ID: ${session.thesisId.slice(0, 8)}
-Confidence: ${conf}%
+## Framework
+Edge = thesis price - market price. Positive = market underprices. Negative = overpriced.
+Contracts with large edge + good liquidity = most tradeable.
 
-Rules:
-- Keep responses short — Telegram messages should be brief.
-- Prices are in cents (¢). P&L in dollars ($). Tool outputs are pre-formatted.
+## Rules
+- 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.
+- If user mentions news, inject_signal immediately. Don't ask "should I?"
+- If user says "evaluate" or "run it", trigger immediately.
+- Don't end with "anything else?" — user will ask.
 - Use Chinese if user writes Chinese, English if English.
-- Call tools when needed. Don't guess data.`;
+${config.tradingEnabled ? '- Trading ENABLED. You have place_order and cancel_order. ALWAYS confirm before placing.' : '- Trading DISABLED. Tell user: sf setup --enable-trading'}
+
+## Current State
+Thesis: ${(ctx.thesis || ctx.rawThesis || 'N/A').slice(0, 200)}
+ID: ${session.thesisId.slice(0, 8)} | Confidence: ${conf}%
+
+Causal nodes:
+${nodesSummary}
+
+Top edges:
+${edgesSummary}
+
+${ctx.lastEvaluation?.summary ? `Latest eval: ${ctx.lastEvaluation.summary.slice(0, 200)}` : ''}`;
     const agent = new Agent({
         initialState: {
             systemPrompt,

package/package.json

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