hearthstone-oracle 0.1.0

package/dist/tools/get-class-identity.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+// --- Input Schema ---
+export const GetClassIdentityInput = z.object({
+    class_name: z
+        .string()
+        .optional()
+        .describe('Class name (e.g. "Mage", "Warrior"). Omit to get an overview of all classes.'),
+});
+// --- Helpers ---
+function parseJson(raw) {
+    if (!raw)
+        return [];
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+function toClassIdentityInfo(row) {
+    return {
+        class: row.class,
+        identity: row.identity,
+        hero_power_name: row.hero_power_name,
+        hero_power_cost: row.hero_power_cost,
+        hero_power_effect: row.hero_power_effect,
+        hero_power_implications: row.hero_power_implications,
+        historical_archetypes: parseJson(row.historical_archetypes),
+        strengths: parseJson(row.strengths),
+        weaknesses: parseJson(row.weaknesses),
+        early_game: row.early_game,
+        mid_game: row.mid_game,
+        late_game: row.late_game,
+    };
+}
+export function getClassIdentity(db, input) {
+    // If no class_name provided, return overview of all classes
+    if (!input.class_name) {
+        const rows = db
+            .prepare('SELECT class, identity, hero_power_name FROM class_identities ORDER BY class')
+            .all();
+        return {
+            found: true,
+            overview: true,
+            classes: rows,
+        };
+    }
+    // Single class lookup (case-insensitive)
+    const row = db
+        .prepare('SELECT * FROM class_identities WHERE LOWER(class) = LOWER(?)')
+        .get(input.class_name);
+    if (row) {
+        return {
+            found: true,
+            identity: toClassIdentityInfo(row),
+        };
+    }
+    // Not found — suggest similar entries via LIKE
+    const suggestions = db
+        .prepare('SELECT class FROM class_identities WHERE LOWER(class) LIKE LOWER(?) LIMIT 5')
+        .all(`%${input.class_name}%`);
+    const suggestionNames = suggestions.map((s) => s.class);
+    return {
+        found: false,
+        message: `No class found matching "${input.class_name}".`,
+        suggestions: suggestionNames.length > 0 ? suggestionNames : undefined,
+    };
+}
+//# sourceMappingURL=get-class-identity.js.map

package/dist/tools/get-class-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-class-identity.js","sourceRoot":"","sources":["../../src/tools/get-class-identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uBAAuB;AAEvB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC;AAgCH,kBAAkB;AAElB,SAAS,SAAS,CAAC,GAAkB;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAmBD,SAAS,mBAAmB,CAAC,GAAqB;IAChD,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;QACxC,uBAAuB,EAAE,GAAG,CAAC,uBAAuB;QACpD,qBAAqB,EAAE,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAC3D,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;QACnC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;QACrC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,EAAqB,EACrB,KAAgC;IAEhC,4DAA4D;IAC5D,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,EAAE;aACZ,OAAO,CAAC,8EAA8E,CAAC;aACvF,GAAG,EAA0B,CAAC;QAEjC,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,8DAA8D,CAAC;SACvE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAiC,CAAC;IAEzD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,mBAAmB,CAAC,GAAG,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,MAAM,WAAW,GAAG,EAAE;SACnB,OAAO,CAAC,6EAA6E,CAAC;SACtF,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,GAAG,CAA6B,CAAC;IAE5D,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAExD,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,4BAA4B,KAAK,CAAC,UAAU,IAAI;QACzD,WAAW,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;KACtE,CAAC;AACJ,CAAC"}

package/dist/tools/get-keyword.d.ts

@@ -0,0 +1,30 @@
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+import type { CardSummary } from '../format.js';
+export declare const GetKeywordInput: z.ZodObject<{
+    name: z.ZodString;
+    player_class: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    player_class?: string | undefined;
+}, {
+    name: string;
+    player_class?: string | undefined;
+}>;
+export type GetKeywordInputType = z.infer<typeof GetKeywordInput>;
+export interface KeywordInfo {
+    name: string;
+    description: string;
+    related_keywords: string[];
+}
+export type GetKeywordResult = {
+    found: true;
+    keyword: KeywordInfo;
+    cards: CardSummary[];
+} | {
+    found: false;
+    message: string;
+    suggestions?: string[];
+};
+export declare function getKeyword(db: Database.Database, input: GetKeywordInputType): GetKeywordResult;
+//# sourceMappingURL=get-keyword.d.ts.map

package/dist/tools/get-keyword.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-keyword.d.ts","sourceRoot":"","sources":["../../src/tools/get-keyword.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,eAAe;;;;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIlE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,GAC3D;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA6B9D,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,mBAAmB,GACzB,gBAAgB,CA8DlB"}

package/dist/tools/get-keyword.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+// --- Input Schema ---
+export const GetKeywordInput = z.object({
+    name: z.string().describe('Keyword name (e.g. "Deathrattle", "Battlecry")'),
+    player_class: z
+        .string()
+        .optional()
+        .describe('Filter related cards by class (e.g. MAGE, WARRIOR)'),
+});
+// --- Helpers ---
+function parseJson(raw) {
+    if (!raw)
+        return [];
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+function toCardSummary(row) {
+    return {
+        name: row.name,
+        mana_cost: row.mana_cost,
+        type: row.type,
+        player_class: row.player_class,
+        rarity: row.rarity,
+        text: row.text ? row.text.split('\n')[0] : null,
+        attack: row.attack,
+        health: row.health,
+        keywords: parseJson(row.keywords),
+    };
+}
+// --- Handler ---
+export function getKeyword(db, input) {
+    // 1. Look up keyword in keywords table (case-insensitive)
+    const keywordRow = db
+        .prepare('SELECT * FROM keywords WHERE LOWER(name) = LOWER(?)')
+        .get(input.name);
+    // 2. Find cards that have this keyword in their keywords JSON
+    // The keywords JSON stores mechanics like "BATTLECRY", "TAUNT", etc.
+    // We search case-insensitively by upper-casing the keyword and replacing spaces with underscores
+    const mechanicName = input.name.toUpperCase().replace(/\s+/g, '_');
+    let cardSql = `SELECT * FROM cards WHERE keywords LIKE ? AND collectible = 1`;
+    const cardParams = [`%${mechanicName}%`];
+    if (input.player_class) {
+        cardSql += ' AND UPPER(player_class) = UPPER(?)';
+        cardParams.push(input.player_class);
+    }
+    cardSql += ' ORDER BY name LIMIT 25';
+    const cardRows = db.prepare(cardSql).all(...cardParams);
+    const cards = cardRows.map(toCardSummary);
+    // 3. If keyword found in table, return it with cards
+    if (keywordRow) {
+        return {
+            found: true,
+            keyword: {
+                name: keywordRow.name,
+                description: keywordRow.description,
+                related_keywords: parseJson(keywordRow.related_keywords),
+            },
+            cards,
+        };
+    }
+    // 4. If keyword not in table but we found cards with it, still return found
+    if (cards.length > 0) {
+        return {
+            found: true,
+            keyword: {
+                name: input.name,
+                description: `Cards with the ${input.name} mechanic.`,
+                related_keywords: [],
+            },
+            cards,
+        };
+    }
+    // 5. Not found — provide suggestions via LIKE match on partial name
+    const suggestions = db
+        .prepare('SELECT name FROM keywords WHERE LOWER(name) LIKE LOWER(?) LIMIT 5')
+        .all(`%${input.name}%`);
+    const suggestionNames = suggestions.map((s) => s.name);
+    return {
+        found: false,
+        message: `No keyword found matching "${input.name}".`,
+        suggestions: suggestionNames.length > 0 ? suggestionNames : undefined,
+    };
+}
+//# sourceMappingURL=get-keyword.js.map

package/dist/tools/get-keyword.js.map

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

package/dist/tools/get-matchup.d.ts

@@ -0,0 +1,32 @@
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+export declare const GetMatchupInput: z.ZodObject<{
+    archetype_a: z.ZodString;
+    archetype_b: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    archetype_a: string;
+    archetype_b: string;
+}, {
+    archetype_a: string;
+    archetype_b: string;
+}>;
+export type GetMatchupInputType = z.infer<typeof GetMatchupInput>;
+export interface MatchupInfo {
+    archetype_a: string;
+    archetype_b: string;
+    favoured: string;
+    reasoning: string;
+    key_tension: string;
+    archetype_a_priority: string;
+    archetype_b_priority: string;
+}
+export type GetMatchupResult = {
+    found: true;
+    matchup: MatchupInfo;
+} | {
+    found: false;
+    message: string;
+    suggestions?: string[];
+};
+export declare function getMatchup(db: Database.Database, input: GetMatchupInputType): GetMatchupResult;
+//# sourceMappingURL=get-matchup.d.ts.map

package/dist/tools/get-matchup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-matchup.d.ts","sourceRoot":"","sources":["../../src/tools/get-matchup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIlE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAI9D,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,mBAAmB,GACzB,gBAAgB,CAsClB"}

package/dist/tools/get-matchup.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+// --- Input Schema ---
+export const GetMatchupInput = z.object({
+    archetype_a: z.string().describe('First archetype name (e.g. "aggro", "control")'),
+    archetype_b: z.string().describe('Second archetype name (e.g. "combo", "midrange")'),
+});
+// --- Handler ---
+export function getMatchup(db, input) {
+    // Check both orderings since the table stores one direction
+    const row = db
+        .prepare(`SELECT * FROM matchup_framework WHERE
+        (LOWER(archetype_a) = LOWER(?) AND LOWER(archetype_b) = LOWER(?))
+        OR
+        (LOWER(archetype_a) = LOWER(?) AND LOWER(archetype_b) = LOWER(?))`)
+        .get(input.archetype_a, input.archetype_b, input.archetype_b, input.archetype_a);
+    if (row) {
+        return {
+            found: true,
+            matchup: {
+                archetype_a: row.archetype_a,
+                archetype_b: row.archetype_b,
+                favoured: row.favoured,
+                reasoning: row.reasoning,
+                key_tension: row.key_tension,
+                archetype_a_priority: row.archetype_a_priority,
+                archetype_b_priority: row.archetype_b_priority,
+            },
+        };
+    }
+    // Not found — suggest available archetypes
+    const archetypes = db
+        .prepare('SELECT DISTINCT archetype_a FROM matchup_framework UNION SELECT DISTINCT archetype_b FROM matchup_framework')
+        .all();
+    const availableNames = archetypes.map((a) => a.archetype_a);
+    return {
+        found: false,
+        message: `No matchup found for "${input.archetype_a}" vs "${input.archetype_b}".`,
+        suggestions: availableNames.length > 0 ? availableNames : undefined,
+    };
+}
+//# sourceMappingURL=get-matchup.js.map

package/dist/tools/get-matchup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-matchup.js","sourceRoot":"","sources":["../../src/tools/get-matchup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uBAAuB;AAEvB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAClF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACrF,CAAC,CAAC;AAoBH,kBAAkB;AAElB,MAAM,UAAU,UAAU,CACxB,EAAqB,EACrB,KAA0B;IAE1B,4DAA4D;IAC5D,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;;;0EAGoE,CACrE;SACA,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAA4B,CAAC;IAE9G,IAAI,GAAG,EAAE,CAAC;QACR,OAAO;YACL,KAAK,EAAE,IAAI;YACX,OAAO,EAAE;gBACP,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;gBAC9C,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;aAC/C;SACF,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,UAAU,GAAG,EAAE;SAClB,OAAO,CAAC,6GAA6G,CAAC;SACtH,GAAG,EAAoC,CAAC;IAE3C,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAE5D,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,yBAAyB,KAAK,CAAC,WAAW,SAAS,KAAK,CAAC,WAAW,IAAI;QACjF,WAAW,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;KACpE,CAAC;AACJ,CAAC"}

package/dist/tools/search-cards.d.ts

@@ -0,0 +1,43 @@
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+import type { SearchCardsResult } from '../format.js';
+export declare const SearchCardsInput: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    player_class: z.ZodOptional<z.ZodString>;
+    mana_cost: z.ZodOptional<z.ZodNumber>;
+    cost_op: z.ZodDefault<z.ZodOptional<z.ZodEnum<["eq", "lt", "lte", "gt", "gte"]>>>;
+    type: z.ZodOptional<z.ZodString>;
+    rarity: z.ZodOptional<z.ZodString>;
+    card_set: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    race: z.ZodOptional<z.ZodString>;
+    collectible_only: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    cost_op: "eq" | "lt" | "lte" | "gt" | "gte";
+    collectible_only: boolean;
+    limit: number;
+    player_class?: string | undefined;
+    type?: string | undefined;
+    keyword?: string | undefined;
+    query?: string | undefined;
+    mana_cost?: number | undefined;
+    rarity?: string | undefined;
+    card_set?: string | undefined;
+    race?: string | undefined;
+}, {
+    player_class?: string | undefined;
+    type?: string | undefined;
+    keyword?: string | undefined;
+    query?: string | undefined;
+    mana_cost?: number | undefined;
+    cost_op?: "eq" | "lt" | "lte" | "gt" | "gte" | undefined;
+    rarity?: string | undefined;
+    card_set?: string | undefined;
+    race?: string | undefined;
+    collectible_only?: boolean | undefined;
+    limit?: number | undefined;
+}>;
+export type SearchCardsInputType = z.infer<typeof SearchCardsInput>;
+export declare function searchCards(db: Database.Database, input: SearchCardsInputType): SearchCardsResult;
+//# sourceMappingURL=search-cards.d.ts.map

package/dist/tools/search-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-cards.d.ts","sourceRoot":"","sources":["../../src/tools/search-cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAInE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkD3B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAgCpE,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,oBAAoB,GAC1B,iBAAiB,CAyGnB"}

package/dist/tools/search-cards.js

@@ -0,0 +1,167 @@
+import { z } from 'zod';
+// --- Input Schema ---
+export const SearchCardsInput = z.object({
+    query: z
+        .string()
+        .optional()
+        .describe('Free-text search across card name and text (uses FTS5)'),
+    player_class: z
+        .string()
+        .optional()
+        .describe('Filter by class (e.g. MAGE, WARRIOR, NEUTRAL)'),
+    mana_cost: z
+        .number()
+        .optional()
+        .describe('Filter by mana cost (combine with cost_op for range queries)'),
+    cost_op: z
+        .enum(['eq', 'lt', 'lte', 'gt', 'gte'])
+        .optional()
+        .default('eq')
+        .describe('Cost comparison operator: eq, lt, lte, gt, gte (default: eq)'),
+    type: z
+        .string()
+        .optional()
+        .describe('Filter by card type: MINION, SPELL, WEAPON, HERO, LOCATION'),
+    rarity: z
+        .string()
+        .optional()
+        .describe('Filter by rarity: FREE, COMMON, RARE, EPIC, LEGENDARY'),
+    card_set: z
+        .string()
+        .optional()
+        .describe('Filter by set code (e.g. CORE, CLASSIC, LOE)'),
+    keyword: z
+        .string()
+        .optional()
+        .describe('Filter by keyword in keywords JSON (e.g. BATTLECRY, TAUNT, CHARGE)'),
+    race: z
+        .string()
+        .optional()
+        .describe('Filter by minion race/tribe (e.g. BEAST, DRAGON, MURLOC)'),
+    collectible_only: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Only return collectible cards (default: true)'),
+    limit: z
+        .number()
+        .min(1)
+        .max(50)
+        .optional()
+        .default(25)
+        .describe('Max results to return, 1-50 (default: 25)'),
+});
+// --- Cost operator mapping ---
+const COST_OPS = {
+    eq: '=',
+    lt: '<',
+    lte: '<=',
+    gt: '>',
+    gte: '>=',
+};
+// --- Helper: parse keywords JSON ---
+function parseKeywords(raw) {
+    if (!raw)
+        return [];
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+// --- Helper: first line preview ---
+function textPreview(text) {
+    if (!text)
+        return null;
+    return text.split('\n')[0];
+}
+// --- Handler ---
+export function searchCards(db, input) {
+    const params = [];
+    const conditions = [];
+    const useFts = !!input.query;
+    // Collectible filter
+    if (input.collectible_only !== false) {
+        conditions.push('c.collectible = 1');
+    }
+    // Class filter
+    if (input.player_class) {
+        conditions.push('UPPER(c.player_class) = UPPER(?)');
+        params.push(input.player_class);
+    }
+    // Cost filter
+    if (input.mana_cost != null) {
+        const op = COST_OPS[input.cost_op ?? 'eq'] ?? '=';
+        conditions.push(`c.mana_cost ${op} ?`);
+        params.push(input.mana_cost);
+    }
+    // Type filter
+    if (input.type) {
+        conditions.push('UPPER(c.type) = UPPER(?)');
+        params.push(input.type);
+    }
+    // Rarity filter
+    if (input.rarity) {
+        conditions.push('UPPER(c.rarity) = UPPER(?)');
+        params.push(input.rarity);
+    }
+    // Set filter
+    if (input.card_set) {
+        conditions.push('UPPER(c.card_set) = UPPER(?)');
+        params.push(input.card_set);
+    }
+    // Keyword filter (search in JSON string)
+    if (input.keyword) {
+        conditions.push("c.keywords LIKE '%' || ? || '%'");
+        params.push(input.keyword);
+    }
+    // Race filter
+    if (input.race) {
+        conditions.push('UPPER(c.race) = UPPER(?)');
+        params.push(input.race);
+    }
+    const limit = input.limit ?? 25;
+    let sql;
+    const allParams = [];
+    if (useFts) {
+        // FTS5 query
+        allParams.push(input.query);
+        allParams.push(...params);
+        allParams.push(limit);
+        const whereClause = conditions.length > 0 ? ' AND ' + conditions.join(' AND ') : '';
+        sql = `
+      SELECT c.* FROM cards_fts fts
+      JOIN cards c ON c.rowid = fts.rowid
+      WHERE cards_fts MATCH ?${whereClause}
+      ORDER BY fts.rank
+      LIMIT ?
+    `;
+    }
+    else {
+        // Regular query
+        allParams.push(...params);
+        allParams.push(limit);
+        const whereClause = conditions.length > 0 ? 'WHERE ' + conditions.join(' AND ') : '';
+        sql = `
+      SELECT c.* FROM cards c
+      ${whereClause}
+      ORDER BY c.name
+      LIMIT ?
+    `;
+    }
+    const rows = db.prepare(sql).all(...allParams);
+    const cards = rows.map((row) => ({
+        name: row.name,
+        mana_cost: row.mana_cost,
+        type: row.type,
+        player_class: row.player_class,
+        rarity: row.rarity,
+        text: textPreview(row.text),
+        attack: row.attack,
+        health: row.health,
+        keywords: parseKeywords(row.keywords),
+    }));
+    return { cards, total: cards.length };
+}
+//# sourceMappingURL=search-cards.js.map

package/dist/tools/search-cards.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "hearthstone-oracle",
+  "version": "0.1.0",
+  "description": "Hearthstone MCP server with card search, deck analysis, and strategy coaching",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/server.js",
+  "bin": {
+    "hearthstone-oracle": "dist/server.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts.map",
+    "dist/data/schema.sql"
+  ],
+  "scripts": {
+    "build": "tsc && cp src/data/schema.sql dist/data/schema.sql && chmod +x dist/server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/server.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "better-sqlite3": "^12.8.0",
+    "deckstrings": "^2.2.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "mcpName": "io.github.gregario/hearthstone-oracle",
+  "keywords": [
+    "mcp",
+    "hearthstone",
+    "card-game",
+    "strategy",
+    "deck-analysis",
+    "claude",
+    "ai"
+  ]
+}