@spfunctions/cli 1.1.4 → 1.1.5

package/dist/client.d.ts

@@ -18,6 +18,8 @@ export declare class SFClient {
     injectSignal(id: string, type: string, content: string, source?: string): Promise<any>;
     evaluate(id: 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>;
 }
 export declare function kalshiFetchAllSeries(): Promise<any[]>;
 export declare function kalshiFetchEvents(seriesTicker: string): Promise<any[]>;

package/dist/client.js

@@ -65,6 +65,12 @@ class SFClient {
     async updateThesis(id, data) {
         return this.request('PATCH', `/api/thesis/${id}`, data);
     }
+    async publish(id, slug, description) {
+        return this.request('POST', `/api/thesis/${id}/publish`, { slug, description });
+    }
+    async unpublish(id) {
+        return this.request('DELETE', `/api/thesis/${id}/publish`);
+    }
 }
 exports.SFClient = SFClient;
 // ===== Kalshi Public API (no auth) =====

package/dist/commands/agent.js

@@ -613,6 +613,29 @@ async function agentCommand(thesisId, opts) {
                 };
             },
         },
+        {
+            name: 'explore_public',
+            label: 'Explore Public Theses',
+            description: 'Browse public theses from other users. No auth required. Pass a slug to get details, or omit to list all.',
+            parameters: Type.Object({
+                slug: Type.Optional(Type.String({ description: 'Specific thesis slug, or empty to list all' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                const base = 'https://simplefunctions.dev';
+                if (params.slug) {
+                    const res = await fetch(`${base}/api/public/thesis/${params.slug}`);
+                    if (!res.ok)
+                        return { content: [{ type: 'text', text: `Not found: ${params.slug}` }], details: {} };
+                    const data = await res.json();
+                    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+                }
+                const res = await fetch(`${base}/api/public/theses`);
+                if (!res.ok)
+                    return { content: [{ type: 'text', text: 'Failed to fetch public theses' }], details: {} };
+                const data = await res.json();
+                return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], details: {} };
+            },
+        },
     ];
     // ── System prompt builder ──────────────────────────────────────────────────
     function buildSystemPrompt(ctx) {

package/dist/commands/explore.d.ts

@@ -0,0 +1,13 @@
+/**
+ * sf explore [slug]
+ *
+ * Browse public theses. No authentication required.
+ *
+ * Usage:
+ *   sf explore                     — List all public theses
+ *   sf explore us-iran-war         — View a specific public thesis
+ *   sf explore us-iran-war --json  — JSON output (for agents)
+ */
+export declare function exploreCommand(slug?: string, opts?: {
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/explore.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * sf explore [slug]
+ *
+ * Browse public theses. No authentication required.
+ *
+ * Usage:
+ *   sf explore                     — List all public theses
+ *   sf explore us-iran-war         — View a specific public thesis
+ *   sf explore us-iran-war --json  — JSON output (for agents)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exploreCommand = exploreCommand;
+const BASE_URL = 'https://simplefunctions.dev';
+async function exploreCommand(slug, opts) {
+    if (!slug) {
+        // List all public theses
+        const res = await fetch(`${BASE_URL}/api/public/theses`);
+        if (!res.ok) {
+            console.error(`  Error: ${res.status} ${await res.text()}`);
+            return;
+        }
+        const { theses } = await res.json();
+        if (opts?.json) {
+            console.log(JSON.stringify(theses, null, 2));
+            return;
+        }
+        console.log('\n  Public Theses\n');
+        if (theses.length === 0) {
+            console.log('  No public theses yet.\n');
+            return;
+        }
+        for (const t of theses) {
+            const conf = t.confidence != null ? Math.round(t.confidence * 100) : '?';
+            const ret = t.impliedReturn != null ? `${t.impliedReturn > 0 ? '+' : ''}${t.impliedReturn}%` : '';
+            console.log(`  ${(t.slug || '').padEnd(35)} ${String(conf).padStart(3)}%  ${ret.padStart(8)}  ${(t.status || '').padEnd(8)} ${(t.title || '').slice(0, 45)}`);
+        }
+        console.log(`\n  ${theses.length} public theses. Use: sf explore <slug>\n`);
+        return;
+    }
+    // View a specific public thesis
+    const res = await fetch(`${BASE_URL}/api/public/thesis/${slug}`);
+    if (!res.ok) {
+        if (res.status === 404) {
+            console.error(`  Not found: ${slug}`);
+        }
+        else {
+            console.error(`  Error: ${res.status} ${await res.text()}`);
+        }
+        return;
+    }
+    const data = await res.json();
+    if (opts?.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    // Formatted output
+    const t = data.thesis;
+    const ir = data.impliedReturns;
+    console.log(`\n  ${t.title}`);
+    console.log(`  ${t.slug} | ${t.confidence != null ? Math.round(t.confidence * 100) : '?'}% | ${t.status} | published ${t.publishedAt?.slice(0, 10) || '?'}`);
+    if (t.description)
+        console.log(`  ${t.description}`);
+    console.log('');
+    // Causal tree
+    if (data.causalTree?.nodes?.length) {
+        console.log('  Causal Tree');
+        for (const n of data.causalTree.nodes) {
+            const bar = '█'.repeat(Math.round((n.probability || 0) * 10)) + '░'.repeat(10 - Math.round((n.probability || 0) * 10));
+            console.log(`    ${n.id} ${(n.label || '').slice(0, 35).padEnd(35)} ${Math.round((n.probability || 0) * 100)}% ${bar}`);
+            if (n.children) {
+                for (const c of n.children) {
+                    const cbar = '█'.repeat(Math.round((c.probability || 0) * 10)) + '░'.repeat(10 - Math.round((c.probability || 0) * 10));
+                    console.log(`      ${c.id} ${(c.label || '').slice(0, 33).padEnd(33)} ${Math.round((c.probability || 0) * 100)}% ${cbar}`);
+                }
+            }
+        }
+        console.log('');
+    }
+    // Implied returns
+    if (ir && ir.edges?.length > 0) {
+        console.log(`  Implied Returns (equal-weight, since ${ir.trackedSince?.slice(0, 10) || '?'})`);
+        console.log(`  Avg: ${ir.avgReturnPct > 0 ? '+' : ''}${ir.avgReturnPct}% | Win rate: ${ir.winRate}% (${ir.winners}W ${ir.losers}L)`);
+        console.log('');
+        for (const e of ir.edges.slice(0, 10)) {
+            const ret = e.returnPct > 0 ? `+${e.returnPct}%` : `${e.returnPct}%`;
+            console.log(`    ${(e.market || '').slice(0, 35).padEnd(35)} ${e.entryPrice}¢ → ${e.currentPrice}¢  ${ret}`);
+        }
+        console.log('');
+    }
+    // Recent evaluations
+    if (data.confidenceHistory?.length > 0) {
+        console.log('  Recent Evaluations');
+        for (const h of data.confidenceHistory.slice(-5)) {
+            const d = h.delta > 0 ? `+${Math.round(h.delta * 100)}` : `${Math.round(h.delta * 100)}`;
+            console.log(`    ${(h.evaluatedAt || '').slice(0, 16)} ${Math.round(h.confidence * 100)}% (${d}) ${(h.summary || '').slice(0, 60)}`);
+        }
+        console.log('');
+    }
+    // Top edges
+    if (data.edges?.length > 0) {
+        console.log('  Top Edges');
+        const sorted = [...data.edges].sort((a, b) => Math.abs(b.edge) - Math.abs(a.edge)).slice(0, 10);
+        for (const e of sorted) {
+            const liq = e.orderbook?.liquidityScore || '?';
+            console.log(`    ${(e.market || '').slice(0, 35).padEnd(35)} ${e.marketPrice}¢ → ${e.thesisPrice}¢  edge ${e.edge > 0 ? '+' : ''}${e.edge}  ${liq}`);
+        }
+        console.log('');
+    }
+}

package/dist/commands/publish.d.ts

@@ -0,0 +1,15 @@
+/**
+ * sf publish / sf unpublish
+ *
+ * Publish a thesis for public viewing or remove it from public.
+ */
+export declare function publishCommand(thesisId: string, opts: {
+    slug: string;
+    description?: string;
+    apiKey?: string;
+    apiUrl?: string;
+}): Promise<void>;
+export declare function unpublishCommand(thesisId: string, opts: {
+    apiKey?: string;
+    apiUrl?: string;
+}): Promise<void>;

package/dist/commands/publish.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * sf publish / sf unpublish
+ *
+ * Publish a thesis for public viewing or remove it from public.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishCommand = publishCommand;
+exports.unpublishCommand = unpublishCommand;
+const client_js_1 = require("../client.js");
+async function publishCommand(thesisId, opts) {
+    const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
+    await client.publish(thesisId, opts.slug, opts.description);
+    console.log(`\n  ✓ Published: https://simplefunctions.dev/thesis/${opts.slug}\n`);
+}
+async function unpublishCommand(thesisId, opts) {
+    const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
+    await client.unpublish(thesisId);
+    console.log(`\n  ✓ Unpublished thesis ${thesisId}\n`);
+}

package/dist/index.js

@@ -32,6 +32,8 @@ const positions_js_1 = require("./commands/positions.js");
 const edges_js_1 = require("./commands/edges.js");
 const agent_js_1 = require("./commands/agent.js");
 const setup_js_1 = require("./commands/setup.js");
+const publish_js_1 = require("./commands/publish.js");
+const explore_js_1 = require("./commands/explore.js");
 const utils_js_1 = require("./utils.js");
 // ── Apply ~/.sf/config.json to process.env BEFORE any command ────────────────
 // This means client.ts, kalshi.ts, agent.ts keep reading process.env and just work.
@@ -44,7 +46,7 @@ program
     .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)');
 // ── Pre-action guard: check configuration ────────────────────────────────────
-const NO_CONFIG_COMMANDS = new Set(['setup', 'help', 'scan']);
+const NO_CONFIG_COMMANDS = new Set(['setup', 'help', 'scan', 'explore']);
 program.hook('preAction', (thisCommand) => {
     const cmdName = thisCommand.name();
     if (NO_CONFIG_COMMANDS.has(cmdName))
@@ -185,6 +187,32 @@ program
     const g = cmd.optsWithGlobals();
     await run(() => (0, agent_js_1.agentCommand)(thesisId, { model: opts.model, modelKey: opts.modelKey, newSession: opts.new }));
 });
+// ── sf publish <thesisId> ─────────────────────────────────────────────────────
+program
+    .command('publish <thesisId>')
+    .description('Publish a thesis for public viewing')
+    .requiredOption('--slug <slug>', 'URL slug (lowercase, hyphens, 3-60 chars)')
+    .option('--description <desc>', 'Short description')
+    .action(async (thesisId, opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => (0, publish_js_1.publishCommand)(thesisId, { slug: opts.slug, description: opts.description, apiKey: g.apiKey, apiUrl: g.apiUrl }));
+});
+// ── sf unpublish <thesisId> ───────────────────────────────────────────────────
+program
+    .command('unpublish <thesisId>')
+    .description('Remove a thesis from public viewing')
+    .action(async (thesisId, _opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => (0, publish_js_1.unpublishCommand)(thesisId, { apiKey: g.apiKey, apiUrl: g.apiUrl }));
+});
+// ── sf explore [slug] ─────────────────────────────────────────────────────────
+program
+    .command('explore [slug]')
+    .description('Browse public theses (no auth required)')
+    .option('--json', 'JSON output')
+    .action(async (slug, opts) => {
+    await run(() => (0, explore_js_1.exploreCommand)(slug, { json: opts.json }));
+});
 // ── Error wrapper ─────────────────────────────────────────────────────────────
 async function run(fn) {
     try {

package/package.json

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