snowbll-mcp 0.1.0

package/dist/schemas.js

@@ -0,0 +1,174 @@
+/**
+ * Zod output schemas for the Snowbll MCP tools.
+ *
+ * These power MCP "structured output": each tool advertises an outputSchema and
+ * returns structuredContent, so clients/agents get a validated, typed result
+ * (not just a text blob).
+ *
+ * mockData.ts remains the source of the response *shapes* (TypeScript
+ * interfaces). The compile-time assertions at the bottom of this file guarantee
+ * these zod schemas stay exactly in sync with those interfaces — if either side
+ * drifts, the build fails.
+ */
+import { z } from "zod";
+// --- Enums -----------------------------------------------------------------
+export const TierSchema = z.enum(["elite", "strong", "moderate", "low"]);
+export const RaritySchema = z.enum([
+    "common",
+    "uncommon",
+    "rare",
+    "epic",
+    "legendary",
+]);
+export const DropOffRiskSchema = z.enum(["low", "medium", "high"]);
+export const PlatformSchema = z.enum([
+    "steam",
+    "playstation",
+    "xbox",
+    "switch",
+    "epic",
+    "unknown",
+]);
+export const RecommendObjectiveSchema = z.enum([
+    "likely_to_finish",
+    "hidden_gems",
+    "deep_systems",
+    "comfort_games",
+    "short_sessions",
+    "high_progression",
+]);
+// --- Tool output schemas ---------------------------------------------------
+export const PlayerOverviewSchema = z.object({
+    totalGames: z.number(),
+    wishlist: z.number(),
+    posts: z.number(),
+    devFollows: z.number(),
+    personaMatch: z.number(),
+    personaConfidence: z.string(),
+    currentObjective: z.string(),
+    summary: z.string(),
+});
+export const PlaystyleDnaSchema = z.object({
+    traits: z.array(z.object({ name: z.string(), score: z.number(), tier: TierSchema })),
+    uniqueEdge: z.string(),
+});
+export const PersonaCardsSchema = z.object({
+    personas: z.array(z.object({
+        name: z.string(),
+        rarity: RaritySchema,
+        level: z.number(),
+        progress: z.number(),
+        evidence: z.string(),
+    })),
+});
+export const ActivityPatternsSchema = z.object({
+    mostActiveHours: z.object({
+        peak: z.string(),
+        activeDays: z.string(),
+        type: z.string(),
+        insight: z.string(),
+    }),
+    sessionLength: z.object({
+        averageMinutes: z.number(),
+        under30Minutes: z.number(),
+        between30And90Minutes: z.number(),
+        between90And180Minutes: z.number(),
+        over180Minutes: z.number(),
+        sessionPersona: z.string(),
+    }),
+    platforms: z.array(z.object({ name: z.string(), hours: z.number(), share: z.number() })),
+    totalPlaytimeHours: z.number(),
+});
+export const CompletionBehaviorSchema = z.object({
+    completionRate: z.number(),
+    insight: z.string(),
+    strongCompletionCategories: z.array(z.string()),
+    weakCompletionCategories: z.array(z.string()),
+    dropOffSignals: z.array(z.string()),
+});
+export const PurchaseBehaviorSchema = z.object({
+    gamesPurchased: z.number(),
+    averageGamePrice: z.number(),
+    topInGameCategories: z.array(z.object({ category: z.string(), share: z.number() })),
+    insight: z.string(),
+    purchasePlayMismatch: z.object({
+        summary: z.string(),
+        example: z.string(),
+    }),
+    sensitiveSignals: z
+        .object({
+        recentPurchases: z.array(z.object({
+            title: z.string(),
+            price: z.number(),
+            hoursPlayed: z.number(),
+            refunded: z.boolean(),
+        })),
+        note: z.string(),
+    })
+        .optional(),
+});
+export const GenreMismatchResultSchema = z.object({
+    mismatches: z.array(z.object({
+        claimedOrPurchased: z.string(),
+        observedBehavior: z.string(),
+        confidence: z.number(),
+        completionSignal: z.string().optional(),
+        purchaseSignal: z.string().optional(),
+    })),
+    summary: z.string(),
+    signalsIncluded: z.object({
+        purchase: z.boolean(),
+        completion: z.boolean(),
+    }),
+});
+export const PlayerBehaviourAnalysisSchema = z.object({
+    summary: z.string(),
+    primaryTraits: z.array(z.string()),
+    weakSignals: z.array(z.string()).optional(),
+    behavioralEvidence: z.array(z.string()).optional(),
+    interpretation: z.string(),
+    deepDive: z
+        .object({
+        traitCorrelations: z.array(z.string()),
+        predictedPreferences: z.array(z.string()),
+        riskFactors: z.array(z.string()),
+    })
+        .optional(),
+});
+export const TastePatternSchema = z.object({
+    topic: z.string(),
+    explanation: z.string(),
+    supportingSignals: z.array(z.string()),
+    actionableAdvice: z.array(z.string()),
+});
+export const GameFitSchema = z.object({
+    game: z.string(),
+    platform: PlatformSchema,
+    fitScore: z.number(),
+    finishLikelihood: z.number(),
+    dropOffRisk: DropOffRiskSchema,
+    whyItFits: z.array(z.string()),
+    whyItMayNotFit: z.array(z.string()),
+    verdict: z.string(),
+});
+export const CompareResultSchema = z.object({
+    ranking: z.array(z.object({
+        game: z.string(),
+        fitScore: z.number(),
+        finishLikelihood: z.number(),
+        reason: z.string(),
+    })),
+    bestPick: z.string(),
+    summary: z.string(),
+});
+export const RecommendResultSchema = z.object({
+    objective: RecommendObjectiveSchema,
+    recommendations: z.array(z.object({
+        game: z.string(),
+        fitScore: z.number(),
+        reason: z.string(),
+        risk: DropOffRiskSchema,
+    })),
+    note: z.string(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "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).",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "snowbll-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "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"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "snowbll",
+    "gaming",
+    "behaviour-intelligence",
+    "ai-agents",
+    "playstyle",
+    "persona"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "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"
+  }
+}