hearthstone-oracle 0.1.0

package/dist/tools/analyze-deck.js

@@ -0,0 +1,159 @@
+import { z } from 'zod';
+import { decode } from 'deckstrings';
+import { classifyArchetype } from '../knowledge/archetype-classifier.js';
+// --- Input Schema ---
+export const AnalyzeDeckInput = z.object({
+    deck_code: z.string().describe('Hearthstone deck code (base64 deckstring)'),
+});
+// --- Helpers ---
+const HERO_CLASS_MAP = {
+    7: 'WARRIOR',
+    274: 'MAGE',
+    31: 'HUNTER',
+    637: 'PRIEST',
+    930: 'ROGUE',
+    1066: 'PALADIN',
+    671: 'WARLOCK',
+    813: 'SHAMAN',
+    893: 'DRUID',
+    56550: 'DEMON_HUNTER',
+    78065: 'DEATH_KNIGHT',
+};
+function manaCurveBucket(cost) {
+    if (cost == null)
+        return '0';
+    if (cost >= 7)
+        return '7+';
+    return String(cost);
+}
+function parseJson(raw) {
+    if (!raw)
+        return [];
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+export function analyzeDeck(db, input) {
+    // 1. Decode the deck
+    let decoded;
+    try {
+        decoded = decode(input.deck_code);
+    }
+    catch (err) {
+        return {
+            success: false,
+            message: `Invalid deck code: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // 2. Format
+    const format = decoded.format === 1 ? 'Wild' : 'Standard';
+    // 3. Hero class
+    let heroClass = 'UNKNOWN';
+    if (decoded.heroes.length > 0) {
+        const heroDbfId = decoded.heroes[0];
+        const heroRow = db
+            .prepare('SELECT player_class FROM cards WHERE id = ?')
+            .get(String(heroDbfId));
+        if (heroRow?.player_class) {
+            heroClass = heroRow.player_class;
+        }
+        else if (HERO_CLASS_MAP[heroDbfId]) {
+            heroClass = HERO_CLASS_MAP[heroDbfId];
+        }
+    }
+    // 4. Build card list and profile data
+    const deckCards = [];
+    const profileCards = [];
+    const manaCurve = {};
+    const typeDistribution = {};
+    let totalCards = 0;
+    let totalCost = 0;
+    let cardsWithCost = 0;
+    for (const [dbfId, count] of decoded.cards) {
+        const row = db
+            .prepare('SELECT * FROM cards WHERE id = ?')
+            .get(String(dbfId));
+        const name = row ? row.name : `Unknown Card (${dbfId})`;
+        const manaCost = row?.mana_cost ?? null;
+        const type = row?.type ?? null;
+        const text = row?.text ?? null;
+        const keywords = row?.keywords ?? null;
+        deckCards.push({ name, mana_cost: manaCost, count });
+        // Add profile cards (expand by count for classification)
+        for (let i = 0; i < count; i++) {
+            profileCards.push({ mana_cost: manaCost, type, text, keywords });
+        }
+        totalCards += count;
+        // Mana curve
+        const bucket = manaCurveBucket(manaCost);
+        manaCurve[bucket] = (manaCurve[bucket] ?? 0) + count;
+        // Type distribution
+        const cardType = type ?? 'UNKNOWN';
+        typeDistribution[cardType] = (typeDistribution[cardType] ?? 0) + count;
+        // Average cost tracking
+        if (manaCost != null) {
+            totalCost += manaCost * count;
+            cardsWithCost += count;
+        }
+    }
+    const avgCost = cardsWithCost > 0 ? totalCost / cardsWithCost : 0;
+    // 5. Build DeckProfile and classify
+    const profile = {
+        avg_cost: avgCost,
+        cards: profileCards,
+        total_cards: totalCards,
+        mana_curve: manaCurve,
+        type_distribution: typeDistribution,
+    };
+    const classification = classifyArchetype(profile);
+    // 6. Look up archetype info from strategy tables
+    let archetypeInfo;
+    const archetypeRow = db
+        .prepare('SELECT * FROM archetypes WHERE LOWER(name) = LOWER(?)')
+        .get(classification.archetype);
+    if (archetypeRow) {
+        archetypeInfo = {
+            description: archetypeRow.description,
+            gameplan: archetypeRow.gameplan,
+            strengths: parseJson(archetypeRow.strengths),
+            weaknesses: parseJson(archetypeRow.weaknesses),
+        };
+    }
+    // 7. Look up matchup expectations
+    let matchups;
+    const matchupRows = db
+        .prepare(`SELECT archetype_a, archetype_b, favoured, key_tension FROM matchup_framework
+       WHERE LOWER(archetype_a) = LOWER(?) OR LOWER(archetype_b) = LOWER(?)`)
+        .all(classification.archetype, classification.archetype);
+    if (matchupRows.length > 0) {
+        matchups = matchupRows
+            .filter((m) => m.archetype_a.toLowerCase() !== m.archetype_b.toLowerCase() ||
+            m.archetype_a.toLowerCase() !== classification.archetype.toLowerCase())
+            .map((m) => {
+            const isA = m.archetype_a.toLowerCase() === classification.archetype.toLowerCase();
+            return {
+                vs_archetype: isA ? m.archetype_b : m.archetype_a,
+                favoured: m.favoured,
+                key_tension: m.key_tension,
+            };
+        });
+    }
+    return {
+        success: true,
+        deck: {
+            format,
+            hero_class: heroClass,
+            cards: deckCards,
+            total_cards: totalCards,
+            mana_curve: manaCurve,
+            type_distribution: typeDistribution,
+        },
+        classification,
+        archetype_info: archetypeInfo,
+        matchups: matchups && matchups.length > 0 ? matchups : undefined,
+    };
+}
+//# sourceMappingURL=analyze-deck.js.map

package/dist/tools/analyze-deck.js.map

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

package/dist/tools/decode-deck.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 DecodeDeckInput: z.ZodObject<{
+    deck_code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    deck_code: string;
+}, {
+    deck_code: string;
+}>;
+export type DecodeDeckInputType = z.infer<typeof DecodeDeckInput>;
+export interface DecodeDeckSuccess {
+    success: true;
+    format: string;
+    hero_class: string;
+    cards: Array<{
+        card: CardSummary;
+        count: number;
+    }>;
+    total_cards: number;
+    mana_curve: Record<string, number>;
+    type_distribution: Record<string, number>;
+}
+export interface DecodeDeckError {
+    success: false;
+    message: string;
+}
+export type DecodeDeckResult = DecodeDeckSuccess | DecodeDeckError;
+export declare function decodeDeck(db: Database.Database, input: DecodeDeckInputType): DecodeDeckResult;
+//# sourceMappingURL=decode-deck.d.ts.map

package/dist/tools/decode-deck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-deck.d.ts","sourceRoot":"","sources":["../../src/tools/decode-deck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIlE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAmDnE,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,mBAAmB,GACzB,gBAAgB,CAiFlB"}

package/dist/tools/decode-deck.js

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { decode } from 'deckstrings';
+// --- Input Schema ---
+export const DecodeDeckInput = z.object({
+    deck_code: z.string().describe('Hearthstone deck code (base64 deckstring)'),
+});
+// --- 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),
+    };
+}
+function manaCurveBucket(cost) {
+    if (cost == null)
+        return '0';
+    if (cost >= 7)
+        return '7+';
+    return String(cost);
+}
+// --- Hero dbfId to class mapping (common heroes) ---
+const HERO_CLASS_MAP = {
+    7: 'WARRIOR', // Garrosh Hellscream
+    274: 'MAGE', // Jaina Proudmoore
+    31: 'HUNTER', // Rexxar
+    637: 'PRIEST', // Anduin Wrynn
+    930: 'ROGUE', // Valeera Sanguinar
+    1066: 'PALADIN', // Uther Lightbringer
+    671: 'WARLOCK', // Gul'dan
+    813: 'SHAMAN', // Thrall
+    893: 'DRUID', // Malfurion Stormrage
+    56550: 'DEMON_HUNTER', // Illidan Stormrage
+    78065: 'DEATH_KNIGHT', // The Lich King
+};
+// --- Handler ---
+export function decodeDeck(db, input) {
+    let decoded;
+    try {
+        decoded = decode(input.deck_code);
+    }
+    catch (err) {
+        return {
+            success: false,
+            message: `Invalid deck code: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // Format
+    const format = decoded.format === 1 ? 'Wild' : 'Standard';
+    // Hero class — try to look up hero in DB first, then fall back to map
+    let heroClass = 'UNKNOWN';
+    if (decoded.heroes.length > 0) {
+        const heroDbfId = decoded.heroes[0];
+        // Try DB lookup
+        const heroRow = db
+            .prepare('SELECT player_class FROM cards WHERE id = ?')
+            .get(String(heroDbfId));
+        if (heroRow?.player_class) {
+            heroClass = heroRow.player_class;
+        }
+        else if (HERO_CLASS_MAP[heroDbfId]) {
+            heroClass = HERO_CLASS_MAP[heroDbfId];
+        }
+    }
+    // Cards
+    const cards = [];
+    const manaCurve = {};
+    const typeDistribution = {};
+    let totalCards = 0;
+    for (const [dbfId, count] of decoded.cards) {
+        const row = db
+            .prepare('SELECT * FROM cards WHERE id = ?')
+            .get(String(dbfId));
+        let cardSummary;
+        if (row) {
+            cardSummary = toCardSummary(row);
+        }
+        else {
+            // Unknown card — create placeholder
+            cardSummary = {
+                name: `Unknown Card (${dbfId})`,
+                mana_cost: null,
+                type: null,
+                player_class: null,
+                rarity: null,
+                text: null,
+                attack: null,
+                health: null,
+                keywords: [],
+            };
+        }
+        cards.push({ card: cardSummary, count });
+        totalCards += count;
+        // Mana curve
+        const bucket = manaCurveBucket(cardSummary.mana_cost);
+        manaCurve[bucket] = (manaCurve[bucket] ?? 0) + count;
+        // Type distribution
+        const cardType = cardSummary.type ?? 'UNKNOWN';
+        typeDistribution[cardType] = (typeDistribution[cardType] ?? 0) + count;
+    }
+    return {
+        success: true,
+        format,
+        hero_class: heroClass,
+        cards,
+        total_cards: totalCards,
+        mana_curve: manaCurve,
+        type_distribution: typeDistribution,
+    };
+}
+//# sourceMappingURL=decode-deck.js.map

package/dist/tools/decode-deck.js.map

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

package/dist/tools/explain-concept.d.ts

@@ -0,0 +1,26 @@
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+export declare const ExplainConceptInput: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type ExplainConceptInputType = z.infer<typeof ExplainConceptInput>;
+export interface ConceptInfo {
+    name: string;
+    category: string;
+    description: string;
+    hearthstone_application: string;
+}
+export type ExplainConceptResult = {
+    found: true;
+    concept: ConceptInfo;
+} | {
+    found: false;
+    message: string;
+    suggestions?: string[];
+};
+export declare function explainConcept(db: Database.Database, input: ExplainConceptInputType): ExplainConceptResult;
+//# sourceMappingURL=explain-concept.d.ts.map

package/dist/tools/explain-concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-concept.d.ts","sourceRoot":"","sources":["../../src/tools/explain-concept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAI1E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,oBAAoB,GAC5B;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,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,uBAAuB,GAC7B,oBAAoB,CA8BtB"}

package/dist/tools/explain-concept.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+// --- Input Schema ---
+export const ExplainConceptInput = z.object({
+    name: z.string().describe('Game concept name (e.g. "tempo", "card advantage", "mana curve")'),
+});
+// --- Handler ---
+export function explainConcept(db, input) {
+    // Exact match (case-insensitive)
+    const row = db
+        .prepare('SELECT * FROM game_concepts WHERE LOWER(name) = LOWER(?)')
+        .get(input.name);
+    if (row) {
+        return {
+            found: true,
+            concept: {
+                name: row.name,
+                category: row.category,
+                description: row.description,
+                hearthstone_application: row.hearthstone_application,
+            },
+        };
+    }
+    // Not found — suggest similar entries via LIKE
+    const suggestions = db
+        .prepare('SELECT name FROM game_concepts WHERE LOWER(name) LIKE LOWER(?) LIMIT 5')
+        .all(`%${input.name}%`);
+    const suggestionNames = suggestions.map((s) => s.name);
+    return {
+        found: false,
+        message: `No game concept found matching "${input.name}".`,
+        suggestions: suggestionNames.length > 0 ? suggestionNames : undefined,
+    };
+}
+//# sourceMappingURL=explain-concept.js.map

package/dist/tools/explain-concept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-concept.js","sourceRoot":"","sources":["../../src/tools/explain-concept.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uBAAuB;AAEvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;CAC9F,CAAC,CAAC;AAiBH,kBAAkB;AAElB,MAAM,UAAU,cAAc,CAC5B,EAAqB,EACrB,KAA8B;IAE9B,iCAAiC;IACjC,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,0DAA0D,CAAC;SACnE,GAAG,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;IAE9C,IAAI,GAAG,EAAE,CAAC;QACR,OAAO;YACL,KAAK,EAAE,IAAI;YACX,OAAO,EAAE;gBACP,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,uBAAuB,EAAE,GAAG,CAAC,uBAAuB;aACrD;SACF,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,MAAM,WAAW,GAAG,EAAE;SACnB,OAAO,CAAC,wEAAwE,CAAC;SACjF,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAA4B,CAAC;IAErD,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEvD,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,mCAAmC,KAAK,CAAC,IAAI,IAAI;QAC1D,WAAW,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;KACtE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,29 @@
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+export declare const GetArchetypeInput: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type GetArchetypeInputType = z.infer<typeof GetArchetypeInput>;
+export interface ArchetypeInfo {
+    name: string;
+    description: string;
+    gameplan: string;
+    win_conditions: string[];
+    strengths: string[];
+    weaknesses: string[];
+    example_decks: string[];
+}
+export type GetArchetypeResult = {
+    found: true;
+    archetype: ArchetypeInfo;
+} | {
+    found: false;
+    message: string;
+    suggestions?: string[];
+};
+export declare function getArchetype(db: Database.Database, input: GetArchetypeInputType): GetArchetypeResult;
+//# sourceMappingURL=get-archetype.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-archetype.d.ts","sourceRoot":"","sources":["../../src/tools/get-archetype.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAItE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,GACzC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAyB9D,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,qBAAqB,GAC3B,kBAAkB,CAiCpB"}

package/dist/tools/get-archetype.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+// --- Input Schema ---
+export const GetArchetypeInput = z.object({
+    name: z.string().describe('Archetype name (e.g. "aggro", "control", "combo", "midrange", "tempo", "value")'),
+});
+// --- Helpers ---
+function parseJson(raw) {
+    if (!raw)
+        return [];
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+export function getArchetype(db, input) {
+    // 1. Exact match (case-insensitive)
+    const row = db
+        .prepare('SELECT * FROM archetypes WHERE LOWER(name) = LOWER(?)')
+        .get(input.name);
+    if (row) {
+        return {
+            found: true,
+            archetype: {
+                name: row.name,
+                description: row.description,
+                gameplan: row.gameplan,
+                win_conditions: parseJson(row.win_conditions),
+                strengths: parseJson(row.strengths),
+                weaknesses: parseJson(row.weaknesses),
+                example_decks: parseJson(row.example_decks),
+            },
+        };
+    }
+    // 2. Not found — suggest similar entries via LIKE
+    const suggestions = db
+        .prepare('SELECT name FROM archetypes WHERE LOWER(name) LIKE LOWER(?) LIMIT 5')
+        .all(`%${input.name}%`);
+    const suggestionNames = suggestions.map((s) => s.name);
+    return {
+        found: false,
+        message: `No archetype found matching "${input.name}".`,
+        suggestions: suggestionNames.length > 0 ? suggestionNames : undefined,
+    };
+}
+//# sourceMappingURL=get-archetype.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-archetype.js","sourceRoot":"","sources":["../../src/tools/get-archetype.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uBAAuB;AAEvB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iFAAiF,CAAC;CAC7G,CAAC,CAAC;AAoBH,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;AAcD,MAAM,UAAU,YAAY,CAC1B,EAAqB,EACrB,KAA4B;IAE5B,oCAAoC;IACpC,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,uDAAuD,CAAC;SAChE,GAAG,CAAC,KAAK,CAAC,IAAI,CAA6B,CAAC;IAE/C,IAAI,GAAG,EAAE,CAAC;QACR,OAAO;YACL,KAAK,EAAE,IAAI;YACX,SAAS,EAAE;gBACT,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC;gBAC7C,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;gBACnC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;gBACrC,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC;aAC5C;SACF,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,MAAM,WAAW,GAAG,EAAE;SACnB,OAAO,CAAC,qEAAqE,CAAC;SAC9E,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAA4B,CAAC;IAErD,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEvD,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,gCAAgC,KAAK,CAAC,IAAI,IAAI;QACvD,WAAW,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;KACtE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,13 @@
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+import type { GetCardResult } from '../format.js';
+export declare const GetCardInput: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type GetCardInputType = z.infer<typeof GetCardInput>;
+export declare function getCard(db: Database.Database, input: GetCardInputType): GetCardResult;
+//# sourceMappingURL=get-card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-card.d.ts","sourceRoot":"","sources":["../../src/tools/get-card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,cAAc,CAAC;AAI9D,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AA2C5D,wBAAgB,OAAO,CACrB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,gBAAgB,GACtB,aAAa,CAgCf"}

package/dist/tools/get-card.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+// --- Input Schema ---
+export const GetCardInput = z.object({
+    name: z.string().describe('Card name to look up (exact or partial match)'),
+});
+// --- Helper: parse keywords JSON ---
+function parseKeywords(raw) {
+    if (!raw)
+        return [];
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+// --- Helper: CardRow to CardDetail ---
+function toCardDetail(row) {
+    return {
+        id: row.id,
+        card_id: row.card_id,
+        name: row.name,
+        mana_cost: row.mana_cost,
+        type: row.type,
+        card_set: row.card_set,
+        set_name: row.set_name,
+        player_class: row.player_class,
+        rarity: row.rarity,
+        attack: row.attack,
+        health: row.health,
+        durability: row.durability,
+        armor: row.armor,
+        text: row.text,
+        flavor: row.flavor,
+        artist: row.artist,
+        collectible: row.collectible,
+        elite: row.elite,
+        race: row.race,
+        spell_school: row.spell_school,
+        keywords: parseKeywords(row.keywords),
+    };
+}
+// --- Handler ---
+export function getCard(db, input) {
+    // 1. Exact match (case-insensitive)
+    const exact = db
+        .prepare('SELECT * FROM cards WHERE LOWER(name) = LOWER(?)')
+        .get(input.name);
+    if (exact) {
+        return { found: true, card: toCardDetail(exact) };
+    }
+    // 2. Fuzzy match via LIKE
+    const fuzzy = db
+        .prepare('SELECT * FROM cards WHERE LOWER(name) LIKE LOWER(?)')
+        .get(`%${input.name}%`);
+    if (fuzzy) {
+        return { found: true, card: toCardDetail(fuzzy) };
+    }
+    // 3. Not found — provide suggestions based on first word
+    const firstWord = input.name.split(/\s+/)[0];
+    const suggestions = db
+        .prepare('SELECT name FROM cards WHERE LOWER(name) LIKE LOWER(?) LIMIT 5')
+        .all(`%${firstWord}%`);
+    const suggestionNames = suggestions.map((s) => s.name);
+    return {
+        found: false,
+        message: `No card found matching "${input.name}".`,
+        suggestions: suggestionNames.length > 0 ? suggestionNames : undefined,
+    };
+}
+//# sourceMappingURL=get-card.js.map

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

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

package/dist/tools/get-class-identity.d.ts

@@ -0,0 +1,43 @@
+import type Database from 'better-sqlite3';
+import { z } from 'zod';
+export declare const GetClassIdentityInput: z.ZodObject<{
+    class_name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    class_name?: string | undefined;
+}, {
+    class_name?: string | undefined;
+}>;
+export type GetClassIdentityInputType = z.infer<typeof GetClassIdentityInput>;
+export interface ClassIdentityInfo {
+    class: string;
+    identity: string;
+    hero_power_name: string;
+    hero_power_cost: number;
+    hero_power_effect: string;
+    hero_power_implications: string;
+    historical_archetypes: string[];
+    strengths: string[];
+    weaknesses: string[];
+    early_game: string;
+    mid_game: string;
+    late_game: string;
+}
+export interface ClassOverviewEntry {
+    class: string;
+    identity: string;
+    hero_power_name: string;
+}
+export type GetClassIdentityResult = {
+    found: true;
+    identity: ClassIdentityInfo;
+} | {
+    found: true;
+    overview: true;
+    classes: ClassOverviewEntry[];
+} | {
+    found: false;
+    message: string;
+    suggestions?: string[];
+};
+export declare function getClassIdentity(db: Database.Database, input: GetClassIdentityInputType): GetClassIdentityResult;
+//# sourceMappingURL=get-class-identity.d.ts.map

package/dist/tools/get-class-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-class-identity.d.ts","sourceRoot":"","sources":["../../src/tools/get-class-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB;;;;;;EAKhC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAI9E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,GAC5C;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,GAC9D;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA+C9D,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,yBAAyB,GAC/B,sBAAsB,CAsCxB"}