@cyanheads/wikipedia-mcp-server 0.1.3

package/dist/mcp-server/tools/definitions/wikipedia-get-languages.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-get-languages.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/wikipedia-get-languages.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqHhC,CAAC"}

package/dist/mcp-server/tools/definitions/wikipedia-get-languages.tool.js

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview wikipedia_get_languages tool — list language editions available for a Wikipedia article.
+ * @module mcp-server/tools/definitions/wikipedia-get-languages.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getWikipediaService } from '../../../services/wikipedia/wikipedia-service.js';
+export const wikipediaGetLanguages = tool('wikipedia_get_languages', {
+    title: 'Get Wikipedia Article Languages',
+    description: 'List the language editions available for a Wikipedia article. Returns language codes, article titles in each language, and full URLs. Useful for cross-language research and for discovering the correct article title in a target language before fetching it. The language parameter specifies which edition to query from.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        title: z.string().describe('Article title in the source language edition.'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Wikipedia language edition to query from (default "en"). Examples: "fr", "de", "ja".'),
+    }),
+    output: z.object({
+        source_title: z.string().describe('Article title in the source language edition.'),
+        source_language: z.string().describe('The language edition that was queried.'),
+        languages: z
+            .array(z
+            .object({
+            language_code: z.string().describe('BCP 47 language code (e.g. "fr", "de").'),
+            title: z.string().describe('Article title in this language edition.'),
+            url: z.string().describe('Full URL to the article in this language edition.'),
+        })
+            .describe('A single language edition entry.'))
+            .describe('Available language editions excluding the source language.'),
+        total_languages: z.number().describe('Total number of other language editions available.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No Wikipedia article exists for the title in the specified language.',
+            recovery: 'Use wikipedia_search to discover the correct article title and try again.',
+        },
+        {
+            reason: 'no_other_languages',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Article exists but has no other language editions.',
+            recovery: 'The article may be too new or too regional to have been translated yet.',
+        },
+        {
+            reason: 'invalid_language',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The language code is not a valid BCP 47 code.',
+            recovery: 'Use a valid BCP 47 language code such as "fr", "de", or "ja".',
+        },
+    ],
+    async handler(input, ctx) {
+        const { language } = input;
+        if (!/^[a-z]{2,3}(-[a-z0-9]+)*$/i.test(language)) {
+            throw ctx.fail('invalid_language', `Invalid language code "${language}". Use a BCP 47 language code such as "fr", "de", or "ja".`, { language, ...ctx.recoveryFor('invalid_language') });
+        }
+        ctx.log.info('Fetching language links', { title: input.title, language });
+        const svc = getWikipediaService();
+        let getLanguagesResult;
+        try {
+            getLanguagesResult = await svc.getLanguages(input.title, language, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('not_found', err.message, {
+                    title: input.title,
+                    language,
+                    recovery: { hint: 'Use wikipedia_search to find the correct article title.' },
+                });
+            }
+            throw err;
+        }
+        const { languages } = getLanguagesResult;
+        if (languages.length === 0) {
+            throw ctx.fail('no_other_languages', `Article "${input.title}" in language "${language}" has no other language editions.`, {
+                title: input.title,
+                language,
+                ...ctx.recoveryFor('no_other_languages'),
+            });
+        }
+        ctx.log.info('Language links fetched', { title: input.title, count: languages.length });
+        return {
+            source_title: input.title,
+            source_language: language,
+            languages: languages.map((l) => ({
+                language_code: l.languageCode,
+                title: l.title,
+                url: l.url,
+            })),
+            total_languages: languages.length,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Language editions for "${result.source_title}" (${result.source_language})`,
+            `**${result.total_languages} languages available**\n`,
+        ];
+        for (const lang of result.languages) {
+            lines.push(`- **${lang.language_code}**: [${lang.title}](${lang.url})`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=wikipedia-get-languages.tool.js.map

package/dist/mcp-server/tools/definitions/wikipedia-get-languages.tool.js.map

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

package/dist/mcp-server/tools/definitions/wikipedia-get-sections.tool.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview wikipedia_get_sections tool — fetch the table of contents for a Wikipedia article.
+ * @module mcp-server/tools/definitions/wikipedia-get-sections.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikipediaGetSections: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    title: z.ZodString;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    title: z.ZodString;
+    pageid: z.ZodOptional<z.ZodNumber>;
+    sections: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        number: z.ZodString;
+        title: z.ZodString;
+        level: z.ZodNumber;
+    }, z.core.$strip>>;
+    total_sections: z.ZodNumber;
+    language: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the given title.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "no_sections";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Article exists but has no sections (stub or very short article).";
+    readonly recovery: "Use wikipedia_get_article without section_index to read the full short article.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]>;
+//# sourceMappingURL=wikipedia-get-sections.tool.d.ts.map

package/dist/mcp-server/tools/definitions/wikipedia-get-sections.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-get-sections.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/wikipedia-get-sections.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuH/B,CAAC"}

package/dist/mcp-server/tools/definitions/wikipedia-get-sections.tool.js

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview wikipedia_get_sections tool — fetch the table of contents for a Wikipedia article.
+ * @module mcp-server/tools/definitions/wikipedia-get-sections.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getWikipediaService } from '../../../services/wikipedia/wikipedia-service.js';
+export const wikipediaGetSections = tool('wikipedia_get_sections', {
+    title: 'Get Wikipedia Article Sections',
+    description: 'Fetch the table of contents for a Wikipedia article. Returns section titles, heading levels, section numbering (e.g. "2.1"), and section_index values. Pass a section_index to wikipedia_get_article to retrieve just that section. Useful for enumerating article structure before doing a targeted section read.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        title: z.string().describe('Article title (e.g. "Python (programming language)").'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Wikipedia language edition code (default "en"). Examples: "fr", "de", "ja".'),
+    }),
+    output: z.object({
+        title: z.string().describe('Article title as resolved by Wikipedia.'),
+        pageid: z.number().optional().describe('Wikipedia page ID. Absent for stub articles.'),
+        sections: z
+            .array(z
+            .object({
+            index: z
+                .number()
+                .describe('Section index — pass to wikipedia_get_article as section_index.'),
+            number: z.string().describe('Section number (e.g. "2.1") for hierarchical navigation.'),
+            title: z.string().describe('Section heading text.'),
+            level: z.number().describe('Heading depth: 2 = ==, 3 = ===, etc.'),
+        })
+            .describe('A single table-of-contents entry.'))
+            .describe('Ordered list of article sections with index values for targeted reads.'),
+        total_sections: z.number().describe('Total number of sections in the article.'),
+        language: z.string().describe('Language edition queried.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No Wikipedia article exists for the given title.',
+            recovery: 'Use wikipedia_search to discover the correct article title and try again.',
+        },
+        {
+            reason: 'no_sections',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Article exists but has no sections (stub or very short article).',
+            recovery: 'Use wikipedia_get_article without section_index to read the full short article.',
+        },
+        {
+            reason: 'invalid_language',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The language code is not a valid BCP 47 code.',
+            recovery: 'Use a valid BCP 47 language code such as "fr", "de", or "ja".',
+        },
+    ],
+    async handler(input, ctx) {
+        const { language } = input;
+        if (!/^[a-z]{2,3}(-[a-z0-9]+)*$/i.test(language)) {
+            throw ctx.fail('invalid_language', `Invalid language code "${language}". Use a BCP 47 language code such as "fr", "de", or "ja".`, { language, ...ctx.recoveryFor('invalid_language') });
+        }
+        ctx.log.info('Fetching sections', { title: input.title, language });
+        const svc = getWikipediaService();
+        let result;
+        try {
+            result = await svc.getSections(input.title, language, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('not_found', err.message, {
+                    title: input.title,
+                    language,
+                    recovery: { hint: 'Use wikipedia_search to find the correct article title.' },
+                });
+            }
+            throw err;
+        }
+        if (result.sections.length === 0) {
+            throw ctx.fail('no_sections', `Article "${input.title}" exists but has no sections. It may be a stub.`, {
+                title: input.title,
+                recovery: {
+                    hint: 'Use wikipedia_get_article without section_index to read the full article content.',
+                },
+            });
+        }
+        ctx.log.info('Sections fetched', { title: input.title, count: result.sections.length });
+        return {
+            title: input.title,
+            pageid: result.pageid,
+            sections: result.sections,
+            total_sections: result.sections.length,
+            language,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Table of Contents — ${result.title} (${result.language})`,
+            `${result.total_sections} sections` +
+                (result.pageid != null ? ` | Page ID: ${result.pageid}` : ''),
+            '',
+        ];
+        for (const s of result.sections) {
+            const indent = '  '.repeat(Math.max(0, s.level - 2));
+            lines.push(`${indent}${s.number}. **${s.title}** (index: ${s.index}, level: ${s.level})`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=wikipedia-get-sections.tool.js.map

package/dist/mcp-server/tools/definitions/wikipedia-get-sections.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-get-sections.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/wikipedia-get-sections.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,wBAAwB,EAAE;IACjE,KAAK,EAAE,gCAAgC;IACvC,WAAW,EACT,oTAAoT;IACtT,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;QACnF,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,6EAA6E,CAAC;KAC3F,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QACtF,QAAQ,EAAE,CAAC;aACR,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;YACvF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SACnE,CAAC;aACD,QAAQ,CAAC,mCAAmC,CAAC,CACjD;aACA,QAAQ,CAAC,wEAAwE,CAAC;QACrF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC3D,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,kDAAkD;YACxD,QAAQ,EAAE,2EAA2E;SACtF;QACD;YACE,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,kEAAkE;YACxE,QAAQ,EAAE,iFAAiF;SAC5F;QACD;YACE,MAAM,EAAE,kBAAkB;YAC1B,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,IAAI,EAAE,+CAA+C;YACrD,QAAQ,EAAE,+DAA+D;SAC1E;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QAE3B,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjD,MAAM,GAAG,CAAC,IAAI,CACZ,kBAAkB,EAClB,0BAA0B,QAAQ,4DAA4D,EAC9F,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,CACrD,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEpE,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;QAClC,IAAI,MAAmD,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ,EAAE,CAAC;gBACtE,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,EAAE;oBACvC,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,QAAQ;oBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,yDAAyD,EAAE;iBAC9E,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,GAAG,CAAC,IAAI,CACZ,aAAa,EACb,YAAY,KAAK,CAAC,KAAK,iDAAiD,EACxE;gBACE,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE;oBACR,IAAI,EAAE,mFAAmF;iBAC1F;aACF,CACF,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAExF,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YACtC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa;YACtB,0BAA0B,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,QAAQ,GAAG;YAC7D,GAAG,MAAM,CAAC,cAAc,WAAW;gBACjC,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,EAAE;SACH,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/wikipedia-get-summary.tool.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview wikipedia_get_summary tool — fetch the lead section summary for a Wikipedia article.
+ * @module mcp-server/tools/definitions/wikipedia-get-summary.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikipediaGetSummary: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    title: z.ZodString;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    title: z.ZodString;
+    page_type: z.ZodString;
+    pageid: z.ZodOptional<z.ZodNumber>;
+    wikibase_item: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    extract: z.ZodString;
+    thumbnail_url: z.ZodOptional<z.ZodString>;
+    language: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the given title.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]>;
+//# sourceMappingURL=wikipedia-get-summary.tool.d.ts.map

package/dist/mcp-server/tools/definitions/wikipedia-get-summary.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-get-summary.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/wikipedia-get-summary.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;GA8G9B,CAAC"}

package/dist/mcp-server/tools/definitions/wikipedia-get-summary.tool.js

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview wikipedia_get_summary tool — fetch the lead section summary for a Wikipedia article.
+ * @module mcp-server/tools/definitions/wikipedia-get-summary.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getWikipediaService } from '../../../services/wikipedia/wikipedia-service.js';
+export const wikipediaGetSummary = tool('wikipedia_get_summary', {
+    title: 'Get Wikipedia Summary',
+    description: 'Fetch the lead-section summary for a Wikipedia article — the 2–4 paragraph intro that answers "what is X?". Returns plain-text extract, Wikidata QID (wikibase_item) for cross-referencing with wikidata-mcp-server, short description, and thumbnail URL. Redirect pages are followed automatically. When page_type is "disambiguation", the title matched a disambiguation page — call wikipedia_search with a more specific query to find the intended article. Prefer this over wikipedia_get_article unless full article depth is needed.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        title: z
+            .string()
+            .describe('Article title (URL-decoded), e.g. "Python (programming language)".'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Wikipedia language edition code (default "en"). Examples: "fr", "de", "ja".'),
+    }),
+    output: z.object({
+        title: z.string().describe('Resolved article title (may differ from input for redirects).'),
+        page_type: z
+            .string()
+            .describe('Page type from the Wikipedia REST API. Common values: "standard" (regular article), "disambiguation" (disambiguation page), "no-extract" (article with no extract). When "disambiguation", call wikipedia_search with a more specific query.'),
+        pageid: z.number().optional().describe('Wikipedia page ID. Absent when the API omits it.'),
+        wikibase_item: z
+            .string()
+            .optional()
+            .describe('Wikidata QID (e.g. "Q28865"). Use to chain into wikidata-mcp-server without a separate lookup.'),
+        description: z.string().optional().describe('Short description of the article subject.'),
+        extract: z.string().describe('Plain-text lead-section extract.'),
+        thumbnail_url: z
+            .string()
+            .optional()
+            .describe('URL of the article thumbnail image, if available.'),
+        language: z.string().describe('Language edition queried.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No Wikipedia article exists for the given title.',
+            recovery: 'Use wikipedia_search to discover the correct article title and try again.',
+        },
+        {
+            reason: 'invalid_language',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The language code is not a valid BCP 47 code.',
+            recovery: 'Use a valid BCP 47 language code such as "fr", "de", or "ja".',
+        },
+    ],
+    async handler(input, ctx) {
+        const { language } = input;
+        if (!/^[a-z]{2,3}(-[a-z0-9]+)*$/i.test(language)) {
+            throw ctx.fail('invalid_language', `Invalid language code "${language}". Use a BCP 47 language code such as "fr", "de", or "ja".`, { language, ...ctx.recoveryFor('invalid_language') });
+        }
+        ctx.log.info('Fetching summary', { title: input.title, language });
+        const svc = getWikipediaService();
+        let result;
+        try {
+            result = await svc.getSummary(input.title, language, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('not_found', err.message, {
+                    title: input.title,
+                    language,
+                    recovery: { hint: 'Use wikipedia_search to find the correct article title.' },
+                });
+            }
+            throw err;
+        }
+        ctx.log.info('Summary fetched', {
+            title: result.title,
+            pageType: result.pageType,
+            hasQid: Boolean(result.wikidataQid),
+        });
+        return {
+            title: result.title,
+            page_type: result.pageType,
+            pageid: result.pageid,
+            wikibase_item: result.wikidataQid,
+            description: result.description,
+            extract: result.extract,
+            thumbnail_url: result.thumbnailUrl,
+            language,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`# ${result.title}`);
+        if (result.description)
+            lines.push(`*${result.description}*`);
+        lines.push(`**Type:** ${result.page_type} | **Language:** ${result.language}`);
+        if (result.pageid != null)
+            lines.push(`**Page ID:** ${result.pageid}`);
+        if (result.wikibase_item)
+            lines.push(`**Wikidata QID:** ${result.wikibase_item}`);
+        if (result.thumbnail_url)
+            lines.push(`**Thumbnail:** ${result.thumbnail_url}`);
+        lines.push('');
+        lines.push(result.extract);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=wikipedia-get-summary.tool.js.map

package/dist/mcp-server/tools/definitions/wikipedia-get-summary.tool.js.map

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

package/dist/mcp-server/tools/definitions/wikipedia-search-nearby.tool.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview wikipedia_search_nearby tool — find geotagged Wikipedia articles near a coordinate.
+ * @module mcp-server/tools/definitions/wikipedia-search-nearby.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikipediaSearchNearby: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    radius_meters: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        pageid: z.ZodNumber;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        distance_meters: z.ZodNumber;
+    }, z.core.$strip>>;
+    total_results: z.ZodNumber;
+    query_latitude: z.ZodNumber;
+    query_longitude: z.ZodNumber;
+    radius_meters_used: z.ZodNumber;
+    language: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No geotagged articles found within the search radius.";
+    readonly recovery: "Increase radius_meters or verify the coordinates are correct and retry.";
+}, {
+    readonly reason: "invalid_coordinates";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Latitude or longitude is outside valid WGS 84 range.";
+    readonly recovery: "Latitude must be between −90 and 90; longitude between −180 and 180.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]>;
+//# sourceMappingURL=wikipedia-search-nearby.tool.d.ts.map

package/dist/mcp-server/tools/definitions/wikipedia-search-nearby.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-search-nearby.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/wikipedia-search-nearby.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8JhC,CAAC"}

package/dist/mcp-server/tools/definitions/wikipedia-search-nearby.tool.js

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview wikipedia_search_nearby tool — find geotagged Wikipedia articles near a coordinate.
+ * @module mcp-server/tools/definitions/wikipedia-search-nearby.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getWikipediaService } from '../../../services/wikipedia/wikipedia-service.js';
+export const wikipediaSearchNearby = tool('wikipedia_search_nearby', {
+    title: 'Search Wikipedia Nearby',
+    description: 'Find Wikipedia articles about places near a geographic coordinate. Returns articles sorted by distance from the query point, with titles, page IDs, coordinates, and distance in meters. Useful for "what is notable near X?" research workflows. Only articles with geographic coordinates in their Wikidata record are returned — not all articles about locations are geotagged.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        latitude: z.number().describe('WGS 84 latitude in decimal degrees (range: −90 to 90).'),
+        longitude: z.number().describe('WGS 84 longitude in decimal degrees (range: −180 to 180).'),
+        radius_meters: z
+            .number()
+            .int()
+            .min(1)
+            .default(1000)
+            .describe('Search radius in meters (default 1000, max 10000). Must be a positive integer.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .default(10)
+            .describe('Maximum number of results to return (default 10, max 50). Must be a positive integer.'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Wikipedia language edition code (default "en"). Examples: "fr", "de", "ja".'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            title: z.string().describe('Article title (e.g. "Eiffel Tower").'),
+            pageid: z.number().describe('Wikipedia page ID — use as input to other tools.'),
+            latitude: z.number().describe('Article subject latitude in decimal degrees.'),
+            longitude: z.number().describe('Article subject longitude in decimal degrees.'),
+            distance_meters: z.number().describe('Distance from the query coordinate in meters.'),
+        })
+            .describe('A single geotagged article result.'))
+            .describe('Geotagged articles sorted ascending by distance_meters.'),
+        total_results: z.number().describe('Number of results returned.'),
+        query_latitude: z.number().describe('Latitude used for the search.'),
+        query_longitude: z.number().describe('Longitude used for the search.'),
+        radius_meters_used: z.number().describe('Radius in meters used for the search.'),
+        language: z.string().describe('Language edition queried.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No geotagged articles found within the search radius.',
+            recovery: 'Increase radius_meters or verify the coordinates are correct and retry.',
+        },
+        {
+            reason: 'invalid_coordinates',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Latitude or longitude is outside valid WGS 84 range.',
+            recovery: 'Latitude must be between −90 and 90; longitude between −180 and 180.',
+        },
+        {
+            reason: 'invalid_language',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The language code is not a valid BCP 47 code.',
+            recovery: 'Use a valid BCP 47 language code such as "fr", "de", or "ja".',
+        },
+    ],
+    async handler(input, ctx) {
+        // Validate coordinate ranges
+        if (input.latitude < -90 || input.latitude > 90) {
+            throw ctx.fail('invalid_coordinates', `Latitude ${input.latitude} is out of range (−90 to 90).`, {
+                latitude: input.latitude,
+                ...ctx.recoveryFor('invalid_coordinates'),
+            });
+        }
+        if (input.longitude < -180 || input.longitude > 180) {
+            throw ctx.fail('invalid_coordinates', `Longitude ${input.longitude} is out of range (−180 to 180).`, { longitude: input.longitude, ...ctx.recoveryFor('invalid_coordinates') });
+        }
+        const radiusMeters = Math.min(input.radius_meters, 10_000);
+        const limit = Math.min(input.limit, 50);
+        const { language } = input;
+        if (!/^[a-z]{2,3}(-[a-z0-9]+)*$/i.test(language)) {
+            throw ctx.fail('invalid_language', `Invalid language code "${language}". Use a BCP 47 language code such as "fr", "de", or "ja".`, { language, ...ctx.recoveryFor('invalid_language') });
+        }
+        ctx.log.info('Geo search', {
+            latitude: input.latitude,
+            longitude: input.longitude,
+            radiusMeters,
+            limit,
+            language,
+        });
+        const svc = getWikipediaService();
+        const { results } = await svc.searchNearby(input.latitude, input.longitude, radiusMeters, limit, language, ctx);
+        if (results.length === 0) {
+            throw ctx.fail('no_results', `No geotagged Wikipedia articles found within ${radiusMeters}m of (${input.latitude}, ${input.longitude}).`, {
+                latitude: input.latitude,
+                longitude: input.longitude,
+                radiusMeters,
+                recovery: {
+                    hint: `Increase radius_meters beyond ${radiusMeters} or verify the coordinates are correct.`,
+                },
+            });
+        }
+        ctx.log.info('Geo search complete', { count: results.length, language });
+        return {
+            results,
+            total_results: results.length,
+            query_latitude: input.latitude,
+            query_longitude: input.longitude,
+            radius_meters_used: radiusMeters,
+            language,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.total_results} articles** near (${result.query_latitude}, ${result.query_longitude}) within ${result.radius_meters_used}m (${result.language})\n`,
+        ];
+        for (const item of result.results) {
+            lines.push(`### ${item.title}`);
+            lines.push(`**Page ID:** ${item.pageid} | **Distance:** ${item.distance_meters}m | **Coords:** (${item.latitude}, ${item.longitude})`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=wikipedia-search-nearby.tool.js.map

package/dist/mcp-server/tools/definitions/wikipedia-search-nearby.tool.js.map

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