@spfunctions/cli 1.7.17 → 1.7.19

package/dist/commands/agent.js

@@ -319,7 +319,7 @@ function createFooterBar(piTui) {
             const tokStr = this.tokens >= 1000 ? `${(this.tokens / 1000).toFixed(1)}k` : `${this.tokens}`;
             const tokens = C.zinc600(`${tokStr} tok`);
             const exchange = this.exchangeOpen === true ? C.emerald('OPEN') : this.exchangeOpen === false ? C.red('CLOSED') : C.zinc600('...');
-            const trading = this.tradingEnabled ? C.amber('\u26A1 trading') : C.zinc600('\u26A1 read-only');
+            const trading = this.tradingEnabled ? C.amber('trading') : C.zinc600('read-only');
             const help = C.zinc600('/help');
             const leftText = [model, tokens, exchange, trading].join(sep);
             const lw = visibleWidth(leftText);
@@ -2207,7 +2207,7 @@ ${topEdges}
             }
         }
         if (event.type === 'tool_execution_start') {
-            const toolLine = new MutableLine(C.zinc600(`  \u26A1 ${event.toolName}...`));
+            const toolLine = new MutableLine(C.zinc600(`  \u25B8 ${event.toolName}...`));
             toolStartTimes.set(event.toolCallId || event.toolName, Date.now());
             toolLines.set(event.toolCallId || event.toolName, toolLine);
             chatContainer.addChild(toolLine);
@@ -2226,7 +2226,7 @@ ${topEdges}
                     line.setText(C.red(`  \u2717 ${event.toolName} (${elapsed}s) error`));
                 }
                 else {
-                    line.setText(C.zinc600(`  \u26A1 ${event.toolName}`) + C.emerald(` \u2713`) + C.zinc600(` (${elapsed}s)`));
+                    line.setText(C.zinc600(`  \u25B8 ${event.toolName} `) + C.emerald(`\u2713`) + C.zinc600(` ${elapsed}s`));
                 }
             }
             toolStartTimes.delete(key);
@@ -4016,7 +4016,7 @@ ${ctx.lastEvaluation?.summary ? `Latest eval: ${ctx.lastEvaluation.summary.slice
             }
         }
         if (event.type === 'tool_execution_start') {
-            process.stderr.write(`  \u26A1 ${event.toolName}...\n`);
+            process.stderr.write(`  \u25B8 ${event.toolName}...\n`);
         }
         if (event.type === 'tool_execution_end') {
             const status = event.isError ? '\u2717' : '\u2713';

package/dist/commands/balance.js

@@ -6,7 +6,7 @@ const utils_js_1 = require("../utils.js");
 async function balanceCommand(opts) {
     const result = await (0, kalshi_js_1.getBalance)();
     if (!result)
-        throw new Error('Kalshi not configured. Set KALSHI_API_KEY_ID + KALSHI_PRIVATE_KEY_PATH.');
+        throw new Error('Kalshi not configured. Run: sf setup --kalshi');
     if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
         return;

package/dist/commands/book.js

@@ -152,7 +152,7 @@ async function bookCommand(tickers, opts) {
         }
     }
     if (results.length === 0) {
-        console.log(`${utils_js_1.c.dim}No markets found.${utils_js_1.c.reset}`);
+        console.log(`\n  ${utils_js_1.c.dim}No markets found. Check the ticker and try again.${utils_js_1.c.reset}\n`);
         return;
     }
     // ── JSON output ──

package/dist/commands/edges.js

@@ -28,23 +28,28 @@ async function edgesCommand(opts) {
     const liqRank = { a: 4, high: 4, b: 3, medium: 3, c: 2, low: 2, d: 1 };
     // ── Step 1: Fetch theses (or single thesis) ────────────────────────────────
     let theses;
+    const log = opts.json ? (() => { }) : (msg) => console.log(msg);
     if (opts.thesis) {
         // Single thesis mode — skip listing, fetch context directly
-        console.log(`${utils_js_1.c.dim}Fetching edges for thesis ${opts.thesis}...${utils_js_1.c.reset}`);
+        log(`${utils_js_1.c.dim}Fetching edges for thesis ${opts.thesis}...${utils_js_1.c.reset}`);
         theses = [{ id: opts.thesis }];
     }
     else {
-        console.log(`${utils_js_1.c.dim}Fetching theses...${utils_js_1.c.reset}`);
+        log(`${utils_js_1.c.dim}Fetching theses...${utils_js_1.c.reset}`);
         const data = await client.listTheses();
         const rawTheses = data.theses || data;
         theses = (Array.isArray(rawTheses) ? rawTheses : []).filter((t) => t.status === 'active');
     }
     if (theses.length === 0) {
-        console.log(`${utils_js_1.c.yellow}No active theses found.${utils_js_1.c.reset} Create one: sf create "your thesis"`);
+        if (opts.json) {
+            console.log(JSON.stringify({ edges: [], totalEdges: 0 }));
+            return;
+        }
+        (0, utils_js_1.emptyState)('active theses', 'Create one: sf create "your market thesis"');
         return;
     }
     // ── Step 2: Fetch context for each thesis (parallel) ───────────────────────
-    console.log(`${utils_js_1.c.dim}Fetching edges from ${theses.length} ${theses.length === 1 ? 'thesis' : 'theses'}...${utils_js_1.c.reset}`);
+    log(`${utils_js_1.c.dim}Fetching edges from ${theses.length} ${theses.length === 1 ? 'thesis' : 'theses'}...${utils_js_1.c.reset}`);
     const allEdges = [];
     const contextPromises = theses.map(async (t) => {
         try {
@@ -75,7 +80,11 @@ async function edgesCommand(opts) {
         }
     }
     if (allEdges.length === 0) {
-        console.log(`${utils_js_1.c.yellow}No edges found across ${theses.length} theses.${utils_js_1.c.reset}`);
+        if (opts.json) {
+            console.log(JSON.stringify({ edges: [], totalEdges: 0, thesesScanned: theses.length }));
+            return;
+        }
+        (0, utils_js_1.emptyState)('edges', `Scanned ${theses.length} theses. Edges appear when thesis price diverges from market price.`);
         return;
     }
     // ── Step 3: Dedupe by marketId — keep highest absolute edge ────────────────
@@ -100,7 +109,7 @@ async function edgesCommand(opts) {
     // ── Step 4: Fetch positions (optional) ─────────────────────────────────────
     let positions = null;
     if ((0, kalshi_js_1.isKalshiConfigured)()) {
-        console.log(`${utils_js_1.c.dim}Fetching Kalshi positions...${utils_js_1.c.reset}`);
+        log(`${utils_js_1.c.dim}Fetching Kalshi positions...${utils_js_1.c.reset}`);
         positions = await (0, kalshi_js_1.getPositions)();
         if (positions) {
             // Enrich with live prices

package/dist/commands/explore.js

@@ -12,6 +12,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exploreCommand = exploreCommand;
 const share_js_1 = require("../share.js");
+const utils_js_1 = require("../utils.js");
 const BASE_URL = 'https://simplefunctions.dev';
 async function exploreCommand(slug, opts) {
     if (!slug) {
@@ -32,7 +33,7 @@ async function exploreCommand(slug, opts) {
         }
         console.log('\n  Public Theses\n');
         if (theses.length === 0) {
-            console.log('  No public theses yet.\n');
+            console.log(`  ${utils_js_1.c.dim}No public theses yet. Publish yours: sf publish <id>${utils_js_1.c.reset}\n`);
             return;
         }
         for (const t of theses) {

package/dist/commands/fills.js

@@ -6,7 +6,7 @@ const utils_js_1 = require("../utils.js");
 async function fillsCommand(opts) {
     const result = await (0, kalshi_js_1.getFills)({ ticker: opts.ticker, limit: 50 });
     if (!result)
-        throw new Error('Kalshi not configured. Set KALSHI_API_KEY_ID + KALSHI_PRIVATE_KEY_PATH.');
+        throw new Error('Kalshi not configured. Run: sf setup --kalshi');
     if (opts.json) {
         console.log(JSON.stringify(result.fills, null, 2));
         return;

package/dist/commands/list.js

@@ -11,7 +11,7 @@ async function listCommand(opts) {
         return;
     }
     if (theses.length === 0) {
-        console.log(`${utils_js_1.c.dim}No theses found.${utils_js_1.c.reset}`);
+        (0, utils_js_1.emptyState)('theses', 'Create one: sf create "your market thesis"');
         return;
     }
     console.log(`\n${utils_js_1.c.bold}` +

package/dist/commands/login.d.ts

@@ -6,4 +6,5 @@
  */
 export declare function loginCommand(opts: {
     apiUrl?: string;
+    force?: boolean;
 }): Promise<void>;

package/dist/commands/login.js

@@ -13,11 +13,11 @@ const utils_js_1 = require("../utils.js");
 const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function loginCommand(opts) {
     const apiUrl = opts.apiUrl || (0, config_js_1.loadConfig)().apiUrl || SF_API_URL;
-    // Only block if the CONFIG FILE has an API key (not env vars)
+    // If already configured, re-login replaces the existing key
     const fileConfig = (0, config_js_1.loadFileConfig)();
-    if (fileConfig.apiKey) {
-        console.log(`\n  ${utils_js_1.c.dim}Already configured with API key ${fileConfig.apiKey.slice(0, 12)}...${utils_js_1.c.reset}`);
-        console.log(`  ${utils_js_1.c.dim}Run ${utils_js_1.c.cyan}sf setup --reset${utils_js_1.c.dim} first to reconfigure.${utils_js_1.c.reset}\n`);
+    if (fileConfig.apiKey && !opts.force) {
+        console.log(`\n  ${utils_js_1.c.dim}Already logged in (${fileConfig.apiKey.slice(0, 12)}...).${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.dim}Run ${utils_js_1.c.cyan}sf login --force${utils_js_1.c.dim} to re-authenticate, or ${utils_js_1.c.cyan}sf logout${utils_js_1.c.dim} to clear.${utils_js_1.c.reset}\n`);
         return;
     }
     // Generate session token

package/dist/commands/positions.js

@@ -180,10 +180,10 @@ async function positionsCommand(opts) {
         console.log('');
     }
     else if ((0, kalshi_js_1.isKalshiConfigured)()) {
-        console.log(`\n${utils_js_1.c.dim}No open positions on Kalshi.${utils_js_1.c.reset}\n`);
+        console.log(`\n  ${utils_js_1.c.dim}No open Kalshi positions.${utils_js_1.c.reset}\n`);
     }
     else {
-        console.log(`\n${utils_js_1.c.yellow}Kalshi not configured.${utils_js_1.c.reset} Set KALSHI_API_KEY_ID and KALSHI_PRIVATE_KEY_PATH to see positions.\n`);
+        console.log(`\n  ${utils_js_1.c.dim}Kalshi not configured. Run: ${utils_js_1.c.cyan}sf setup --kalshi${utils_js_1.c.reset}\n`);
     }
     // C) Polymarket positions
     if (polyPositions.length > 0) {

package/dist/commands/scan.js

@@ -194,7 +194,7 @@ async function keywordScan(query, json, venue = 'all', share) {
     console.log('');
     // Conversion hook
     if (!json) {
-        console.log(`${utils_js_1.c.dim}Want 24/7 monitoring + edge detection? ${utils_js_1.c.reset}${utils_js_1.c.cyan}sf create${utils_js_1.c.reset}${utils_js_1.c.dim} "your thesis"${utils_js_1.c.reset}`);
+        console.log(`${utils_js_1.c.dim}Want 24/7 monitoring + edge detection? ${utils_js_1.c.reset}${utils_js_1.c.cyan}sf create${utils_js_1.c.reset}${utils_js_1.c.dim} "${query.slice(0, 50)}"${utils_js_1.c.reset}`);
         console.log('');
     }
 }

package/dist/config.js

@@ -126,11 +126,11 @@ function isConfigured() {
 function requireTrading() {
     const config = loadConfig();
     if (!config.tradingEnabled) {
-        console.error('\n  ⚠️  Trading is disabled. Run: sf setup --enable-trading\n');
+        console.error('\n  Trading is disabled. Run: sf setup --enable-trading\n');
         process.exit(1);
     }
     if (!config.kalshiKeyId && !process.env.KALSHI_API_KEY_ID) {
-        console.error('\n  ⚠️  Kalshi API key not configured. Run: sf setup\n');
+        console.error('\n  Kalshi API key not configured. Run: sf setup --kalshi\n');
         process.exit(1);
     }
 }

package/dist/index.js

@@ -77,6 +77,7 @@ const GROUPED_HELP = `
 
 \x1b[1mSetup\x1b[22m
   \x1b[36mlogin\x1b[39m                      Browser login (recommended)
+  \x1b[36mlogout\x1b[39m                     Clear saved credentials
   \x1b[36msetup\x1b[39m                      Interactive config wizard (power users)
   \x1b[36msetup --check\x1b[39m              Show config status
   \x1b[36msetup --polymarket\x1b[39m         Configure Polymarket wallet
@@ -149,7 +150,7 @@ const GROUPED_HELP = `
 program
     .name('sf')
     .description('SimpleFunctions CLI — prediction market thesis agent')
-    .version('0.1.0')
+    .version('1.7.17')
     .option('--api-key <key>', 'API key (or set SF_API_KEY env var)')
     .option('--api-url <url>', 'API base URL (or set SF_API_URL env var)')
     .configureHelp({
@@ -247,7 +248,7 @@ async function interactiveEntry() {
     console.log();
 }
 // ── Pre-action guard: check configuration ────────────────────────────────────
-const NO_CONFIG_COMMANDS = new Set(['setup', 'login', 'help', 'scan', 'explore', 'query', 'context', 'markets', 'milestones', 'forecast', 'settlements', 'balance', 'orders', 'fills', 'schedule', 'announcements', 'history', 'liquidity', 'book', 'prompt', 'sf']);
+const NO_CONFIG_COMMANDS = new Set(['setup', 'login', 'logout', 'help', 'scan', 'explore', 'query', 'context', 'markets', 'watch', 'milestones', 'forecast', 'settlements', 'balance', 'orders', 'fills', 'schedule', 'announcements', 'history', 'liquidity', 'book', 'prompt', 'sf']);
 program.hook('preAction', (thisCommand, actionCommand) => {
     const cmdName = actionCommand.name();
     if (NO_CONFIG_COMMANDS.has(cmdName))
@@ -259,7 +260,7 @@ program.hook('preAction', (thisCommand, actionCommand) => {
     if (!(0, config_js_1.isConfigured)()) {
         const isJson = process.argv.includes('--json');
         if (isJson) {
-            console.log(JSON.stringify({ error: 'API key required. Run sf setup or pass --api-key.', code: 'NOT_CONFIGURED' }));
+            console.log(JSON.stringify({ error: 'API key required.', code: 'NOT_CONFIGURED', keyUrl: 'https://simplefunctions.dev/dashboard/keys', cli: 'sf login' }));
         }
         else {
             console.log();
@@ -268,7 +269,8 @@ program.hook('preAction', (thisCommand, actionCommand) => {
             console.log('    2. \x1b[36msf setup\x1b[39m           Interactive wizard (2 min)');
             console.log('    3. \x1b[36msf --api-key KEY\x1b[39m   Pass inline');
             console.log();
-            console.log('  \x1b[2mDon\'t have a key? Try \x1b[36msf scan "oil"\x1b[22m\x1b[2m — works without login.\x1b[22m');
+            console.log('  \x1b[2mGet a key at: \x1b[36mhttps://simplefunctions.dev/dashboard/keys\x1b[22m');
+            console.log('  \x1b[2mNo key? Try \x1b[36msf scan "oil"\x1b[22m\x1b[2m — works without login.\x1b[22m');
         }
         console.log();
         process.exit(1);
@@ -292,9 +294,27 @@ program
 program
     .command('login')
     .description('Browser-based login (recommended — no API keys needed)')
-    .action(async (_opts, cmd) => {
+    .option('--force', 'Re-login even if already configured')
+    .action(async (opts, cmd) => {
     const g = cmd.optsWithGlobals();
-    await run(() => (0, login_js_1.loginCommand)({ apiUrl: g.apiUrl }));
+    await run(() => (0, login_js_1.loginCommand)({ apiUrl: g.apiUrl, force: opts.force }));
+});
+// ── sf logout ────────────────────────────────────────────────────────────────
+program
+    .command('logout')
+    .description('Clear saved credentials')
+    .action(async () => {
+    await run(async () => {
+        const { resetConfig, loadFileConfig } = await import('./config.js');
+        const cfg = loadFileConfig();
+        if (!cfg.apiKey) {
+            console.log(`\n  ${utils_js_1.c.dim}Not logged in.${utils_js_1.c.reset}\n`);
+            return;
+        }
+        resetConfig();
+        console.log(`\n  Logged out. Credentials removed from ~/.sf/config.json`);
+        console.log(`  ${utils_js_1.c.dim}Run ${utils_js_1.c.cyan}sf login${utils_js_1.c.dim} to re-authenticate.${utils_js_1.c.reset}\n`);
+    });
 });
 // ── sf list ──────────────────────────────────────────────────────────────────
 program

package/dist/utils.d.ts

@@ -34,6 +34,16 @@ export declare function rpad(s: string, width: number): string;
 export declare function hr(width?: number): void;
 /** Print an error and exit */
 export declare function die(msg: string): never;
+/**
+ * Print an error with an actionable suggestion.
+ * Use instead of bare console.error for user-facing errors.
+ */
+export declare function errorWithHint(message: string, hint?: string): void;
+/**
+ * Print an empty state message with a next-action CTA.
+ * Use when a command returns zero results.
+ */
+export declare function emptyState(thing: string, nextAction?: string): void;
 /** Print a section header */
 export declare function header(title: string): void;
 /** Truncate a string with ellipsis */

package/dist/utils.js

@@ -15,6 +15,8 @@ exports.pad = pad;
 exports.rpad = rpad;
 exports.hr = hr;
 exports.die = die;
+exports.errorWithHint = errorWithHint;
+exports.emptyState = emptyState;
 exports.header = header;
 exports.trunc = trunc;
 exports.shortId = shortId;
@@ -108,6 +110,26 @@ function die(msg) {
     console.error(`${exports.c.red}Error:${exports.c.reset} ${msg}`);
     process.exit(1);
 }
+/**
+ * Print an error with an actionable suggestion.
+ * Use instead of bare console.error for user-facing errors.
+ */
+function errorWithHint(message, hint) {
+    console.error(`\n  ${exports.c.red}Error:${exports.c.reset} ${message}`);
+    if (hint)
+        console.error(`  ${exports.c.dim}${hint}${exports.c.reset}`);
+    console.error();
+}
+/**
+ * Print an empty state message with a next-action CTA.
+ * Use when a command returns zero results.
+ */
+function emptyState(thing, nextAction) {
+    console.log(`\n  ${exports.c.dim}No ${thing} found.${exports.c.reset}`);
+    if (nextAction)
+        console.log(`  ${exports.c.dim}${nextAction}${exports.c.reset}`);
+    console.log();
+}
 /** Print a section header */
 function header(title) {
     console.log(`\n${exports.c.bold}${exports.c.cyan}${title}${exports.c.reset}`);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@spfunctions/cli",
-  "version": "1.7.17",
+  "version": "1.7.19",
+  "mcpName": "io.github.spfunctions/simplefunctions",
   "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"