snowbll-mcp 0.1.0 → 0.2.0

package/dist/config.js

@@ -0,0 +1,51 @@
+import { mkdirSync, readFileSync, writeFileSync, rmSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Where the CLI keeps its state: ~/.snowbll/config.json
+ * Resolution order for every setting: environment variable, then config file,
+ * then built-in default — so CI/agent configs (env) always win over `snowbll
+ * setup` (file).
+ */
+export const DEFAULT_API_BASE = "https://www.snowbll.com";
+// Supabase project behind snowbll.com. The anon key is public-safe by design
+// (it ships in every browser bundle of the live site; RLS protects data) and
+// is only used for the email+password login flow that mints an API key.
+export const SUPABASE_URL = "https://jeuzlcpqaawcfiajkumh.supabase.co";
+export const SUPABASE_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImpldXpsY3BxYWF3Y2ZpYWprdW1oIiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODA0NTA5MjcsImV4cCI6MjA5NjAyNjkyN30.XF3E1dYmpVPM_dBtkFgjFgk7RiJk-F_5vFEE5y4V8SM";
+const configDir = () => join(homedir(), ".snowbll");
+const configPath = () => join(configDir(), "config.json");
+export function readConfig() {
+    try {
+        return JSON.parse(readFileSync(configPath(), "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeConfig(patch) {
+    const next = { ...readConfig(), ...patch };
+    for (const key of Object.keys(next)) {
+        if (next[key] === undefined)
+            delete next[key];
+    }
+    mkdirSync(configDir(), { recursive: true });
+    writeFileSync(configPath(), `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
+}
+export function clearConfig() {
+    if (existsSync(configPath()))
+        rmSync(configPath());
+}
+export function getApiKey() {
+    return process.env.SNOWBLL_API_KEY || readConfig().apiKey || undefined;
+}
+export function getApiBase() {
+    const base = process.env.SNOWBLL_API_BASE || readConfig().apiBase || DEFAULT_API_BASE;
+    return base.replace(/\/+$/, "");
+}
+export function getSupabaseUrl() {
+    return (process.env.SNOWBLL_SUPABASE_URL || SUPABASE_URL).replace(/\/+$/, "");
+}
+export function getSupabaseAnonKey() {
+    return process.env.SNOWBLL_SUPABASE_ANON_KEY || SUPABASE_ANON_KEY;
+}

package/dist/server.js

@@ -0,0 +1,135 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getForgeCampaign, getGame, getPersona, listForgeCampaigns, searchGames, SnowbllApiError, } from "./api.js";
+import { getApiBase, getApiKey } from "./config.js";
+/**
+ * The Snowbll MCP server over stdio — the local twin of the hosted server at
+ * https://www.snowbll.com/api/mcp. Same five read-only tools as the docs'
+ * tool catalog; every call hits the live Snowbll API (no mock data).
+ *
+ * Works keyless for public data (search, Forge). get_game and get_persona use
+ * the developer-preview keyed API, so they need SNOWBLL_API_KEY (or a key
+ * stored by `snowbll-mcp setup`).
+ */
+const json = (value) => ({
+    content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+});
+const toolError = (err) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify({
+                error: err instanceof Error ? err.message : String(err),
+                ...(err instanceof SnowbllApiError && err.status ? { status: err.status } : {}),
+            }),
+        },
+    ],
+    isError: true,
+});
+const READ_ONLY = { readOnlyHint: true, openWorldHint: false };
+export function buildServer(version) {
+    const server = new McpServer({ name: "snowbll", version });
+    server.registerTool("search_games", {
+        title: "Search games",
+        description: "Natural-language search over the Snowbll catalog. Pass a player-style sentence " +
+            '(e.g. "economy sim like Lemonade Tycoon with a deep economy") and get ranked ' +
+            "candidates with reasons. Results are fit candidates, not quality verdicts: " +
+            "`verification` is 'verified' only after third-party human testing. Free, no key needed.",
+        inputSchema: {
+            query: z.string().min(1).describe("Player-style natural-language query."),
+            limit: z.number().int().min(1).max(10).optional().describe("Max candidates (default 5)."),
+        },
+        annotations: READ_ONLY,
+    }, async ({ query, limit }) => {
+        try {
+            return json(await searchGames(query, limit ?? 5));
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    server.registerTool("get_game", {
+        title: "Get game",
+        description: "Full metadata for one catalog game by id (ids come from search_games), including " +
+            "its human-verification status. Quality fields can be null — no qualified human " +
+            "rated them yet, not that the game is bad. Free, no key needed.",
+        inputSchema: {
+            game_id: z.string().min(1).describe("Snowbll game id from search results."),
+            include_reviews: z
+                .boolean()
+                .optional()
+                .describe("Include public review aggregates (behavioralSignals) when available. Default true."),
+        },
+        annotations: READ_ONLY,
+    }, async ({ game_id, include_reviews }) => {
+        try {
+            const data = (await getGame(game_id));
+            if (include_reviews === false && data?.game) {
+                const { behavioralSignals: _omit, ...rest } = data.game;
+                return json({ ...data, game: rest });
+            }
+            return json(data);
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    server.registerTool("get_persona", {
+        title: "Get persona",
+        description: "Read a player's gaming persona (playstyle summary + structured analysis). " +
+            "Consent-scoped: needs an API key and reads the persona of the key owner. " +
+            "Persona intelligence is a paid feature (Observer rank up); free accounts get " +
+            "a locked marker with an upgrade link. A shallow or null persona on a paid " +
+            "account means the player shared little — by design.",
+        inputSchema: {
+            player_id: z.string().optional().describe("Player id, or 'me' (default) for the key owner."),
+        },
+        annotations: READ_ONLY,
+    }, async ({ player_id }) => {
+        try {
+            return json(await getPersona(player_id ?? "me"));
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    server.registerTool("list_forge_campaigns", {
+        title: "List Forge campaigns",
+        description: "Campaigns on The Forge (Snowbll's pre-release backing surface) with live funding " +
+            "totals. Read-only: backing happens on snowbll.com, by the player.",
+        inputSchema: {
+            status: z.enum(["live", "funded", "past"]).optional().describe("Filter by status."),
+        },
+        annotations: READ_ONLY,
+    }, async ({ status }) => {
+        try {
+            return json(await listForgeCampaigns(status));
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    server.registerTool("get_forge_campaign", {
+        title: "Get Forge campaign",
+        description: "One Forge campaign in detail: reward tiers, stretch goals, live progress.",
+        inputSchema: {
+            campaign_id: z.string().min(1).describe("Forge campaign id."),
+        },
+        annotations: READ_ONLY,
+    }, async ({ campaign_id }) => {
+        try {
+            return json(await getForgeCampaign(campaign_id));
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    return server;
+}
+export async function runStdioServer(version) {
+    const server = buildServer(version);
+    await server.connect(new StdioServerTransport());
+    // stdout is the MCP wire — status goes to stderr only.
+    console.error(`[snowbll-mcp] v${version} on stdio — live API: ${getApiBase()} — key: ${getApiKey() ? "configured" : "none (public tools only)"}`);
+}

package/dist/setup.js

@@ -0,0 +1,58 @@
+import { createInterface } from "node:readline/promises";
+import { whoami } from "./api.js";
+import { getApiBase, getApiKey, writeConfig } from "./config.js";
+/**
+ * `snowbll-mcp setup` / `snowbll setup` — the wizard the docs' agent prompt
+ * walks through: paste a developer-preview key (optional), validate it against
+ * the live API, store it, and print ready-to-paste MCP configs.
+ */
+export async function runSetup() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log("Snowbll MCP setup");
+    console.log("─".repeat(60));
+    console.log(`API base: ${getApiBase()}`);
+    console.log("An API key unlocks get_game and get_persona. Search and Forge tools work without one.\n" +
+        "Get a key with `snowbll login` (email+password account) or from the Snowbll team.\n");
+    const existing = getApiKey();
+    const answer = await rl.question(existing
+        ? `A key is already configured (${existing.slice(0, 11)}…). Paste a new one to replace it, or press Enter to keep it: `
+        : "Paste your API key (sb_...), or press Enter to skip: ");
+    rl.close();
+    const key = answer.trim();
+    if (key) {
+        if (!/^sb_[0-9a-f]{48}$/.test(key)) {
+            console.error("That does not look like a Snowbll API key (sb_ + 48 hex). Nothing saved.");
+            process.exitCode = 1;
+            return;
+        }
+        writeConfig({ apiKey: key });
+        console.log("Key saved to ~/.snowbll/config.json");
+    }
+    if (key || existing) {
+        try {
+            const me = (await whoami());
+            console.log(`Key verified — signed in as ${me.display_name ?? me.email ?? "unknown account"}.`);
+        }
+        catch (err) {
+            console.error(`Key did NOT verify: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    }
+    console.log("\nConnect an agent — pick the line that matches yours:");
+    console.log("─".repeat(60));
+    console.log("Claude Code (local stdio):");
+    console.log("  claude mcp add snowbll -- npx -y snowbll-mcp\n");
+    console.log("Claude Desktop / Cursor / Hermes (claude_desktop_config.json or equivalent):");
+    console.log(JSON.stringify({
+        mcpServers: {
+            snowbll: {
+                command: "npx",
+                args: ["-y", "snowbll-mcp"],
+                env: { SNOWBLL_API_KEY: key || existing || "sb_YOUR_API_KEY" },
+            },
+        },
+    }, null, 2));
+    console.log("\nChatGPT / any remote-MCP client (no install):");
+    console.log(`  ${getApiBase()}/api/mcp   (Streamable HTTP, no auth needed for public tools)`);
+    console.log("\nVerify with: snowbll search \"economy sim like Lemonade Tycoon with a deep economy\"");
+}

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "snowbll-mcp",
-  "version": "0.1.0",
-  "description": "Snowbll MCP Server — Gaming Behaviour Intelligence tools for AI agents (Claude, Cursor, Windsurf, OpenAI Agents SDK, LangChain, CrewAI, AutoGen, Vercel AI SDK).",
+  "version": "0.2.0",
+  "description": "Snowbll MCP server + CLI — search the Snowbll game catalog, read consented personas, and follow Forge campaigns from any MCP-capable AI agent (Claude, ChatGPT, Cursor, Hermes) or your terminal. Live API, no mock data.",
   "type": "module",
   "license": "MIT",
+  "homepage": "https://www.snowbll.com/docs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/calvinasd567-boop/snowbll-mcp.git"
+  },
   "bin": {
-    "snowbll-mcp": "dist/index.js"
+    "snowbll-mcp": "dist/bin/snowbll-mcp.js",
+    "snowbll": "dist/bin/snowbll.js"
   },
   "files": [
     "dist",
@@ -15,30 +21,27 @@
     "node": ">=18"
   },
   "scripts": {
-    "dev": "tsx src/index.ts",
     "build": "tsc",
-    "start": "node dist/index.js",
-    "test": "tsx test/all.test.ts",
-    "prepublishOnly": "npm run build && npm test"
+    "dev": "tsx src/bin/snowbll-mcp.ts",
+    "test": "node test/smoke.mjs",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",
     "model-context-protocol",
     "snowbll",
     "gaming",
-    "behaviour-intelligence",
+    "game-discovery",
     "ai-agents",
-    "playstyle",
-    "persona"
+    "persona",
+    "cli"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "zod": "^3.23.8"
+    "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",
-    "snowbll-community-recommendation-engine": "file:../community-recommendation-engine",
-    "snowbll-recommendation-engine": "file:../recommendation-engine",
     "tsx": "^4.16.0",
     "typescript": "^5.5.0"
   }

package/dist/client.js

@@ -1,107 +0,0 @@
-/**
- * SnowbllClient — the data layer behind the MCP tools.
- *
- * Mock mode is the DEFAULT. The client only talks to the real Snowbll API when
- * SNOWBLL_USE_MOCK is explicitly set to the string "false". This lets the MCP
- * server run with zero configuration today, while keeping a single seam through
- * which a real backend can be wired in later without touching index.ts.
- *
- * Environment variables:
- *   SNOWBLL_USE_MOCK         "false" -> call the real API. Anything else (or unset) -> mock.
- *   SNOWBLL_API_URL          Base URL of the Snowbll API (default https://api.snowbll.com/v1).
- *   SNOWBLL_API_KEY          Required only in live mode; format snb_...
- *   SNOWBLL_API_TIMEOUT_MS   Per-request timeout in ms (default 10000).
- *   SNOWBLL_API_RETRIES      Retries after the first attempt for transient errors (default 2).
- */
-import { requestJson } from "./http.js";
-import * as mock from "./mockData.js";
-const DEFAULT_API_URL = "https://api.snowbll.com/v1";
-/** Parse a positive-number env var, falling back to a default. */
-function numEnv(value, fallback, min = 0) {
-    const n = Number(value);
-    return Number.isFinite(n) && n >= min ? n : fallback;
-}
-export class SnowbllClient {
-    useMock;
-    apiUrl;
-    apiKey;
-    timeoutMs;
-    retries;
-    constructor() {
-        // Mock is the default. Only the literal "false" opts into the live API.
-        this.useMock = process.env.SNOWBLL_USE_MOCK !== "false";
-        this.apiUrl = (process.env.SNOWBLL_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
-        this.apiKey = process.env.SNOWBLL_API_KEY;
-        this.timeoutMs = numEnv(process.env.SNOWBLL_API_TIMEOUT_MS, 10000, 1);
-        this.retries = numEnv(process.env.SNOWBLL_API_RETRIES, 2, 0);
-    }
-    /** "mock" when serving local data, "live" when calling the real Snowbll API. */
-    get mode() {
-        return this.useMock ? "mock" : "live";
-    }
-    /**
-     * Route a tool call to mock data or the real API.
-     * In mock mode the network is never touched and no API key is required.
-     */
-    async call(endpoint, payload, mockFn) {
-        if (this.useMock) {
-            return mockFn();
-        }
-        if (!this.apiKey) {
-            throw new Error("Snowbll live API mode is enabled (SNOWBLL_USE_MOCK=false) but SNOWBLL_API_KEY is not set.\n" +
-                "Fix one of the following:\n" +
-                "  - Set SNOWBLL_API_KEY=snb_... to call the real Snowbll API, or\n" +
-                "  - Set SNOWBLL_USE_MOCK=true (or unset it) to use local mock intelligence.");
-        }
-        try {
-            return await requestJson(`${this.apiUrl}${endpoint}`, {
-                method: "POST",
-                headers: { authorization: `Bearer ${this.apiKey}` },
-                body: payload,
-                timeoutMs: this.timeoutMs,
-                retries: this.retries,
-            });
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            throw new Error(`Snowbll API request to ${endpoint} failed: ${message}`);
-        }
-    }
-    getPlayerOverview() {
-        return this.call("/player/overview", {}, () => mock.playerOverview);
-    }
-    getPlaystyleDna() {
-        return this.call("/player/playstyle-dna", {}, () => mock.playstyleDna);
-    }
-    getPersonaCards() {
-        return this.call("/player/persona-cards", {}, () => mock.personaCards);
-    }
-    getActivityPatterns() {
-        return this.call("/player/activity-patterns", {}, () => mock.activityPatterns);
-    }
-    getCompletionBehavior() {
-        return this.call("/player/completion-behavior", {}, () => mock.completionBehavior);
-    }
-    getPurchaseBehavior(includeSensitiveSignals) {
-        return this.call("/player/purchase-behavior", { includeSensitiveSignals }, () => mock.getPurchaseBehavior(includeSensitiveSignals));
-    }
-    detectGenreMismatch(includePurchaseSignals, includeCompletionSignals) {
-        return this.call("/player/genre-mismatch", { includePurchaseSignals, includeCompletionSignals }, () => mock.detectGenreMismatch(includePurchaseSignals, includeCompletionSignals));
-    }
-    analyzePlayerBehaviour(depth, includeEvidence) {
-        return this.call("/player/analyze", { depth, includeEvidence }, () => mock.analyzePlayerBehaviour(depth, includeEvidence));
-    }
-    explainTastePattern(topic) {
-        return this.call("/player/taste-pattern", { topic }, () => mock.explainTastePattern(topic));
-    }
-    predictGameFit(gameTitle, platform) {
-        return this.call("/predict/game-fit", { gameTitle, platform }, () => mock.predictGameFit(gameTitle, platform));
-    }
-    compareGamesForPlayer(games) {
-        return this.call("/predict/compare", { games }, () => mock.compareGames(games));
-    }
-    recommendGames(objective, limit) {
-        return this.call("/recommend", { objective, limit }, () => mock.recommendGames(objective, limit));
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAmBtC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD,kEAAkE;AAClE,SAAS,MAAM,CAAC,KAAyB,EAAE,QAAgB,EAAE,GAAG,GAAG,CAAC;IAClE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,MAAM,OAAO,aAAa;IACP,OAAO,CAAU;IACjB,MAAM,CAAS;IACf,MAAM,CAAqB;IAC3B,SAAS,CAAS;IAClB,OAAO,CAAS;IAEjC;QACE,wEAAwE;QACxE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,eAAe,CAAC,CAAC,OAAO,CACpE,MAAM,EACN,EAAE,CACH,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,gFAAgF;IAChF,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,IAAI,CAChB,QAAgB,EAChB,OAAgC,EAChC,MAAe;QAEf,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,MAAM,EAAE,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,6FAA6F;gBAC3F,6BAA6B;gBAC7B,oEAAoE;gBACpE,6EAA6E,CAChF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,CAAI,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,EAAE;gBACvD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;gBACnD,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,YAAY,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtE,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,IAAI,CACd,2BAA2B,EAC3B,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAC5B,CAAC;IACJ,CAAC;IAED,qBAAqB;QACnB,OAAO,IAAI,CAAC,IAAI,CACd,6BAA6B,EAC7B,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IAED,mBAAmB,CACjB,uBAAgC;QAEhC,OAAO,IAAI,CAAC,IAAI,CACd,2BAA2B,EAC3B,EAAE,uBAAuB,EAAE,EAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,CACxD,CAAC;IACJ,CAAC;IAED,mBAAmB,CACjB,sBAA+B,EAC/B,wBAAiC;QAEjC,OAAO,IAAI,CAAC,IAAI,CACd,wBAAwB,EACxB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,EACpD,GAAG,EAAE,CACH,IAAI,CAAC,mBAAmB,CACtB,sBAAsB,EACtB,wBAAwB,CACzB,CACJ,CAAC;IACJ,CAAC;IAED,sBAAsB,CACpB,KAAoB,EACpB,eAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CACd,iBAAiB,EACjB,EAAE,KAAK,EAAE,eAAe,EAAE,EAC1B,GAAG,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,eAAe,CAAC,CAC1D,CAAC;IACJ,CAAC;IAED,mBAAmB,CAAC,KAAa;QAC/B,OAAO,IAAI,CAAC,IAAI,CACd,uBAAuB,EACvB,EAAE,KAAK,EAAE,EACT,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CACtC,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,SAAiB,EAAE,QAAkB;QAClD,OAAO,IAAI,CAAC,IAAI,CACd,mBAAmB,EACnB,EAAE,SAAS,EAAE,QAAQ,EAAE,EACvB,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAC/C,CAAC;IACJ,CAAC;IAED,qBAAqB,CAAC,KAAe;QACnC,OAAO,IAAI,CAAC,IAAI,CACd,kBAAkB,EAClB,EAAE,KAAK,EAAE,EACT,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAC/B,CAAC;IACJ,CAAC;IAED,cAAc,CACZ,SAA6B,EAC7B,KAAa;QAEb,OAAO,IAAI,CAAC,IAAI,CACd,YAAY,EACZ,EAAE,SAAS,EAAE,KAAK,EAAE,EACpB,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/communityClient.js

@@ -1,96 +0,0 @@
-/**
- * CommunityClient — the data layer behind the community MCP tools.
- *
- * Mirrors {@link SnowbllClient}: mock mode is the DEFAULT. In mock mode the
- * deterministic Community Recommendation Engine runs IN-PROCESS (full fidelity,
- * zero config, no network). When SNOWBLL_USE_MOCK="false" it calls the live
- * Community Recommendation REST API instead.
- *
- * The in-process engine (snowbll-community-recommendation-engine) is a PRIVATE
- * package loaded LAZILY, only in mock mode, and declared as a devDependency — so
- * the published MCP never ships or requires it (published builds use live mode /
- * REST for community tools).
- *
- * Environment variables:
- *   SNOWBLL_USE_MOCK            "false" -> call the live API. Anything else -> in-process engine.
- *   SNOWBLL_COMMUNITY_API_URL   Base URL of the community API (default https://api.snowbll.com/v1/community).
- *   SNOWBLL_COMMUNITY_API_KEY   Required only in live mode; sent as Authorization: Bearer <key>.
- */
-const DEFAULT_API_URL = "https://api.snowbll.com/v1/community";
-let enginePromise;
-function loadEngine() {
-    if (!enginePromise) {
-        enginePromise = import("snowbll-community-recommendation-engine").catch(() => {
-            throw new Error("The in-process community engine is not available in this build.\n" +
-                "Set SNOWBLL_USE_MOCK=false and SNOWBLL_COMMUNITY_API_KEY to use the live community API instead.");
-        });
-    }
-    return enginePromise;
-}
-export class CommunityClient {
-    useMock;
-    apiUrl;
-    apiKey;
-    constructor() {
-        // Mock is the default. Only the literal "false" opts into the live API.
-        this.useMock = process.env.SNOWBLL_USE_MOCK !== "false";
-        this.apiUrl = (process.env.SNOWBLL_COMMUNITY_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
-        this.apiKey = process.env.SNOWBLL_COMMUNITY_API_KEY;
-    }
-    /** "mock" when running the engine in-process, "live" when calling the REST API. */
-    get mode() {
-        return this.useMock ? "mock" : "live";
-    }
-    /**
-     * Route a tool call to the in-process engine (mock) or the live REST API.
-     * In mock mode the network is never touched and no API key is required.
-     */
-    async call(endpoint, payload, mockFn) {
-        if (this.useMock) {
-            return mockFn(await loadEngine());
-        }
-        if (!this.apiKey) {
-            throw new Error("Snowbll live API mode is enabled (SNOWBLL_USE_MOCK=false) but SNOWBLL_COMMUNITY_API_KEY is not set.\n" +
-                "Fix one of the following:\n" +
-                "  - Set SNOWBLL_COMMUNITY_API_KEY=snb_comm_... to call the live community API, or\n" +
-                "  - Set SNOWBLL_USE_MOCK=true (or unset it) to use the local deterministic engine.");
-        }
-        let res;
-        try {
-            res = await fetch(`${this.apiUrl}${endpoint}`, {
-                method: "POST",
-                headers: {
-                    "content-type": "application/json",
-                    authorization: `Bearer ${this.apiKey}`,
-                },
-                body: JSON.stringify(payload),
-            });
-        }
-        catch (cause) {
-            const message = cause instanceof Error ? cause.message : String(cause);
-            throw new Error(`Failed to reach the Snowbll community API at ${this.apiUrl}${endpoint}: ${message}`);
-        }
-        if (!res.ok) {
-            const detail = await res.text().catch(() => "");
-            throw new Error(`Snowbll community API error ${res.status} ${res.statusText} for ${endpoint}` +
-                (detail ? `: ${detail}` : ""));
-        }
-        return (await res.json());
-    }
-    recommendForumThreads(args) {
-        return this.call("/recommend/threads", { ...args }, (engine) => engine.recommendForumThreads({ ...args }));
-    }
-    predictThreadFit(threadTitle) {
-        return this.call("/predict/thread-fit", { threadTitle }, (engine) => engine.predictThreadFit({ threadTitle }));
-    }
-    compareThreadsForPlayer(threads) {
-        return this.call("/compare/threads", { threads }, (engine) => engine.compareThreadsForPlayer({ threads }));
-    }
-    explainThreadRecommendation(threadTitle) {
-        return this.call("/explain/thread", { threadTitle }, (engine) => engine.explainThreadRecommendation({ threadTitle }));
-    }
-    detectThreadsToAvoid(limit) {
-        return this.call("/detect-threads-to-avoid", { limit }, (engine) => engine.detectThreadsToAvoid({ limit }));
-    }
-}
-//# sourceMappingURL=communityClient.js.map

package/dist/communityClient.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"communityClient.js","sourceRoot":"","sources":["../src/communityClient.ts"],"names":[],"mappings":"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"}

package/dist/crossCheckClient.js

@@ -1,83 +0,0 @@
-/**
- * CrossCheckClient — the data layer behind the `crosscheck_recommendations` tool.
- *
- * Mirrors {@link SnowbllClient} / {@link CommunityClient}: mock mode is the DEFAULT
- * and runs the deterministic Recommendation Engine's cross-check IN-PROCESS (full
- * fidelity, zero config, no network). When SNOWBLL_USE_MOCK="false" it calls the
- * live Recommendation REST API (POST /recommend/consensus) instead.
- *
- * The cross-check reconciles TWO independent Snowbll recommenders (this engine and
- * the Persona Engine's own recommender) into one validated answer.
- *
- * The in-process engine (snowbll-recommendation-engine) is a PRIVATE package loaded
- * LAZILY, only in mock mode, and declared as a devDependency — so the published MCP
- * never ships or requires it (published builds use live mode / REST).
- *
- * Environment variables:
- *   SNOWBLL_USE_MOCK       "false" -> call the live API. Anything else -> in-process engine.
- *   SNOWBLL_RECO_API_URL   Base URL of the recommendation API (default https://api.snowbll.com/v1).
- *   SNOWBLL_RECO_API_KEY   OPTIONAL — sent as Authorization: Bearer <key> when set.
- *                          The recommendation API is open by default, so no key is required.
- */
-const DEFAULT_API_URL = "https://api.snowbll.com/v1";
-let recoEnginePromise;
-function loadRecoEngine() {
-    if (!recoEnginePromise) {
-        recoEnginePromise = import("snowbll-recommendation-engine").catch(() => {
-            throw new Error("The in-process recommendation engine is not available in this build.\n" +
-                "Set SNOWBLL_USE_MOCK=false (optionally with SNOWBLL_RECO_API_KEY) to use the live recommendation API instead.");
-        });
-    }
-    return recoEnginePromise;
-}
-export class CrossCheckClient {
-    useMock;
-    apiUrl;
-    apiKey;
-    constructor() {
-        // Mock is the default. Only the literal "false" opts into the live API.
-        this.useMock = process.env.SNOWBLL_USE_MOCK !== "false";
-        this.apiUrl = (process.env.SNOWBLL_RECO_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
-        this.apiKey = process.env.SNOWBLL_RECO_API_KEY;
-    }
-    /** "mock" when running the engine in-process, "live" when calling the REST API. */
-    get mode() {
-        return this.useMock ? "mock" : "live";
-    }
-    /**
-     * Cross-check the two engines for an objective. In mock mode the reconciliation
-     * runs in-process; in live mode it POSTs to /recommend/consensus.
-     */
-    async crossCheckRecommendations(args) {
-        if (this.useMock) {
-            const engine = await loadRecoEngine();
-            return engine.crossCheckRecommendations({
-                objective: args.objective,
-                limit: args.limit,
-                includeCommunity: args.includeCommunity,
-            });
-        }
-        const headers = { "content-type": "application/json" };
-        if (this.apiKey)
-            headers.authorization = `Bearer ${this.apiKey}`;
-        let res;
-        try {
-            res = await fetch(`${this.apiUrl}/recommend/consensus`, {
-                method: "POST",
-                headers,
-                body: JSON.stringify(args),
-            });
-        }
-        catch (cause) {
-            const message = cause instanceof Error ? cause.message : String(cause);
-            throw new Error(`Failed to reach the Snowbll recommendation API at ${this.apiUrl}/recommend/consensus: ${message}`);
-        }
-        if (!res.ok) {
-            const detail = await res.text().catch(() => "");
-            throw new Error(`Snowbll recommendation API error ${res.status} ${res.statusText} for /recommend/consensus` +
-                (detail ? `: ${detail}` : ""));
-        }
-        return (await res.json());
-    }
-}
-//# sourceMappingURL=crossCheckClient.js.map

package/dist/crossCheckClient.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"crossCheckClient.js","sourceRoot":"","sources":["../src/crossCheckClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAIrD,IAAI,iBAAwD,CAAC;AAE7D,SAAS,cAAc;IACrB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACrE,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACtE,+GAA+G,CAClH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAQD,MAAM,OAAO,gBAAgB;IACV,OAAO,CAAU;IACjB,MAAM,CAAS;IACf,MAAM,CAAqB;IAE5C;QACE,wEAAwE;QACxE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,eAAe,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACjD,CAAC;IAED,mFAAmF;IACnF,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,yBAAyB,CAAC,IAAoB;QAClD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;YACtC,OAAO,MAAM,CAAC,yBAAyB,CAAC;gBACtC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;aACxC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QAC/E,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QAEjE,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,sBAAsB,EAAE;gBACtD,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CACb,qDAAqD,IAAI,CAAC,MAAM,yBAAyB,OAAO,EAAE,CACnG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,oCAAoC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,2BAA2B;gBACzF,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAChC,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;IAC/C,CAAC;CACF"}