snowbll-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Snowbll
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,234 @@
+# Snowbll MCP
+
+**Snowbll gives AI agents deep Gaming Behaviour Intelligence.**
+
+> Not another game recommender. A behaviour intelligence layer for gaming agents.
+
+Snowbll MCP is a [Model Context Protocol](https://modelcontextprotocol.io) server
+that exposes Snowbll's gaming-behaviour intelligence as tools any AI agent can
+call — Claude, Cursor, Windsurf, OpenAI Agents SDK, LangChain, CrewAI, AutoGen,
+the Vercel AI SDK, and custom TypeScript/Python agents.
+
+It helps agents understand how a gamer actually plays: their playstyle DNA,
+gaming persona, session patterns, completion behavior, purchase behavior,
+genre mismatches, game-fit prediction, and likely next best game.
+
+## What this is (and is not)
+
+```
+AI Agent
+  → Snowbll MCP Server (stdio)
+    → Snowbll API or mock data
+      → Gaming Behaviour Intelligence
+```
+
+Snowbll MCP is **not** the agent. It is a **tool provider**. The agent decides
+when to call a tool; Snowbll MCP returns structured behaviour intelligence as
+JSON. The first version ships with realistic **mock data** so you can build and
+test integrations immediately, with no backend required.
+
+## Install
+
+```bash
+npm install
+npm run build
+```
+
+## Run locally
+
+Run the server in mock mode (the default — no API key needed):
+
+```bash
+npm run dev
+```
+
+You should see, on stderr:
+
+```
+[snowbll-mcp] running on stdio — data mode: mock
+```
+
+The server speaks MCP over stdio, so it's meant to be launched by an MCP client
+(Claude Desktop, Cursor, etc.) rather than used interactively. To smoke-test the
+built binary directly:
+
+```bash
+npm run build
+node dist/index.js
+```
+
+## Connect it to Claude / Cursor (local development)
+
+After `npm run build`, point your MCP client at the built file. Use an absolute
+path to `dist/index.js`.
+
+```json
+{
+  "mcpServers": {
+    "snowbll": {
+      "command": "node",
+      "args": ["C:/PATH/TO/snowbll-mcp/dist/index.js"],
+      "env": {
+        "SNOWBLL_USE_MOCK": "true"
+      }
+    }
+  }
+}
+```
+
+- **Claude Desktop:** add this to `claude_desktop_config.json`
+  (Settings → Developer → Edit Config), then restart Claude Desktop.
+- **Cursor / Windsurf:** add it to the editor's MCP settings (`mcp.json`).
+
+### Future: install from npm
+
+Once Snowbll MCP is published and you have an API key, no local build is needed:
+
+```json
+{
+  "mcpServers": {
+    "snowbll": {
+      "command": "npx",
+      "args": ["-y", "snowbll-mcp"],
+      "env": {
+        "SNOWBLL_API_KEY": "snb_YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+| Variable           | Default                       | Description                                                                 |
+| ------------------ | ----------------------------- | --------------------------------------------------------------------------- |
+| `SNOWBLL_USE_MOCK` | `true`                        | Use local mock intelligence. Set to `false` to call the real Snowbll API.   |
+| `SNOWBLL_API_URL`  | `https://api.snowbll.com/v1`  | Base URL of the Snowbll API (live mode only).                               |
+| `SNOWBLL_API_KEY`  | _(none)_                      | Required when `SNOWBLL_USE_MOCK=false`. Format `snb_...`.                    |
+| `SNOWBLL_API_TIMEOUT_MS` | `10000`                 | Per-request timeout (live mode). Hung requests abort and surface an error.  |
+| `SNOWBLL_API_RETRIES` | `2`                        | Retries after the first attempt for transient errors (timeout, 429, 5xx).   |
+
+Mock mode is the default: the server runs with zero configuration and never
+needs an API key. In live mode (`SNOWBLL_USE_MOCK=false`), a missing
+`SNOWBLL_API_KEY` produces a clear, actionable error. Live requests time out and
+retry transient failures (429/5xx) with exponential backoff; non-retryable 4xx
+errors fail fast.
+
+## Tests
+
+```bash
+npm test
+```
+
+Runs the suite via Node's built-in test runner (`tsx test/all.test.ts`): mock
+intelligence logic, output-schema round-trips, client mock/live routing, and the
+HTTP layer's timeout/retry behaviour (against a local server). No network.
+
+## Common workflows
+
+**Understand a player**
+1. `get_player_overview` — high-level identity and current objective.
+2. `analyze_player_behaviour` — full behavioural analysis (`depth: "deep"` for correlations and risks).
+3. `get_persona_cards` / `get_playstyle_dna` — evidence-backed detail.
+
+**Explain taste and behaviour**
+- `explain_taste_pattern` with a question like _"Why do I abandon open-world RPGs?"_
+- `detect_genre_mismatch` to surface where stated taste diverges from observed behaviour.
+
+**Predict game fit**
+- `predict_game_fit` for one title.
+- `compare_games_for_player` to rank 2–5 candidates.
+
+**Recommend what to play next**
+- `recommend_games` with an objective (`likely_to_finish`, `hidden_gems`, `deep_systems`, `comfort_games`, `short_sessions`, `high_progression`).
+
+## Tool catalog
+
+| Tool                         | Input                                                   | What it returns                                                            |
+| ---------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `get_player_overview`        | _none_                                                  | Totals, persona match, current objective, identity summary.                |
+| `get_playstyle_dna`          | _none_                                                  | Playstyle traits with scores and tiers, plus the player's unique edge.     |
+| `get_persona_cards`          | _none_                                                  | Persona cards with rarity, level, progress, and evidence.                  |
+| `get_activity_patterns`      | _none_                                                  | Active hours, session-length distribution, platform split, play rhythm.    |
+| `get_completion_behavior`    | _none_                                                  | Completion rate, strong/weak categories, drop-off signals.                 |
+| `get_purchase_behavior`      | `includeSensitiveSignals?`                              | Purchase aggregates and buy-vs-play mismatch.                              |
+| `detect_genre_mismatch`      | `includePurchaseSignals?`, `includeCompletionSignals?` | Where claimed/purchased taste diverges from observed behaviour.            |
+| `analyze_player_behaviour`   | `depth?`, `includeEvidence?`                            | Full behavioural analysis with evidence and interpretation.               |
+| `explain_taste_pattern`      | `topic`                                                 | Explanation, supporting signals, and actionable advice for a topic.        |
+| `predict_game_fit`           | `gameTitle`, `platform?`                                | Fit score, finish likelihood, drop-off risk, and reasoning for one game.   |
+| `compare_games_for_player`   | `games[2..5]`                                           | Ranked comparison with a best pick.                                        |
+| `recommend_games`            | `objective?`, `limit?`                                  | Behaviour-fit game recommendations for a chosen objective.                 |
+| `crosscheck_recommendations` | `objective?`, `limit?`                                  | Games validated by TWO engines (consensus + referee) with an agreement score. |
+
+## Resources
+
+Attach a player's Snowbll context directly (read-only) instead of calling several tools:
+
+| Resource URI                     | Contents                                                |
+| -------------------------------- | ------------------------------------------------------- |
+| `snowbll://player/profile`       | Combined overview + playstyle DNA + personas + activity |
+| `snowbll://player/overview`      | High-level identity and current objective               |
+| `snowbll://player/playstyle-dna` | Playstyle traits with scores and tiers                  |
+| `snowbll://player/personas`      | Persona cards                                            |
+
+## Prompts
+
+Ready-made templates, surfaced as slash-commands in Claude Desktop / Cursor:
+
+| Prompt              | Arguments    | What it does                                 |
+| ------------------- | ------------ | -------------------------------------------- |
+| `understand-player` | —            | Build a full profile of the player           |
+| `what-to-play`      | `objective?` | Recommend the next game and explain why      |
+| `should-i-play`     | `gameTitle`  | Predict fit and finish likelihood for a game |
+| `compare-games`     | `games`      | Rank 2–5 games by behavioural fit            |
+
+> **Structured output:** the behaviour-intelligence tools return validated
+> `structuredContent` (machine-readable JSON) alongside the text result.
+
+## Privacy
+
+By default, Snowbll MCP tools return **aggregate behaviour intelligence** — not
+raw session logs, raw purchase data, private posts, or friend data.
+`get_purchase_behavior` only exposes raw, purchase-level detail when explicitly
+asked via `includeSensitiveSignals: true`; otherwise it returns aggregates only.
+
+## Extending to a real backend
+
+`src/client.ts` is the single seam between the MCP tools and the data source.
+Each tool maps to one `client.call(endpoint, payload, mockFn)`:
+
+- In **mock mode**, `mockFn()` (from `src/mockData.ts`) returns the data.
+- In **live mode**, the same call `POST`s `payload` to `SNOWBLL_API_URL + endpoint`
+  with `Authorization: Bearer <SNOWBLL_API_KEY>` and returns the JSON response.
+
+To wire up the real Snowbll API, implement those endpoints to match the response
+shapes in `src/mockData.ts` (exported as TypeScript interfaces) and set
+`SNOWBLL_USE_MOCK=false`. No changes to `index.ts` are required.
+
+## Project layout
+
+```
+snowbll-mcp/
+  package.json
+  tsconfig.json
+  README.md
+  src/
+    index.ts           # MCP server: registers tools, resources & prompts over stdio
+    client.ts          # game data layer: mock-by-default, future real-API client
+    communityClient.ts # community/forum data layer (Community Recommendation Engine)
+    mockData.ts        # typed mock dataset + helpers (game response shapes)
+    schemas.ts         # zod output schemas (structured output) + type-sync guard
+    resources.ts       # MCP resources (player snapshots)
+    prompts.ts         # MCP prompts (slash-command templates)
+    http.ts            # HTTP helper: timeout, retry, typed errors
+  test/                # node:test suite (npm test)
+```
+
+## Tech stack
+
+TypeScript (strict, ESM) · Node.js ≥ 18 · `@modelcontextprotocol/sdk` · `zod` ·
+stdio MCP transport.
+
+## License
+
+MIT

package/dist/client.js

@@ -0,0 +1,107 @@
+/**
+ * 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

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

package/dist/communityClient.js

@@ -0,0 +1,96 @@
+/**
+ * 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

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

package/dist/crossCheckClient.js

@@ -0,0 +1,83 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/dist/http.js

@@ -0,0 +1,70 @@
+/**
+ * Small, dependency-free HTTP helper with timeout, retry, and typed errors.
+ *
+ * Used by SnowbllClient in live mode so a slow or flaky Snowbll API can't hang a
+ * tool call forever and transient failures recover automatically.
+ */
+export class HttpError extends Error {
+    status;
+    statusText;
+    detail;
+    constructor(status, statusText, detail) {
+        super(`HTTP ${status} ${statusText}${detail ? `: ${detail}` : ""}`);
+        this.status = status;
+        this.statusText = statusText;
+        this.detail = detail;
+        this.name = "HttpError";
+    }
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Exponential backoff, capped at 1s. */
+const backoffMs = (attempt) => Math.min(1000, 200 * 2 ** attempt);
+/** 429 (rate limited) and 5xx (server) are transient; other 4xx are not. */
+const isRetryableStatus = (status) => status === 429 || status >= 500;
+/**
+ * POST/GET JSON with timeout + retry. Resolves the parsed JSON body, or throws:
+ *   - HttpError for a non-OK response (after retries for 429/5xx),
+ *   - Error("request timed out …") on timeout,
+ *   - Error("network error …") on connection failure.
+ */
+export async function requestJson(url, options = {}) {
+    const { method = "POST", headers = {}, body, timeoutMs = 10000, retries = 2, } = options;
+    let lastError = new Error("request not attempted");
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let res;
+        try {
+            res = await fetch(url, {
+                method,
+                headers: { "content-type": "application/json", ...headers },
+                body: body === undefined ? undefined : JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            lastError = controller.signal.aborted
+                ? new Error(`request timed out after ${timeoutMs}ms`)
+                : new Error(`network error: ${err instanceof Error ? err.message : String(err)}`);
+            if (attempt < retries) {
+                await sleep(backoffMs(attempt));
+                continue;
+            }
+            throw lastError;
+        }
+        clearTimeout(timer);
+        if (res.ok) {
+            return (await res.json());
+        }
+        if (isRetryableStatus(res.status) && attempt < retries) {
+            lastError = new HttpError(res.status, res.statusText, "");
+            await sleep(backoffMs(attempt));
+            continue;
+        }
+        const detail = await res.text().catch(() => "");
+        throw new HttpError(res.status, res.statusText, detail);
+    }
+    throw lastError;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEhB;IACA;IACA;IAHlB,YACkB,MAAc,EACd,UAAkB,EAClB,MAAc;QAE9B,KAAK,CAAC,QAAQ,MAAM,IAAI,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAJpD,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAaD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD,yCAAyC;AACzC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;AAElF,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG,CAAC,MAAc,EAAW,EAAE,CACpD,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,UAA0B,EAAE;IAE5B,MAAM,EACJ,MAAM,GAAG,MAAM,EACf,OAAO,GAAG,EAAE,EACZ,IAAI,EACJ,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,CAAC,GACZ,GAAG,OAAO,CAAC;IAEZ,IAAI,SAAS,GAAU,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAE1D,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAE9D,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBACrB,MAAM;gBACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE;gBAC3D,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC3D,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO;gBACnC,CAAC,CAAC,IAAI,KAAK,CAAC,2BAA2B,SAAS,IAAI,CAAC;gBACrD,CAAC,CAAC,IAAI,KAAK,CACP,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrE,CAAC;YACN,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;gBACtB,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,MAAM,SAAS,CAAC;QAClB,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpB,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;QACjC,CAAC;QAED,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;YACvD,SAAS,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}