mne-docs-mcp 1.0.47 → 1.0.49

package/dist/tools/searchMneDocs.js

@@ -1,26 +1,25 @@
 import { z } from 'zod';
-import { MNE_PACKAGE_NAMES, packageSchema } from '../config.js';
+import { packageSchema } from '../config.js';
 import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { buildGithubRequestBudget } from './requestBudget.js';
+import { rankSearchMatch, isHowToQuery } from '../utils/searchRanking.js';
+import { defineTool } from './defineTool.js';
 const SearchMneDocsParamsSchema = z.object({
-    query: z.string().trim().min(1, 'Query is required'),
-    version: z.string().optional(),
-    maxResultsPerSource: z.number().int().min(1).max(25).optional(),
-    package: z.enum(MNE_PACKAGE_NAMES).optional(),
+    query: z.string().trim().min(1, 'Query is required').describe('Natural-language query or keywords, e.g. "artifact rejection", "ICA tutorial", "memory leak"'),
+    version: z.string().optional().describe('Version tag (default: latest)'),
+    maxResultsPerSource: z.number().int().min(1).max(25).optional().describe('Max results per source type (default: 5)'),
+    package: packageSchema,
 });
-export const definition = {
+export const definition = defineTool({
     name: 'search_mne_docs',
     title: 'Search MNE Docs',
     description: 'Full-text search across MNE documentation, source code, GitHub issues, and the community forum. ' +
         'Use this for natural-language questions ("how do I…"), troubleshooting, and concept discovery. ' +
         'If you need a specific API docstring, use get_mne_doc; if you only know part of a symbol name, use find_mne_symbol.',
-    inputSchema: {
-        query: z.string().describe('Natural-language query or keywords, e.g. "artifact rejection", "ICA tutorial", "memory leak"'),
-        version: z.string().optional().describe('Version tag (default: latest)'),
-        maxResultsPerSource: z.number().int().min(1).max(25).optional().describe('Max results per source type (default: 5)'),
-        package: packageSchema,
-    },
+    paramsSchema: SearchMneDocsParamsSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
-};
+});
+const DISCUSSION_SOURCE_TIMEOUT_MS = 5_000;
 function toGithubSearchItem(item, source) {
     return {
         source,
@@ -28,6 +27,9 @@ function toGithubSearchItem(item, source) {
         path: item.path,
         htmlUrl: item.htmlUrl,
         snippet: item.snippet,
+        score: item.score,
+        matchedTerms: item.matchedTerms,
+        matchReason: item.matchReason,
     };
 }
 export async function searchMneDocs(params, context) {
@@ -43,38 +45,176 @@ export async function searchMneDocs(params, context) {
         return cachedSearch;
     }
     // Issue/forum lookups are independent from code/docs search, so run them in parallel.
-    const issuePromise = context.github.searchIssues(normalizedQuery, { perPage: maxResultsPerSource, packageName: pkg });
-    const forumPromise = context.forum.search(normalizedQuery, maxResultsPerSource);
+    const issuePromise = withTimeout(context.github.searchIssues(normalizedQuery, { perPage: maxResultsPerSource, packageName: pkg }), DISCUSSION_SOURCE_TIMEOUT_MS, 'GitHub issue search timed out');
+    const forumPromise = withTimeout(context.forum.search(normalizedQuery, maxResultsPerSource, { sort: 'relevance' }), DISCUSSION_SOURCE_TIMEOUT_MS, 'Forum search timed out');
     const corpusResult = await context.searchCorpus.searchSourceAndDocs({
         target,
         query: normalizedQuery,
         maxResultsPerScope: maxResultsPerSource,
     });
+    const exampleCandidates = isHowToQuery(normalizedQuery)
+        ? await context.searchCorpus.findGalleryExamples({
+            target,
+            query: normalizedQuery,
+            maxResults: maxResultsPerSource,
+        }).catch(() => [])
+        : [];
     const githubCode = (corpusResult.byScope.code || [])
-        .map(item => toGithubSearchItem(item, 'github-code'));
+        .map(item => toGithubSearchItem(annotateCorpusCandidate(item, normalizedQuery, 'code'), 'github-code'))
+        .sort(byDescendingScore);
     const githubDocs = (corpusResult.byScope.docs || [])
-        .map(item => toGithubSearchItem(item, 'github-doc'));
-    // 3. GitHub Issues Search
-    const [issueResults, forum] = await Promise.all([issuePromise, forumPromise]);
-    const githubIssues = issueResults;
+        .map(item => toGithubSearchItem(annotateCorpusCandidate(item, normalizedQuery, 'docs'), 'github-doc'))
+        .sort(byDescendingScore);
+    const galleryExamples = exampleCandidates
+        .map(item => toGithubSearchItem(annotateCorpusCandidate(item, normalizedQuery, 'example'), 'github-doc'))
+        .sort(byDescendingScore);
+    // 3. GitHub issues and forum search: keep docs/code results useful even
+    // when one external discussion source is temporarily unavailable.
+    const [issueSettled, forumSettled] = await Promise.allSettled([issuePromise, forumPromise]);
+    const issueResults = issueSettled.status === 'fulfilled' ? issueSettled.value : [];
+    const forum = forumSettled.status === 'fulfilled' ? forumSettled.value : [];
+    const githubIssues = issueResults
+        .map(item => {
+        const ranking = rankSearchMatch({
+            query: normalizedQuery,
+            kind: 'issue',
+            title: item.title,
+            snippet: item.labels.join(' '),
+        });
+        return {
+            ...item,
+            score: item.score ?? ranking.score,
+            matchedFields: item.matchedFields?.length ? item.matchedFields : ranking.matchedTerms,
+        };
+    })
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+    const rankedForum = forum
+        .map(item => {
+        const ranking = rankSearchMatch({
+            query: normalizedQuery,
+            kind: 'forum',
+            title: item.title,
+            snippet: `${item.snippet || ''}\n${item.blurb || ''}`,
+            tags: item.tags,
+        });
+        return {
+            ...item,
+            score: item.score ?? ranking.score,
+            matchedTerms: item.matchedTerms ?? ranking.matchedTerms,
+            matchReason: item.matchReason ?? ranking.matchReason,
+        };
+    })
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+    const partialReasons = [];
+    const codeSearchPartialReason = 'GitHub code search was temporarily unavailable, so code/docs matches may be incomplete.';
+    const issuePartialReason = issueSettled.status === 'rejected'
+        ? `GitHub issue search failed: ${errorMessage(issueSettled.reason)}`
+        : undefined;
+    const forumPartialReason = forumSettled.status === 'rejected'
+        ? `Forum search failed: ${errorMessage(forumSettled.reason)}`
+        : undefined;
+    const sourceBudgets = [
+        {
+            source: 'docs',
+            completed: githubDocs.length > 0 || !corpusResult.codeSearchUnavailable,
+            partial: corpusResult.codeSearchUnavailable,
+            reason: corpusResult.codeSearchUnavailable ? codeSearchPartialReason : undefined,
+            timeBudgetMs: 3000,
+        },
+        {
+            source: 'code',
+            completed: githubCode.length > 0 || !corpusResult.codeSearchUnavailable,
+            partial: corpusResult.codeSearchUnavailable,
+            reason: corpusResult.codeSearchUnavailable ? codeSearchPartialReason : undefined,
+            timeBudgetMs: 3000,
+        },
+        {
+            source: 'examples',
+            completed: !isHowToQuery(normalizedQuery) || galleryExamples.length > 0,
+            timeBudgetMs: 2000,
+        },
+        {
+            source: 'issues',
+            completed: issueSettled.status === 'fulfilled',
+            partial: issueSettled.status === 'rejected',
+            reason: issuePartialReason,
+            timeBudgetMs: 1500,
+        },
+        {
+            source: 'forum',
+            completed: forumSettled.status === 'fulfilled',
+            partial: forumSettled.status === 'rejected',
+            reason: forumPartialReason,
+            timeBudgetMs: 1500,
+        },
+    ];
     const result = {
         query: normalizedQuery,
         version: resolvedVersion,
         package: pkg,
         githubDocs,
         githubCode,
+        galleryExamples,
         githubIssues,
-        forum,
+        forum: rankedForum,
+        sourceBudgets,
+        requestBudget: buildGithubRequestBudget(context.github, ['search', 'code']),
     };
+    if (corpusResult.codeSearchUnavailable) {
+        partialReasons.push(codeSearchPartialReason);
+    }
+    if (issuePartialReason) {
+        partialReasons.push(issuePartialReason);
+    }
+    if (forumPartialReason) {
+        partialReasons.push(forumPartialReason);
+    }
+    if (partialReasons.length > 0) {
+        result.partial = true;
+        result.partialReason = partialReasons[0];
+        result.partialReasons = partialReasons;
+    }
     if (githubDocs.length === 0 &&
+        galleryExamples.length === 0 &&
         githubCode.length === 0 &&
         githubIssues.length === 0 &&
-        forum.length === 0) {
+        rankedForum.length === 0) {
         result.hint =
             'No results found. Try a broader query, different keywords, or use find_mne_symbol for API lookups.';
     }
     context.cache.setSearch(resolvedVersion, cacheKey, result);
     return result;
 }
+function annotateCorpusCandidate(item, query, kind) {
+    const ranking = rankSearchMatch({
+        query,
+        kind,
+        title: item.name,
+        path: item.path,
+        snippet: item.snippet,
+    });
+    return {
+        ...item,
+        score: item.score ?? ranking.score,
+        matchedTerms: item.matchedTerms ?? ranking.matchedTerms,
+        matchReason: item.matchReason ?? ranking.matchReason,
+    };
+}
+function byDescendingScore(a, b) {
+    return (b.score || 0) - (a.score || 0) || a.path.localeCompare(b.path);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function withTimeout(promise, timeoutMs, message) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(message)), timeoutMs);
+    });
+    return Promise.race([promise, timeout]).finally(() => {
+        if (timer)
+            clearTimeout(timer);
+    });
+}
 export { searchMneDocs as handler };
 //# sourceMappingURL=searchMneDocs.js.map

package/dist/tools/searchMneDocs.js.map

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

package/dist/tools/searchMneForum.d.ts

@@ -1,25 +1,24 @@
 import { z } from 'zod';
 import { ForumSearchItem, ToolContext } from '../types.js';
 export declare const definition: {
-    name: string;
-    title: string;
-    description: string;
     inputSchema: {
         query: z.ZodString;
-        maxResults: z.ZodOptional<z.ZodNumber>;
-    };
-    annotations: {
-        readonly readOnlyHint: true;
-        readonly destructiveHint: false;
-        readonly idempotentHint: true;
-        readonly openWorldHint: true;
+        maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        sort: z.ZodDefault<z.ZodOptional<z.ZodEnum<["relevance", "recent"]>>>;
     };
+    name: string;
+    title: string;
+    description: string;
+    annotations?: object;
+    outputSchema?: z.ZodTypeAny;
 };
 export interface SearchMneForumResult {
     query: string;
     results: ForumSearchItem[];
     totalResults: number;
     cached?: boolean;
+    partial?: boolean;
+    partialReason?: string;
 }
 export declare function searchMneForum(params: unknown, context: ToolContext): Promise<SearchMneForumResult>;
 export { searchMneForum as handler };

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

@@ -1 +1 @@
-{"version":3,"file":"searchMneForum.d.ts","sourceRoot":"","sources":["../../src/tools/searchMneForum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ3D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;CAStB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,cAAc,CAChC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,oBAAoB,CAAC,CA2B/B;AAED,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"searchMneForum.d.ts","sourceRoot":"","sources":["../../src/tools/searchMneForum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU3D,eAAO,MAAM,UAAU;;;;;;;;;;;CAMrB,CAAC;AAEH,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,cAAc,CAChC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAoC/B;AAED,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,CAAC"}

package/dist/tools/searchMneForum.js

@@ -1,24 +1,23 @@
 import { z } from 'zod';
 import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { defineTool } from './defineTool.js';
 const SearchMneForumParamsSchema = z.object({
-    query: z.string().trim().min(1, 'Query is required'),
-    maxResults: z.number().min(1).max(50).optional().default(10),
+    query: z.string().trim().min(1, 'Query is required').describe('Search query, e.g. "ICA artifact removal", "source localization", "EEG preprocessing"'),
+    maxResults: z.number().int().min(1).max(50).optional().default(10).describe('Max results (default: 10)'),
+    sort: z.enum(['relevance', 'recent']).optional().default('relevance').describe('Sort results by search relevance or recent activity (default: relevance)'),
 });
-export const definition = {
+export const definition = defineTool({
     name: 'search_mne_forum',
     title: 'Search MNE Forum',
     description: 'Search the MNE community Discourse forum for user questions and answers. Great for "how do I..." questions, troubleshooting, and best practices from the community.',
-    inputSchema: {
-        query: z.string().describe('Search query, e.g. "ICA artifact removal", "source localization", "EEG preprocessing"'),
-        maxResults: z.number().optional().describe('Max results (default: 10)'),
-    },
+    paramsSchema: SearchMneForumParamsSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
-};
+});
 export async function searchMneForum(params, context) {
-    const { query, maxResults } = SearchMneForumParamsSchema.parse(params);
+    const { query, maxResults, sort } = SearchMneForumParamsSchema.parse(params);
     const normalizedQuery = query.replace(/\s+/g, ' ').trim();
     // Check cache first
-    const cacheKey = `${normalizedQuery.toLowerCase()}:${maxResults}`;
+    const cacheKey = `${normalizedQuery.toLowerCase()}:${maxResults}:${sort}`;
     const cachedResults = context.cache.getForumSearch(cacheKey);
     if (cachedResults) {
         return {
@@ -29,13 +28,23 @@ export async function searchMneForum(params, context) {
         };
     }
     // Fetch from forum
-    const results = await context.forum.search(normalizedQuery, maxResults);
+    let results = [];
+    let partialReason;
+    try {
+        results = await context.forum.search(normalizedQuery, maxResults, { sort });
+    }
+    catch (error) {
+        partialReason = `Forum search failed: ${error instanceof Error ? error.message : String(error)}`;
+    }
     // Cache results
-    context.cache.setForumSearch(cacheKey, results);
+    if (!partialReason) {
+        context.cache.setForumSearch(cacheKey, results);
+    }
     return {
         query: normalizedQuery,
         results,
         totalResults: results.length,
+        ...(partialReason && { partial: true, partialReason }),
     };
 }
 export { searchMneForum as handler };

package/dist/tools/searchMneForum.js.map

@@ -1 +1 @@
-{"version":3,"file":"searchMneForum.js","sourceRoot":"","sources":["../../src/tools/searchMneForum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,qKAAqK;IAClL,WAAW,EAAE;QACT,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;QACnH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC1E;IACD,WAAW,EAAE,0BAA0B;CAC1C,CAAC;AASF,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAe,EACf,OAAoB;IAEpB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1D,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAG,eAAe,CAAC,WAAW,EAAE,IAAI,UAAU,EAAE,CAAC;IAClE,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO;YACH,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,aAAa;YACtB,YAAY,EAAE,aAAa,CAAC,MAAM;YAClC,MAAM,EAAE,IAAI;SACf,CAAC;IACN,CAAC;IAED,mBAAmB;IACnB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAExE,gBAAgB;IAChB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEhD,OAAO;QACH,KAAK,EAAE,eAAe;QACtB,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,MAAM;KAC/B,CAAC;AACN,CAAC;AAED,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"searchMneForum.js","sourceRoot":"","sources":["../../src/tools/searchMneForum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,CAAC,uFAAuF,CAAC;IACtJ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACxG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,0EAA0E,CAAC;CAC7J,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,qKAAqK;IAClL,YAAY,EAAE,0BAA0B;IACxC,WAAW,EAAE,0BAA0B;CAC1C,CAAC,CAAC;AAWH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAe,EACf,OAAoB;IAEpB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7E,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1D,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAG,eAAe,CAAC,WAAW,EAAE,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;IAC1E,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO;YACH,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,aAAa;YACtB,YAAY,EAAE,aAAa,CAAC,MAAM;YAClC,MAAM,EAAE,IAAI;SACf,CAAC;IACN,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,GAAsB,EAAE,CAAC;IACpC,IAAI,aAAiC,CAAC;IACtC,IAAI,CAAC;QACD,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,aAAa,GAAG,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACrG,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,OAAO;QACH,KAAK,EAAE,eAAe;QACtB,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,GAAG,CAAC,aAAa,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;KACzD,CAAC;AACN,CAAC;AAED,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,CAAC"}

package/dist/tools/searchMneIssues.d.ts

@@ -1,27 +1,26 @@
 import { z } from 'zod';
-import { GithubIssueItem, ToolContext } from '../types.js';
+import { GithubIssueItem, RequestBudgetSummary, ToolContext } from '../types.js';
 export declare const definition: {
-    name: string;
-    title: string;
-    description: string;
     inputSchema: {
         query: z.ZodString;
         state: z.ZodOptional<z.ZodEnum<["open", "closed", "all"]>>;
         labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         maxResults: z.ZodOptional<z.ZodNumber>;
-        sort: z.ZodOptional<z.ZodEnum<["relevance", "updated", "created", "comments"]>>;
+        sort: z.ZodDefault<z.ZodOptional<z.ZodEnum<["relevance", "updated", "created", "comments"]>>>;
         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;
 };
 interface SearchMneIssuesResult {
     issues: GithubIssueItem[];
     package: string;
+    requestBudget?: RequestBudgetSummary;
+    partial?: boolean;
+    partialReason?: string;
 }
 export declare function searchMneIssues(params: unknown, context: ToolContext): Promise<SearchMneIssuesResult>;
 export { searchMneIssues as handler };

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

@@ -1 +1 @@
-{"version":3,"file":"searchMneIssues.d.ts","sourceRoot":"","sources":["../../src/tools/searchMneIssues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa3D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;CAatB,CAAC;AAEF,UAAU,qBAAqB;IAC3B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACjC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,qBAAqB,CAAC,CAehC;AAED,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"searchMneIssues.d.ts","sourceRoot":"","sources":["../../src/tools/searchMneIssues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAejF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;CAMrB,CAAC;AAEH,UAAU,qBAAqB;IAC3B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CACjC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,GACrB,OAAO,CAAC,qBAAqB,CAAC,CAuBhC;AAED,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}

package/dist/tools/searchMneIssues.js

@@ -1,40 +1,44 @@
 import { z } from 'zod';
-import { MNE_PACKAGE_NAMES, packageSchema } from '../config.js';
+import { packageSchema } from '../config.js';
 import { READ_ONLY_TOOL_ANNOTATIONS } from './annotations.js';
+import { buildGithubRequestBudget } from './requestBudget.js';
+import { defineTool } from './defineTool.js';
 const SearchMneIssuesParamsSchema = z.object({
-    query: z.string().trim().min(1, 'Query is required'),
-    state: z.enum(['open', 'closed', 'all']).optional(),
-    labels: z.array(z.string()).optional(),
-    maxResults: z.number().int().min(1).max(50).optional(),
-    sort: z.enum(['relevance', 'updated', 'created', 'comments']).optional().default('relevance'),
-    package: z.enum(MNE_PACKAGE_NAMES).optional(),
+    query: z.string().trim().min(1, 'Query is required').describe('Search query, e.g. "memory leak", "segmentation fault", "deprecation warning"'),
+    state: z.enum(['open', 'closed', 'all']).optional().describe('Filter by issue state (default: all)'),
+    labels: z.array(z.string()).optional().describe('Filter by labels, e.g. ["bug", "help wanted"]'),
+    maxResults: z.number().int().min(1).max(50).optional().describe('Max results (default: 10)'),
+    sort: z.enum(['relevance', 'updated', 'created', 'comments']).optional().default('relevance').describe('Sort order (default: relevance). Use "updated" for most recently active issues.'),
+    package: packageSchema,
 });
-export const definition = {
+export const definition = defineTool({
     name: 'search_mne_issues',
     title: 'Search MNE Issues',
     description: 'Search GitHub issues for MNE packages. Use to find bug reports, feature requests, or known problems. Helpful when users encounter errors or unexpected behavior.',
-    inputSchema: {
-        query: z.string().describe('Search query, e.g. "memory leak", "segmentation fault", "deprecation warning"'),
-        state: z.enum(['open', 'closed', 'all']).optional().describe('Filter by issue state (default: all)'),
-        labels: z.array(z.string()).optional().describe('Filter by labels, e.g. ["bug", "help wanted"]'),
-        maxResults: z.number().int().min(1).max(50).optional().describe('Max results (default: 10)'),
-        sort: z.enum(['relevance', 'updated', 'created', 'comments']).optional().describe('Sort order (default: relevance). Use "updated" for most recently active issues.'),
-        package: packageSchema,
-    },
+    paramsSchema: SearchMneIssuesParamsSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
-};
+});
 export async function searchMneIssues(params, context) {
     const { query, state = 'all', labels, maxResults = 10, sort = 'relevance', package: packageName } = SearchMneIssuesParamsSchema.parse(params);
-    const issues = await context.github.searchIssues(query, {
-        state,
-        labels,
-        perPage: maxResults,
-        sort: sort === 'relevance' ? undefined : sort,
-        packageName,
-    });
+    let issues = [];
+    let partialReason;
+    try {
+        issues = await context.github.searchIssues(query, {
+            state,
+            labels,
+            perPage: maxResults,
+            sort: sort === 'relevance' ? undefined : sort,
+            packageName,
+        });
+    }
+    catch (error) {
+        partialReason = `GitHub issue search failed: ${error instanceof Error ? error.message : String(error)}`;
+    }
     return {
         issues,
         package: packageName || 'mne-python',
+        requestBudget: buildGithubRequestBudget(context.github, ['search']),
+        ...(partialReason && { partial: true, partialReason }),
     };
 }
 export { searchMneIssues as handler };

package/dist/tools/searchMneIssues.js.map

@@ -1 +1 @@
-{"version":3,"file":"searchMneIssues.js","sourceRoot":"","sources":["../../src/tools/searchMneIssues.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"searchMneIssues.js","sourceRoot":"","sources":["../../src/tools/searchMneIssues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,CAAC,+EAA+E,CAAC;IAC9I,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACpG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAChG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC5F,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,iFAAiF,CAAC;IACzL,OAAO,EAAE,aAAa;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,kKAAkK;IAC/K,YAAY,EAAE,2BAA2B;IACzC,WAAW,EAAE,0BAA0B;CAC1C,CAAC,CAAC;AAUH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAe,EACf,OAAoB;IAEpB,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,IAAI,GAAG,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,2BAA2B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9I,IAAI,MAAM,GAAsB,EAAE,CAAC;IACnC,IAAI,aAAiC,CAAC;IACtC,IAAI,CAAC;QACD,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE;YAC9C,KAAK;YACL,MAAM;YACN,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YAC7C,WAAW;SACd,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,aAAa,GAAG,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5G,CAAC;IAED,OAAO;QACH,MAAM;QACN,OAAO,EAAE,WAAW,IAAI,YAAY;QACpC,aAAa,EAAE,wBAAwB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;QACnE,GAAG,CAAC,aAAa,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;KACzD,CAAC;AACN,CAAC;AAED,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}

package/dist/types.d.ts

@@ -54,6 +54,7 @@ export interface GetMneDocResult {
     symbol: string;
     version: string;
     qualifiedName: string;
+    publicQualifiedName?: string;
     kind: string;
     signature: string;
     docstring: string;
@@ -73,7 +74,7 @@ export interface FindSymbolResult {
     sourceUrl: string;
     version: string;
 }
-export type ErrorCode = 'INVALID_QUERY' | 'SYMBOL_NOT_FOUND' | 'VERSION_NOT_FOUND' | 'FILE_NOT_FOUND' | 'ISSUE_NOT_FOUND' | 'GITHUB_RATE_LIMITED' | 'GITHUB_AUTH_FAILED' | 'GITHUB_API_ERROR' | 'FORUM_API_ERROR' | 'PARSER_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'INTERNAL_ERROR';
+export type ErrorCode = 'INVALID_QUERY' | 'SYMBOL_NOT_FOUND' | 'VERSION_NOT_FOUND' | 'FILE_NOT_FOUND' | 'NO_EXAMPLES_FOUND' | 'ISSUE_NOT_FOUND' | 'GITHUB_RATE_LIMITED' | 'GITHUB_AUTH_FAILED' | 'GITHUB_API_ERROR' | 'FORUM_API_ERROR' | 'FORUM_TOPIC_NOT_FOUND' | 'PARSER_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'INTERNAL_ERROR';
 export interface MneError {
     errorCode: ErrorCode;
     message: string;
@@ -114,6 +115,8 @@ export interface GithubIssueItem {
     updatedAt: string;
     commentsCount: number;
     labels: string[];
+    score?: number;
+    matchedFields?: string[];
 }
 export interface GithubSearchItem {
     source: 'github-code' | 'github-doc';
@@ -121,14 +124,43 @@ export interface GithubSearchItem {
     path: string;
     htmlUrl: string;
     snippet?: string;
+    score?: number;
+    matchedTerms?: string[];
+    matchReason?: string;
 }
 export interface ForumSearchItem {
     source: 'forum';
     title: string;
     url: string;
     blurb?: string;
+    snippet?: string;
     postsCount?: number;
+    replyCount?: number;
     createdAt?: string;
+    lastActivityAt?: string;
+    category?: string;
+    tags?: string[];
+    hasAcceptedAnswer?: boolean;
+    score?: number;
+    matchedTerms?: string[];
+    matchReason?: string;
+}
+export interface RequestBudgetInfo {
+    bucket: string;
+    remaining: number;
+    limit: number;
+    resetInSeconds: number;
+}
+export interface RequestBudgetSummary {
+    buckets: RequestBudgetInfo[];
+    warnings: string[];
+}
+export interface SearchSourceBudget {
+    source: 'docs' | 'code' | 'examples' | 'issues' | 'forum';
+    completed: boolean;
+    partial?: boolean;
+    reason?: string;
+    timeBudgetMs?: number;
 }
 export interface SearchResult {
     query: string;
@@ -136,8 +168,14 @@ export interface SearchResult {
     package?: string;
     githubDocs: GithubSearchItem[];
     githubCode: GithubSearchItem[];
+    galleryExamples?: GithubSearchItem[];
     githubIssues: GithubIssueItem[];
     forum: ForumSearchItem[];
+    partial?: boolean;
+    partialReason?: string;
+    partialReasons?: string[];
+    sourceBudgets?: SearchSourceBudget[];
+    requestBudget?: RequestBudgetSummary;
     /** Optional hint when no results found; suggests broadening/narrowing the query. */
     hint?: string;
 }
@@ -149,5 +187,19 @@ export interface RateLimitSummary {
     remaining: number;
     limit: number;
     resetInSeconds: number;
+    bucket?: string;
+}
+export interface GetMneFileResult {
+    path: string;
+    version: string;
+    package: string;
+    sourceUrl: string;
+    content: string;
+    totalLines: number;
+    startLine: number;
+    endLine: number;
+    truncated: boolean;
+    fetchSource: 'cache' | 'archive' | 'github';
+    requestBudget?: RequestBudgetSummary;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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