mne-docs-mcp 1.0.48 → 1.0.49

package/dist/tools/getMneExample.js

@@ -1,9 +1,12 @@
 import { z } from 'zod';
 import { McpError } from '../types.js';
 import { getLogger } from '../utils/logger.js';
-import { MNE_PACKAGE_NAMES, packageSchema } from '../config.js';
+import { packageSchema } from '../config.js';
 import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
 import { stripRst } from '../utils/docstring.js';
+import { rankSearchMatch } from '../utils/searchRanking.js';
+import { buildGithubRequestBudget } from './requestBudget.js';
+import { defineTool } from './defineTool.js';
 const logger = getLogger();
 function getNoExamplesSuggestion(pkg) {
     if (pkg === 'mne-python') {
@@ -37,27 +40,20 @@ function getFallbackExamplePaths(query, pkg) {
     return Array.from(new Set(paths));
 }
 const GetMneExampleParamsSchema = z.object({
-    query: z.string().trim().min(1, 'Query is required'),
-    maxResults: z.number().int().min(1).max(20).optional().default(5),
-    version: z.string().optional(),
-    summaryOnly: z.boolean().optional().default(false),
-    maxCodeLines: z.number().int().min(1).max(1000).optional().default(100),
-    package: z.enum(MNE_PACKAGE_NAMES).optional(),
+    query: z.string().trim().min(1, 'Query is required').describe('Topic to search, e.g. "epochs", "ICA", "evoked", "source estimation"'),
+    maxResults: z.number().int().min(1).max(20).optional().default(5).describe('Max examples to return (default: 5)'),
+    version: z.string().optional().describe('Version tag (default: latest)'),
+    summaryOnly: z.boolean().optional().default(false).describe('Return only titles and descriptions, no code (default: false)'),
+    maxCodeLines: z.number().int().min(1).max(1000).optional().default(100).describe('Truncate code to N lines (default: 100)'),
+    package: packageSchema,
 });
-export const definition = {
+export const definition = defineTool({
     name: 'get_mne_example',
     title: 'Get MNE Example',
     description: 'Get tutorial and example code from the MNE gallery. Use when users want to see working code for a specific task like "ICA", "source localization", or "time-frequency analysis".',
-    inputSchema: {
-        query: z.string().describe('Topic to search, e.g. "epochs", "ICA", "evoked", "source estimation"'),
-        maxResults: z.number().optional().describe('Max examples to return (default: 5)'),
-        version: z.string().optional().describe('Version tag (default: latest)'),
-        summaryOnly: z.boolean().optional().describe('Return only titles and descriptions, no code (default: false)'),
-        maxCodeLines: z.number().optional().describe('Truncate code to N lines (default: 100)'),
-        package: packageSchema,
-    },
+    paramsSchema: GetMneExampleParamsSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
-};
+});
 /**
  * Fetches complete example/tutorial scripts from the MNE gallery.
  * Returns full Python code with explanations.
@@ -116,6 +112,14 @@ export async function getMneExample(params, context) {
             const totalLines = lines.length;
             const sourceUrl = context.repoContent.sourceUrl(target, item.path);
             const docsUrl = buildExampleDocsUrl(item.path, packageInfo.docsUrl);
+            const ranking = rankSearchMatch({
+                query,
+                kind: 'example',
+                title: metadata.title || formatTitle(item.name),
+                path: item.path,
+                snippet: `${item.snippet || ''}\n${metadata.description || ''}`,
+                tags: metadata.tags,
+            });
             if (summaryOnly) {
                 return {
                     title: metadata.title || formatTitle(item.name),
@@ -128,6 +132,9 @@ export async function getMneExample(params, context) {
                     totalLines,
                     estimatedRunTime: metadata.runTime,
                     tags: metadata.tags,
+                    score: ranking.score,
+                    matchedTerms: ranking.matchedTerms,
+                    matchReason: ranking.matchReason,
                 };
             }
             const truncated = totalLines > maxCodeLines;
@@ -144,6 +151,9 @@ export async function getMneExample(params, context) {
                 totalLines,
                 estimatedRunTime: metadata.runTime,
                 tags: metadata.tags,
+                score: ranking.score,
+                matchedTerms: ranking.matchedTerms,
+                matchReason: ranking.matchReason,
             };
         }
         catch (error) {
@@ -151,7 +161,10 @@ export async function getMneExample(params, context) {
             return null;
         }
     }));
-    const examples = parsedExamples.filter((e) => e !== null).slice(0, maxResults);
+    const examples = parsedExamples
+        .filter((e) => e !== null)
+        .sort((a, b) => (b.score || 0) - (a.score || 0) || a.filePath.localeCompare(b.filePath))
+        .slice(0, maxResults);
     if (examples.length === 0) {
         throw new McpError('NO_EXAMPLES_FOUND', `Could not fetch any examples for: ${query}`, {
             details: `Package: ${pkg}`,
@@ -163,6 +176,7 @@ export async function getMneExample(params, context) {
         version: resolvedVersion,
         package: pkg,
         examples,
+        requestBudget: buildGithubRequestBudget(context.github, ['code', 'core']),
     };
 }
 /**

package/dist/tools/getMneExample.js.map

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

package/dist/tools/getMneFile.d.ts

@@ -1,9 +1,6 @@
 import { z } from 'zod';
-import { ToolContext } from '../types.js';
+import { GetMneFileResult, ToolContext } from '../types.js';
 export declare const definition: {
-    name: string;
-    title: string;
-    description: string;
     inputSchema: {
         path: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
@@ -12,13 +9,12 @@ export declare const definition: {
         endLine: z.ZodOptional<z.ZodNumber>;
         package: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
     };
-    annotations: {
-        readonly readOnlyHint: true;
-        readonly destructiveHint: false;
-        readonly idempotentHint: true;
-        readonly openWorldHint: true;
-    };
+    name: string;
+    title: string;
+    description: string;
+    annotations?: object;
+    outputSchema?: z.ZodTypeAny;
 };
-export declare function getMneFile(params: unknown, context: ToolContext): Promise<string>;
+export declare function getMneFile(params: unknown, context: ToolContext): Promise<GetMneFileResult>;
 export { getMneFile as handler };
 //# sourceMappingURL=getMneFile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getMneFile.d.ts","sourceRoot":"","sources":["../../src/tools/getMneFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AAapD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;CAatB,CAAC;AAEF,wBAAsB,UAAU,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAmCD,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"getMneFile.d.ts","sourceRoot":"","sources":["../../src/tools/getMneFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AAoBtE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;CAMrB,CAAC;AAEH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAmE3B;AAyHD,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC"}

package/dist/tools/getMneFile.js

@@ -1,62 +1,87 @@
 import { z } from 'zod';
 import { McpError } from '../types.js';
-import { MNE_PACKAGE_NAMES, packageSchema } from '../config.js';
+import { packageSchema } from '../config.js';
 import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
-const GetMneFileParamsSchema = z.object({
-    path: z.string().trim().min(1, 'Path is required'),
-    version: z.string().optional(),
-    maxLines: z.number().int().positive().optional(),
-    startLine: z.number().int().positive().optional(),
-    endLine: z.number().int().positive().optional(),
-    package: z.enum(MNE_PACKAGE_NAMES).optional(),
+import { getCachedArchive, findFilesInArchive } from '../archive/search.js';
+import { buildGithubRequestBudget } from './requestBudget.js';
+import { defineTool } from './defineTool.js';
+const GetMneFileParamsBaseSchema = z.object({
+    path: z.string().trim().min(1, 'Path is required').describe('File path in repo, e.g. "mne/epochs.py" or "mne_bids/write.py"'),
+    version: z.string().optional().describe('Version tag, e.g. "1.6.0" (default: latest)'),
+    maxLines: z.number().int().positive().optional().describe('Truncate output to N lines'),
+    startLine: z.number().int().positive().optional().describe('Start from this line number'),
+    endLine: z.number().int().positive().optional().describe('End at this line number'),
+    package: packageSchema,
 });
-export const definition = {
+const GetMneFileParamsSchema = GetMneFileParamsBaseSchema.refine(params => params.startLine === undefined || params.endLine === undefined || params.startLine <= params.endLine, { path: ['endLine'], message: 'endLine must be greater than or equal to startLine' });
+export const definition = defineTool({
     name: 'get_mne_file',
     title: 'Get MNE File',
     description: 'Fetch raw source code from MNE-Python or related package repositories. Use when you need to see the actual implementation of a function or class.',
-    inputSchema: {
-        path: z.string().describe('File path in repo, e.g. "mne/epochs.py" or "mne_bids/write.py"'),
-        version: z.string().optional().describe('Version tag, e.g. "1.6.0" (default: latest)'),
-        maxLines: z.number().int().positive().optional().describe('Truncate output to N lines'),
-        startLine: z.number().int().positive().optional().describe('Start from this line number'),
-        endLine: z.number().int().positive().optional().describe('End at this line number'),
-        package: packageSchema,
-    },
+    paramsSchema: GetMneFileParamsBaseSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
-};
+});
 export async function getMneFile(params, context) {
     const { path, version, maxLines, startLine, endLine, package: packageName } = GetMneFileParamsSchema.parse(params);
+    const normalizedPath = normalizeRepoPath(path);
+    if (!normalizedPath) {
+        throw new McpError('FILE_NOT_FOUND', 'File path is empty after normalization', {
+            suggestion: 'Pass a repository-relative path such as "mne/epochs.py".',
+        });
+    }
     const target = await context.repoContent.resolveTarget({ version, packageName });
-    const file = await context.repoContent.readFile({ path, target });
+    const file = await context.repoContent.readFile({ path: normalizedPath, target });
     if (file === null) {
         // Best-effort fallback: try to find close matches in the same repo
         // so that callers get concrete alternative paths instead of a bare
         // "FILE_NOT_FOUND" error.
         let suggestion = 'Check the file path and version. Use search_mne_docs to find available files.';
         let details = `Package: ${target.packageName}, Version: ${target.version}`;
-        try {
-            const fileName = path.split('/').pop() || path;
-            const search = await context.github.searchCode(fileName, {
-                packageName: target.packageName,
-                perPage: 5,
-            });
-            if (search.total_count > 0 && search.items?.length) {
-                const candidates = search.items.slice(0, 5).map(item => `- ${item.path}`);
-                suggestion =
-                    'File not found at the requested path. Here are the closest matching files in this repository.';
-                details = `${details}\nClosest matches:\n${candidates.join('\n')}`;
-            }
+        const archiveMatches = await findCloseArchivePathMatches(normalizedPath, target.version, target.packageName, context);
+        if (archiveMatches.length > 0) {
+            suggestion =
+                'File not found at the requested path. Here are the closest matching files in this repository.';
+            details = `${details}\nClosest matches:\n${archiveMatches.map(match => `- ${match}`).join('\n')}`;
         }
-        catch {
-            // If the fallback search fails (e.g. rate-limit), fall through to the
-            // original generic suggestion without overwriting it.
+        else {
+            try {
+                const fileName = normalizedPath.split('/').pop() || normalizedPath;
+                const search = await context.github.searchCode(fileName, {
+                    packageName: target.packageName,
+                    perPage: 5,
+                });
+                if (search.total_count > 0 && search.items?.length) {
+                    const candidates = search.items.slice(0, 5).map(item => `- ${item.path}`);
+                    suggestion =
+                        'File not found at the requested path. Here are the closest matching files in this repository.';
+                    details = `${details}\nClosest matches:\n${candidates.join('\n')}`;
+                }
+            }
+            catch {
+                // If the fallback search fails (e.g. rate-limit), fall through to the
+                // original generic suggestion without overwriting it.
+            }
         }
-        throw new McpError('FILE_NOT_FOUND', `File not found: ${path}`, {
+        throw new McpError('FILE_NOT_FOUND', `File not found: ${normalizedPath}`, {
             details,
             suggestion,
         });
     }
-    return extractContent(file.content, { maxLines, startLine, endLine });
+    const extracted = extractContent(file.content, { maxLines, startLine, endLine });
+    const totalLines = file.content.split('\n').length;
+    return {
+        path: file.path,
+        version: file.version,
+        package: file.packageName,
+        sourceUrl: context.repoContent.sourceUrl(target, file.path, extracted.startLine, extracted.endLine),
+        content: extracted.content,
+        totalLines,
+        startLine: extracted.startLine,
+        endLine: extracted.endLine,
+        truncated: extracted.truncated,
+        fetchSource: file.readSource,
+        requestBudget: buildGithubRequestBudget(context.github, ['core', 'code']),
+    };
 }
 function extractContent(content, options) {
     const { maxLines, startLine, endLine } = options;
@@ -74,12 +99,78 @@ function extractContent(content, options) {
         if (end < totalLines) {
             result += `\n... (ended at line ${end}, total ${totalLines} lines)`;
         }
-        return result;
+        return {
+            content: result,
+            startLine: start + 1,
+            endLine: end,
+            truncated: start > 0 || end < totalLines,
+        };
     }
     // Otherwise use maxLines truncation
-    if (!maxLines || lines.length <= maxLines)
-        return content;
-    return lines.slice(0, maxLines).join('\n') + `\n... (truncated after ${maxLines} lines, total ${totalLines} lines)`;
+    if (!maxLines || lines.length <= maxLines) {
+        return {
+            content,
+            startLine: 1,
+            endLine: totalLines,
+            truncated: false,
+        };
+    }
+    return {
+        content: lines.slice(0, maxLines).join('\n') + `\n... (truncated after ${maxLines} lines, total ${totalLines} lines)`,
+        startLine: 1,
+        endLine: maxLines,
+        truncated: true,
+    };
+}
+function normalizeRepoPath(path) {
+    return path.replace(/\\/g, '/').replace(/^\/+/, '').replace(/\/{2,}/g, '/');
+}
+async function findCloseArchivePathMatches(requestedPath, version, packageName, context) {
+    const archive = await getCachedArchive(context.github, context.archive, version, packageName);
+    if (!archive)
+        return [];
+    const extension = requestedPath.includes('.')
+        ? `.${requestedPath.split('.').pop() || ''}`.replace(/\.\./g, '.')
+        : undefined;
+    const sourcePrefix = requestedPath.includes('/')
+        ? requestedPath.split('/').slice(0, -1).join('/')
+        : undefined;
+    const candidates = findFilesInArchive(archive, {
+        extension,
+        pathPrefix: sourcePrefix,
+        maxResults: 500,
+    });
+    const ranked = candidates
+        .map(candidate => ({
+        path: candidate,
+        distance: levenshtein(requestedPath.toLowerCase(), candidate.toLowerCase()),
+    }))
+        .filter(candidate => candidate.distance <= Math.max(3, Math.floor(requestedPath.length * 0.2)))
+        .sort((a, b) => a.distance - b.distance || a.path.localeCompare(b.path))
+        .slice(0, 5)
+        .map(candidate => candidate.path);
+    return ranked;
+}
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    const next = new Array(b.length + 1);
+    for (let i = 0; i < a.length; i++) {
+        next[0] = i + 1;
+        for (let j = 0; j < b.length; j++) {
+            const cost = a[i] === b[j] ? 0 : 1;
+            next[j + 1] = Math.min(next[j] + 1, prev[j + 1] + 1, prev[j] + cost);
+        }
+        for (let j = 0; j < next.length; j++) {
+            prev[j] = next[j];
+        }
+    }
+    return prev[b.length];
 }
 export { getMneFile as handler };
 //# sourceMappingURL=getMneFile.js.map

package/dist/tools/getMneFile.js.map

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

package/dist/tools/getMneForumTopic.d.ts

@@ -1,47 +1,18 @@
 import { z } from 'zod';
 import { ToolContext } from '../types.js';
+import { ForumTopicResult } from '../forum/client.js';
 export declare const definition: {
-    name: string;
-    title: string;
-    description: string;
     inputSchema: {
         topicId: z.ZodNumber;
-        maxPosts: z.ZodOptional<z.ZodNumber>;
-        maxContentLength: z.ZodOptional<z.ZodNumber>;
+        maxPosts: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        maxContentLength: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     };
-    annotations: {
-        readonly readOnlyHint: true;
-        readonly destructiveHint: false;
-        readonly idempotentHint: true;
-        readonly openWorldHint: true;
-    };
-};
-/**
- * A single post within a forum topic.
- */
-export interface ForumPost {
-    postNumber: number;
-    author: string;
-    content: string;
-    contentTruncated: boolean;
-    createdAt: string;
-    isAcceptedAnswer: boolean;
-    likeCount: number;
-}
-/**
- * Full forum topic with all posts.
- */
-export interface ForumTopicResult {
-    id: number;
+    name: string;
     title: string;
-    url: string;
-    category: string;
-    tags: string[];
-    viewCount: number;
-    likeCount: number;
-    posts: ForumPost[];
-    totalPosts: number;
-}
+    description: string;
+    annotations?: object;
+    outputSchema?: z.ZodTypeAny;
+};
 /**
  * Fetches a full forum topic with all posts from the MNE Discourse forum.
  * Use this after search_mne_forum to get complete discussion content.

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

@@ -1 +1 @@
-{"version":3,"file":"getMneForumTopic.d.ts","sourceRoot":"","sources":["../../src/tools/getMneForumTopic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAY,MAAM,aAAa,CAAC;AAapD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;CAUtB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AA8BD;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAiE3B;AAyDD,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"getMneForumTopic.d.ts","sourceRoot":"","sources":["../../src/tools/getMneForumTopic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAUtD,eAAO,MAAM,UAAU;;;;;;;;;;;CAMrB,CAAC;AAEH;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAED,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,CAAC"}

package/dist/tools/getMneForumTopic.js

@@ -1,139 +1,25 @@
 import { z } from 'zod';
-import { McpError } from '../types.js';
-import { getLogger } from '../utils/logger.js';
 import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
-import { decodeHtmlEntities } from '../utils/html.js';
-const logger = getLogger();
+import { defineTool } from './defineTool.js';
 const GetMneForumTopicParamsSchema = z.object({
-    topicId: z.number().int().positive('Topic ID must be a positive integer'),
-    maxPosts: z.number().int().min(1).max(100).optional().default(20),
-    maxContentLength: z.number().int().min(100).max(10000).optional().default(2000),
+    topicId: z.number().int().positive('Topic ID must be a positive integer').describe('Forum topic ID (from search_mne_forum results URL)'),
+    maxPosts: z.number().int().min(1).max(100).optional().default(20).describe('Max posts to return (default: 20)'),
+    maxContentLength: z.number().int().min(100).max(10000).optional().default(2000).describe('Truncate each post to N chars (default: 2000)'),
 });
-export const definition = {
+export const definition = defineTool({
     name: 'get_mne_forum_topic',
     title: 'Get MNE Forum Topic',
     description: 'Get the full content of a forum discussion including all posts. Use after search_mne_forum to read complete answers and solutions.',
-    inputSchema: {
-        topicId: z.number().int().positive().describe('Forum topic ID (from search_mne_forum results URL)'),
-        maxPosts: z.number().int().min(1).max(100).optional().describe('Max posts to return (default: 20)'),
-        maxContentLength: z.number().int().min(100).max(10000).optional().describe('Truncate each post to N chars (default: 2000)'),
-    },
+    paramsSchema: GetMneForumTopicParamsSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
-};
+});
 /**
  * Fetches a full forum topic with all posts from the MNE Discourse forum.
  * Use this after search_mne_forum to get complete discussion content.
  */
 export async function getMneForumTopic(params, context) {
     const { topicId, maxPosts, maxContentLength } = GetMneForumTopicParamsSchema.parse(params);
-    const baseUrl = context.forum.baseUrl;
-    const timeout = context.forum.timeout;
-    const url = `${baseUrl}/t/${topicId}.json`;
-    logger.debug(`Fetching forum topic: ${topicId}`);
-    try {
-        const response = await fetch(url, {
-            headers: { 'Accept': 'application/json' },
-            signal: AbortSignal.timeout(timeout || 15000),
-        });
-        if (!response.ok) {
-            if (response.status === 404) {
-                throw new McpError('FORUM_TOPIC_NOT_FOUND', `Forum topic not found: ${topicId}`, {
-                    suggestion: 'Check the topic ID from search_mne_forum results',
-                });
-            }
-            throw new McpError('FORUM_API_ERROR', `Forum API error: ${response.status}`, {
-                details: response.statusText,
-            });
-        }
-        const data = await response.json();
-        // Extract posts with content
-        const posts = data.post_stream.posts
-            .slice(0, maxPosts)
-            .map((p) => {
-            const fullContent = stripHtmlToMarkdown(p.cooked);
-            const truncated = fullContent.length > maxContentLength;
-            return {
-                postNumber: p.post_number,
-                author: p.username,
-                content: truncated
-                    ? fullContent.slice(0, maxContentLength) + '...'
-                    : fullContent,
-                contentTruncated: truncated,
-                createdAt: p.created_at,
-                isAcceptedAnswer: p.accepted_answer || false,
-                likeCount: p.like_count || 0,
-            };
-        });
-        return {
-            id: data.id,
-            title: decodeHtmlEntities(data.fancy_title || data.title),
-            url: `${baseUrl}/t/${data.slug}/${data.id}`,
-            category: getCategoryName(data.category_id),
-            tags: data.tags || [],
-            viewCount: data.views,
-            likeCount: data.like_count,
-            posts,
-            totalPosts: data.posts_count,
-        };
-    }
-    catch (error) {
-        if (error instanceof McpError)
-            throw error;
-        logger.error('Forum topic fetch error', { error, topicId });
-        throw new McpError('FORUM_API_ERROR', `Failed to fetch forum topic: ${topicId}`, {
-            details: error instanceof Error ? error.message : String(error),
-        });
-    }
-}
-/**
- * Convert HTML content to readable markdown.
- */
-function stripHtmlToMarkdown(html) {
-    const text = html
-        // Code blocks
-        .replace(/<pre><code[^>]*>([\s\S]*?)<\/code><\/pre>/g, '\n```\n$1\n```\n')
-        // Inline code
-        .replace(/<code>([^<]+)<\/code>/g, '`$1`')
-        // Links
-        .replace(/<a href="([^"]+)"[^>]*>([^<]+)<\/a>/g, '[$2]($1)')
-        // Bold
-        .replace(/<strong>([^<]+)<\/strong>/g, '**$1**')
-        .replace(/<b>([^<]+)<\/b>/g, '**$1**')
-        // Italic
-        .replace(/<em>([^<]+)<\/em>/g, '*$1*')
-        .replace(/<i>([^<]+)<\/i>/g, '*$1*')
-        // Lists
-        .replace(/<li>/g, '- ')
-        .replace(/<\/li>/g, '\n')
-        .replace(/<\/?[uo]l>/g, '\n')
-        // Paragraphs and breaks
-        .replace(/<\/p>/g, '\n\n')
-        .replace(/<br\s*\/?>/g, '\n')
-        // Blockquotes
-        .replace(/<blockquote>([\s\S]*?)<\/blockquote>/g, (_, content) => content.split('\n').map((line) => `> ${line}`).join('\n'))
-        // Strip remaining tags
-        .replace(/<[^>]+>/g, '')
-        // HTML entities - named
-        .replace(/&copy;/g, '©')
-        .replace(/&reg;/g, '®')
-        // Clean up whitespace
-        .replace(/\n{3,}/g, '\n\n')
-        .trim();
-    return decodeHtmlEntities(text);
-}
-/**
- * Map category IDs to names (common MNE forum categories).
- * Falls back to generic name if category ID is unknown.
- */
-function getCategoryName(categoryId) {
-    const categories = {
-        1: 'General',
-        4: 'Usage Questions',
-        5: 'Development',
-        6: 'Announcements',
-        7: 'Showcase',
-    };
-    return categories[categoryId] || `Category ${categoryId}`;
+    return context.forum.getTopic(topicId, { maxPosts, maxContentLength });
 }
 export { getMneForumTopic as handler };
 //# sourceMappingURL=getMneForumTopic.js.map