mcmodding-mcp 0.1.0

package/dist/services/search-utils.js

@@ -0,0 +1,239 @@
+const MINECRAFT_SYNONYMS = {
+    register: [
+        'registration',
+        'registering',
+        'create',
+        'add',
+        'define',
+        'declare',
+        'init',
+        'initialize',
+    ],
+    item: ['items', 'itemstack', 'tool', 'weapon', 'armor'],
+    block: ['blocks', 'blockstate', 'tile'],
+    entity: ['entities', 'mob', 'creature', 'living'],
+    create: ['make', 'build', 'generate', 'new', 'add', 'register'],
+    custom: ['custom', 'modded', 'new', 'own'],
+    add: ['adding', 'insert', 'include', 'register', 'create'],
+    mixin: ['mixins', 'injection', 'inject', 'hook', 'patch'],
+    event: ['events', 'listener', 'handler', 'callback', 'subscribe'],
+    network: ['networking', 'packet', 'packets', 'sync', 'synchronize', 's2c', 'c2s'],
+    render: ['rendering', 'renderer', 'draw', 'display', 'model', 'texture'],
+    data: ['datagen', 'data-generation', 'datapack', 'json', 'recipe', 'loot'],
+    fabric: ['fabricmc', 'fabric-api', 'fapi'],
+    entrypoint: ['entrypoints', 'initializer', 'mod-initializer', 'main', 'client', 'server'],
+    registry: ['registries', 'registered', 'identifier', 'id'],
+    blockentity: ['block-entity', 'tile-entity', 'tileentity', 'be'],
+    container: ['inventory', 'chest', 'storage', 'gui', 'screen', 'menu'],
+    recipe: ['recipes', 'crafting', 'smelting', 'cooking'],
+    loot: ['loottable', 'loot-table', 'drops', 'drop'],
+    tag: ['tags', 'tagging', 'itemtag', 'blocktag'],
+    sound: ['sounds', 'audio', 'music', 'sfx'],
+    particle: ['particles', 'effect', 'effects', 'fx'],
+    command: ['commands', 'cmd', 'brigadier', 'argument'],
+    keybind: ['keybinding', 'keybinds', 'key', 'hotkey', 'shortcut', 'input'],
+    world: ['level', 'dimension', 'worldgen', 'generation', 'biome'],
+    structure: ['structures', 'building', 'feature', 'worldgen'],
+};
+const CODE_PATTERNS = {
+    register: ['Registry.register', 'REGISTRY', 'Registries', 'RegistryKey'],
+    item: ['Item', 'ItemStack', 'Item.Settings', 'FabricItemSettings'],
+    block: ['Block', 'BlockState', 'Block.Settings', 'FabricBlockSettings'],
+    entity: ['Entity', 'LivingEntity', 'EntityType', 'FabricEntityTypeBuilder'],
+    blockentity: ['BlockEntity', 'BlockEntityType', 'FabricBlockEntityTypeBuilder'],
+    mixin: ['@Mixin', '@Inject', '@Redirect', '@ModifyVariable', 'CallbackInfo'],
+    event: ['Event', 'Callback', 'register()', 'ServerLifecycleEvents', 'ClientLifecycleEvents'],
+    network: ['PacketByteBuf', 'ServerPlayNetworking', 'ClientPlayNetworking', 'PayloadTypeRegistry'],
+    recipe: ['Recipe', 'RecipeSerializer', 'RecipeType', 'Ingredient'],
+    command: ['CommandRegistrationCallback', 'LiteralArgumentBuilder', 'RequiredArgumentBuilder'],
+    keybind: ['KeyBinding', 'KeyBindingHelper', 'GLFW'],
+    screen: ['Screen', 'HandledScreen', 'ScreenHandler', 'ContainerScreen'],
+    render: ['Renderer', 'RenderLayer', 'VertexConsumer', 'MatrixStack', 'DrawContext'],
+};
+export function tokenizeQuery(query) {
+    const original = query.trim();
+    const tokens = original
+        .toLowerCase()
+        .split(/[\s\-_.,;:!?()[\]{}'"]+/)
+        .filter((t) => t.length > 1)
+        .map((t) => t.replace(/[^a-z0-9]/g, ''));
+    const expandedSet = new Set();
+    for (const token of tokens) {
+        expandedSet.add(token);
+        if (MINECRAFT_SYNONYMS[token]) {
+            for (const syn of MINECRAFT_SYNONYMS[token]) {
+                expandedSet.add(syn);
+            }
+        }
+        for (const [key, synonyms] of Object.entries(MINECRAFT_SYNONYMS)) {
+            if (synonyms.includes(token)) {
+                expandedSet.add(key);
+                for (const syn of synonyms) {
+                    expandedSet.add(syn);
+                }
+            }
+        }
+    }
+    const expandedTokens = Array.from(expandedSet);
+    const ftsQuery = buildFtsQuery(tokens, expandedTokens);
+    const likePatterns = buildLikePatterns(tokens);
+    const codePatterns = getCodePatterns(tokens);
+    return {
+        original,
+        tokens,
+        expandedTokens,
+        ftsQuery,
+        likePatterns,
+        codePatterns,
+    };
+}
+function buildFtsQuery(tokens, expandedTokens) {
+    if (tokens.length === 0)
+        return '';
+    const uniqueTerms = Array.from(new Set([...tokens, ...expandedTokens]));
+    const validTerms = uniqueTerms
+        .filter((t) => t.length > 2)
+        .map((t) => t.replace(/['"]/g, ''))
+        .filter((t) => t.length > 0);
+    if (validTerms.length === 0) {
+        return tokens.map((t) => `"${t}"`).join(' OR ');
+    }
+    const parts = [];
+    if (tokens.length > 1) {
+        parts.push(`"${tokens.join(' ')}"`);
+    }
+    for (const term of validTerms) {
+        parts.push(term);
+    }
+    return parts.join(' OR ');
+}
+function buildLikePatterns(tokens) {
+    const patterns = [];
+    if (tokens.length > 0) {
+        patterns.push(`%${tokens.join('%')}%`);
+    }
+    for (const token of tokens) {
+        if (token.length > 2) {
+            patterns.push(`%${token}%`);
+        }
+    }
+    return patterns;
+}
+function getCodePatterns(tokens) {
+    const patterns = [];
+    for (const token of tokens) {
+        if (CODE_PATTERNS[token]) {
+            patterns.push(...CODE_PATTERNS[token]);
+        }
+        for (const [key, synonyms] of Object.entries(MINECRAFT_SYNONYMS)) {
+            if (synonyms.includes(token) && CODE_PATTERNS[key]) {
+                patterns.push(...CODE_PATTERNS[key]);
+            }
+        }
+    }
+    return Array.from(new Set(patterns));
+}
+export function calculateRelevanceScore(item, query) {
+    let score = 0;
+    const reasons = [];
+    const titleLower = (item.title || '').toLowerCase();
+    const headingLower = (item.section_heading || '').toLowerCase();
+    const contentLower = (item.content || item.section_content || '').toLowerCase();
+    const codeLower = (item.code || '').toLowerCase();
+    const captionLower = (item.caption || '').toLowerCase();
+    const categoryLower = (item.category || '').toLowerCase();
+    const urlLower = (item.url || '').toLowerCase();
+    const originalLower = query.original.toLowerCase();
+    if (titleLower.includes(originalLower)) {
+        score += 100;
+        reasons.push('exact phrase in title');
+    }
+    if (headingLower.includes(originalLower)) {
+        score += 80;
+        reasons.push('exact phrase in heading');
+    }
+    if (captionLower.includes(originalLower)) {
+        score += 70;
+        reasons.push('exact phrase in caption');
+    }
+    for (const token of query.tokens) {
+        if (token.length < 2)
+            continue;
+        if (titleLower.includes(token)) {
+            score += 20;
+            if (!reasons.includes('token in title'))
+                reasons.push('token in title');
+        }
+        if (headingLower.includes(token)) {
+            score += 18;
+            if (!reasons.includes('token in heading'))
+                reasons.push('token in heading');
+        }
+        if (captionLower.includes(token)) {
+            score += 15;
+            if (!reasons.includes('token in caption'))
+                reasons.push('token in caption');
+        }
+        if (urlLower.includes(token)) {
+            score += 12;
+            if (!reasons.includes('token in URL'))
+                reasons.push('token in URL');
+        }
+        if (categoryLower.includes(token)) {
+            score += 10;
+            if (!reasons.includes('token in category'))
+                reasons.push('token in category');
+        }
+        if (contentLower.includes(token)) {
+            score += 5;
+            if (!reasons.includes('token in content'))
+                reasons.push('token in content');
+        }
+    }
+    for (const pattern of query.codePatterns) {
+        if (codeLower.includes(pattern.toLowerCase())) {
+            score += 25;
+            if (!reasons.includes('code pattern match'))
+                reasons.push('code pattern match');
+        }
+    }
+    for (const token of query.expandedTokens) {
+        if (query.tokens.includes(token))
+            continue;
+        if (titleLower.includes(token) || headingLower.includes(token)) {
+            score += 8;
+            if (!reasons.includes('synonym match'))
+                reasons.push('synonym match');
+        }
+    }
+    if (item.code && item.code.length > 50) {
+        score += 10;
+        reasons.push('has substantial code');
+    }
+    return { score, reasons };
+}
+export function deduplicateAndRank(results, limit) {
+    const sorted = [...results].sort((a, b) => b.score - a.score);
+    const seen = new Set();
+    const deduplicated = [];
+    for (const result of sorted) {
+        let key;
+        if (result.item.code) {
+            key = result.item.code.substring(0, 200).replace(/\s+/g, ' ');
+        }
+        else {
+            key = `${result.item.url || ''}::${result.item.section_heading || ''}`;
+        }
+        if (!seen.has(key)) {
+            seen.add(key);
+            deduplicated.push(result);
+        }
+        if (deduplicated.length >= limit)
+            break;
+    }
+    return deduplicated;
+}
+export function normalizeScore(score, maxPossible = 200) {
+    return Math.min(100, Math.round((score / maxPossible) * 100));
+}
+//# sourceMappingURL=search-utils.js.map

package/dist/services/search-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-utils.js","sourceRoot":"","sources":["../../src/services/search-utils.ts"],"names":[],"mappings":"AAQA,MAAM,kBAAkB,GAA6B;IAEnD,QAAQ,EAAE;QACR,cAAc;QACd,aAAa;QACb,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,SAAS;QACT,MAAM;QACN,YAAY;KACb;IACD,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;IACvD,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC;IAGjD,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC;IAC/D,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;IAC1C,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC;IAG1D,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;IACzD,KAAK,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC;IACjE,OAAO,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC;IACjF,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;IACxE,IAAI,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;IAG1E,MAAM,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACzF,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,CAAC;IAG1D,WAAW,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC;IAChE,SAAS,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;IAGrE,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC;IACtD,IAAI,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC;IAClD,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;IAC/C,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;IAC1C,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC;IAGlD,OAAO,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC;IACrD,OAAO,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC;IAGzE,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC;IAChE,SAAS,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;CAC7D,CAAC;AAKF,MAAM,aAAa,GAA6B;IAC9C,QAAQ,EAAE,CAAC,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC;IACxE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,CAAC;IAClE,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,CAAC;IACvE,MAAM,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,yBAAyB,CAAC;IAC3E,WAAW,EAAE,CAAC,aAAa,EAAE,iBAAiB,EAAE,8BAA8B,CAAC;IAC/E,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,CAAC;IAC5E,KAAK,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,CAAC;IAC5F,OAAO,EAAE,CAAC,eAAe,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,CAAC;IACjG,MAAM,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,CAAC;IAClE,OAAO,EAAE,CAAC,6BAA6B,EAAE,wBAAwB,EAAE,yBAAyB,CAAC;IAC7F,OAAO,EAAE,CAAC,YAAY,EAAE,kBAAkB,EAAE,MAAM,CAAC;IACnD,MAAM,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;IACvE,MAAM,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,CAAC;CACpF,CAAC;AAcF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAG9B,MAAM,MAAM,GAAG,QAAQ;SACpB,WAAW,EAAE;SACb,KAAK,CAAC,yBAAyB,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;IAG3C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAGvB,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,MAAM,GAAG,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5C,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAGD,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACjE,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACrB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAG/C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAGvD,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAG/C,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO;QACL,QAAQ;QACR,MAAM;QACN,cAAc;QACd,QAAQ;QACR,YAAY;QACZ,YAAY;KACb,CAAC;AACJ,CAAC;AAMD,SAAS,aAAa,CAAC,MAAgB,EAAE,cAAwB;IAC/D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAInC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAGxE,MAAM,UAAU,GAAG,WAAW;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAE5B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAGD,MAAM,KAAK,GAAa,EAAE,CAAC;IAG3B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAGD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAKD,SAAS,iBAAiB,CAAC,MAAgB;IACzC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAG9B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAGD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAKD,SAAS,eAAe,CAAC,MAAgB;IACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,CAAC;QAGD,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACjE,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnD,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvC,CAAC;AAWD,MAAM,UAAU,uBAAuB,CACrC,IASC,EACD,KAAqB;IAErB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChF,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAGhD,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACnD,IAAI,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,KAAK,IAAI,GAAG,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,KAAK,IAAI,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,KAAK,IAAI,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;IAGD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAG/B,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,KAAK,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC1E,CAAC;QAGD,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,KAAK,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9E,CAAC;QAGD,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,KAAK,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9E,CAAC;QAGD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtE,CAAC;QAGD,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,KAAK,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChF,CAAC;QAGD,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAGD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC9C,KAAK,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAGD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAE3C,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/D,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAGD,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvC,KAAK,IAAI,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAKD,MAAM,UAAU,kBAAkB,CAEhC,OAA0B,EAAE,KAAa;IAEzC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAG9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,YAAY,GAAsB,EAAE,CAAC;IAE3C,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAE5B,IAAI,GAAW,CAAC;QAChB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAErB,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IAC1C,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAKD,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,cAAsB,GAAG;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/tools/explainConcept.d.ts

@@ -0,0 +1,9 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type ConceptExplanation } from '../services/concept-service.js';
+export interface ExplainConceptParams {
+    concept: string;
+}
+export declare function handleExplainConcept(params: ExplainConceptParams): Promise<CallToolResult>;
+export declare function getSuggestedConcepts(): string[];
+export type { ConceptExplanation };
+//# sourceMappingURL=explainConcept.d.ts.map

package/dist/tools/explainConcept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainConcept.d.ts","sourceRoot":"","sources":["../../src/tools/explainConcept.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwEhG;AAKD,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAuB/C;AAGD,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/tools/explainConcept.js

@@ -0,0 +1,93 @@
+import { ConceptService } from '../services/concept-service.js';
+let conceptServiceInstance = null;
+function getConceptService() {
+    if (!conceptServiceInstance) {
+        conceptServiceInstance = new ConceptService();
+    }
+    return conceptServiceInstance;
+}
+export async function handleExplainConcept(params) {
+    const { concept } = params;
+    if (!concept || typeof concept !== 'string' || concept.trim().length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Error: Concept parameter is required and cannot be empty.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    const trimmedConcept = concept.trim();
+    if (trimmedConcept.length > 100) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Error: Concept should be a concise term or phrase (max 100 characters). Examples: "mixins", "registry", "sided logic".',
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const service = getConceptService();
+        const explanation = await service.explainConcept(trimmedConcept);
+        const formattedOutput = service.formatForAI(explanation);
+        let suggestions = '';
+        if (explanation.metadata.sourcesUsed < 2) {
+            suggestions = '\n\n**Note:** Limited information found for this concept. ';
+            suggestions += 'Try:\n';
+            suggestions += '- Using a more common term (e.g., "mixin" instead of "bytecode injection")\n';
+            suggestions += '- Checking spelling\n';
+            suggestions += '- Using `search_fabric_docs` for broader search\n';
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: formattedOutput + suggestions,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`[explainConcept] Error: ${errorMessage}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error explaining concept: ${errorMessage}\n\nPlease ensure the documentation database has been indexed. Run 'npm run index-docs' to build the database.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+export function getSuggestedConcepts() {
+    return [
+        'mixin',
+        'registry',
+        'entrypoint',
+        'fabric.mod.json',
+        'sided logic',
+        'networking',
+        'blockentity',
+        'item',
+        'block',
+        'event',
+        'recipe',
+        'datagen',
+        'render',
+        'screen',
+        'command',
+        'tag',
+        'loot',
+        'sound',
+        'keybind',
+        'entity',
+    ];
+}
+//# sourceMappingURL=explainConcept.js.map

package/dist/tools/explainConcept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainConcept.js","sourceRoot":"","sources":["../../src/tools/explainConcept.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAA2B,MAAM,gCAAgC,CAAC;AAOzF,IAAI,sBAAsB,GAA0B,IAAI,CAAC;AAEzD,SAAS,iBAAiB;IACxB,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,sBAAsB,GAAG,IAAI,cAAc,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAA4B;IACrE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAG3B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,2DAA2D;iBAClE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAGtC,IAAI,cAAc,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wHAAwH;iBAC/H;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QAGpC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QAGjE,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAGzD,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YACzC,WAAW,GAAG,4DAA4D,CAAC;YAC3E,WAAW,IAAI,QAAQ,CAAC;YACxB,WAAW,IAAI,8EAA8E,CAAC;YAC9F,WAAW,IAAI,uBAAuB,CAAC;YACvC,WAAW,IAAI,mDAAmD,CAAC;QACrE,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,eAAe,GAAG,WAAW;iBACpC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO,CAAC,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;QAEzD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6BAA6B,YAAY,gHAAgH;iBAChK;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,OAAO;QACP,UAAU;QACV,YAAY;QACZ,iBAAiB;QACjB,aAAa;QACb,YAAY;QACZ,aAAa;QACb,MAAM;QACN,OAAO;QACP,OAAO;QACP,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,KAAK;QACL,MAAM;QACN,OAAO;QACP,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/tools/getExample.d.ts

@@ -0,0 +1,20 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export interface GetExampleParams {
+    topic: string;
+    language?: string;
+    loader?: string;
+    minecraftVersion?: string;
+    category?: string;
+    limit?: number;
+}
+export declare function handleGetExample(params: GetExampleParams): CallToolResult;
+export declare function getAvailableTopics(): {
+    categories: string[];
+    languages: Array<{
+        language: string;
+        count: number;
+    }>;
+    loaders: string[];
+    versions: string[];
+};
+//# sourceMappingURL=getExample.d.ts.map

package/dist/tools/getExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getExample.d.ts","sourceRoot":"","sources":["../../src/tools/getExample.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAuGzE;AAKD,wBAAgB,kBAAkB,IAAI;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAKA"}

package/dist/tools/getExample.js

@@ -0,0 +1,88 @@
+import { ExampleService } from '../services/example-service.js';
+export function handleGetExample(params) {
+    try {
+        const { topic, language = 'java', loader, minecraftVersion, category, limit = 5 } = params;
+        if (!topic || !topic.trim()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Error: Topic parameter is required. Please specify what you want examples for (e.g., "register item", "block entity", "networking").',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const exampleService = new ExampleService();
+        if (params.minecraftVersion === 'latest') {
+            params.minecraftVersion = exampleService.getLatestMinecraftVersion();
+        }
+        const finalLimit = Math.min(Math.max(limit, 1), 10);
+        console.error(`[get_example] Searching for: "${topic}" (${language}, limit: ${finalLimit})`);
+        const examples = exampleService.getExamples({
+            topic,
+            language,
+            loader,
+            minecraftVersion,
+            category,
+            limit: finalLimit,
+        });
+        if (examples.length === 0) {
+            exampleService.close();
+            let message = `No code examples found for "${topic}"`;
+            if (language !== 'java') {
+                message += ` in ${language}`;
+            }
+            if (loader) {
+                message += ` for ${loader}`;
+            }
+            if (minecraftVersion) {
+                message += ` (version ${minecraftVersion})`;
+            }
+            message += '.\n\n**Suggestions:**\n';
+            message +=
+                '- Try using more general search terms (e.g., "item" instead of "custom item registration")\n';
+            message += '- Remove version or loader filters\n';
+            message += '- Check if the topic is covered in the Fabric documentation\n';
+            message += '- Try searching with the `search_fabric_docs` tool first\n';
+            console.error(`[get_example] No results found for "${topic}"`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: message,
+                    },
+                ],
+            };
+        }
+        const formattedOutput = exampleService.formatForAI(examples);
+        exampleService.close();
+        console.error(`[get_example] Returning ${examples.length} example(s) for "${topic}"`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: formattedOutput,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        console.error('[get_example] Error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error retrieving examples: ${error instanceof Error ? error.message : 'Unknown error'}\n\nThe documentation database may not be initialized. Please ensure the indexer has been run with \`npm run index-docs\`.`,
+                },
+            ],
+        };
+    }
+}
+export function getAvailableTopics() {
+    const exampleService = new ExampleService();
+    const topics = exampleService.getAvailableTopics();
+    exampleService.close();
+    return topics;
+}
+//# sourceMappingURL=getExample.js.map

package/dist/tools/getExample.js.map

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

package/dist/tools/getMinecraftVersion.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export interface GetMinecraftVersionParams {
+    type?: 'latest' | 'all';
+}
+export declare function handleGetMinecraftVersion(params: GetMinecraftVersionParams): CallToolResult;
+//# sourceMappingURL=getMinecraftVersion.d.ts.map

package/dist/tools/getMinecraftVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMinecraftVersion.d.ts","sourceRoot":"","sources":["../../src/tools/getMinecraftVersion.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CACzB;AAMD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CA+D3F"}

package/dist/tools/getMinecraftVersion.js

@@ -0,0 +1,57 @@
+import { ExampleService } from '../services/example-service.js';
+export function handleGetMinecraftVersion(params) {
+    try {
+        const exampleService = new ExampleService();
+        const { type = 'latest' } = params;
+        if (type === 'all') {
+            const topics = exampleService.getAvailableTopics();
+            exampleService.close();
+            if (topics.versions.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No Minecraft versions found in the indexed documentation. Please run the indexer first.',
+                        },
+                    ],
+                };
+            }
+            let output = `## Available Minecraft Versions\n\n`;
+            output += `Found ${topics.versions.length} version(s) in the documentation:\n\n`;
+            for (const version of topics.versions) {
+                output += `- ${version}\n`;
+            }
+            output += `\n**Latest:** ${topics.versions[0] || 'unknown'}\n`;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output,
+                    },
+                ],
+            };
+        }
+        const latestVersion = exampleService.getLatestMinecraftVersion();
+        exampleService.close();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `The latest Minecraft version in the documentation is: **${latestVersion}**`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        console.error('[get_minecraft_version] Error:', error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error retrieving Minecraft version: ${error instanceof Error ? error.message : 'Unknown error'}\n\nThe documentation database may not be initialized.`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=getMinecraftVersion.js.map

package/dist/tools/getMinecraftVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMinecraftVersion.js","sourceRoot":"","sources":["../../src/tools/getMinecraftVersion.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAWhE,MAAM,UAAU,yBAAyB,CAAC,MAAiC;IACzE,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;QAC5C,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC;QAEnC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,cAAc,CAAC,kBAAkB,EAAE,CAAC;YACnD,cAAc,CAAC,KAAK,EAAE,CAAC;YAEvB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,yFAAyF;yBAChG;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,GAAG,qCAAqC,CAAC;YACnD,MAAM,IAAI,SAAS,MAAM,CAAC,QAAQ,CAAC,MAAM,uCAAuC,CAAC;YAEjF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,OAAO,IAAI,CAAC;YAC7B,CAAC;YAED,MAAM,IAAI,iBAAiB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,IAAI,CAAC;YAE/D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;QAGD,MAAM,aAAa,GAAG,cAAc,CAAC,yBAAyB,EAAE,CAAC;QACjE,cAAc,CAAC,KAAK,EAAE,CAAC;QAEvB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,2DAA2D,aAAa,IAAI;iBACnF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,wDAAwD;iBAC9J;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/searchDocs.d.ts

@@ -0,0 +1,15 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { SearchResult } from '../services/search-service.js';
+export interface SearchDocsParams {
+    query: string;
+    category?: string;
+    loader?: string;
+    minecraftVersion?: string;
+    includeCode?: boolean;
+    limit?: number;
+}
+export declare function handleSearchDocs(params: SearchDocsParams): Promise<CallToolResult>;
+export declare function searchDocs(params: SearchDocsParams): Promise<SearchResult[]>;
+export declare function getAvailableCategories(): string[];
+export declare function getAvailableLoaders(): string[];
+//# sourceMappingURL=searchDocs.d.ts.map

package/dist/tools/searchDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchDocs.d.ts","sourceRoot":"","sources":["../../src/tools/searchDocs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,+BAA+B,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA6FxF;AAqDD,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAQlF;AAKD,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAcjD;AAKD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}