afpnews-mcp-server 1.3.0 → 1.3.2

package/build/tools/find-similar.js

@@ -20,11 +20,11 @@ Returns:
 Examples:
   - Find similar articles in French: { uno: "NEWS-FR-123456-ABC", lang: "fr" }
   - Get 5 similar English articles: { uno: "NEWS-EN-789", lang: "en", size: 5 }`,
-    inputSchema: {
+    inputSchema: z.object({
         uno: z.string().describe('The UNO of the reference article'),
         lang: langEnum.describe("Language for results (e.g. 'en', 'fr')"),
         size: z.number().optional().describe('Number of similar articles to return (default 10)'),
-    },
+    }),
     handler: async (apicore, { uno, lang, size }) => {
         try {
             const { documents, count } = await apicore.mlt(uno, lang, size);

package/build/tools/get-article.js

@@ -17,9 +17,9 @@ Returns:
 
 Examples:
   - Get a specific article: { uno: "NEWS-FR-123456-ABC" }`,
-    inputSchema: {
+    inputSchema: z.object({
         uno: z.string().describe('The unique identifier (UNO) of the article'),
-    },
+    }),
     handler: async (apicore, { uno }) => {
         try {
             const doc = await apicore.get(uno);

package/build/tools/list-facets.js

@@ -23,12 +23,12 @@ Examples:
   - Trending topics in English: { preset: "trending-topics", lang: "en" }
   - List available genres: { facet: "genre" }
   - List countries: { facet: "country", size: 30 }`,
-    inputSchema: {
+    inputSchema: z.object({
         preset: listPresetEnum.optional().describe('Optional preset for list queries. Available preset: trending-topics.'),
         facet: z.string().optional().describe("Facet to list (e.g. 'slug', 'genre', 'country'). Required when no preset is used."),
         lang: langEnum.optional().describe("Language filter (e.g. 'en', 'fr')"),
         size: z.number().optional().describe('Number of facet values to return'),
-    },
+    }),
     handler: async (apicore, { preset, facet, lang, size }) => {
         try {
             const isTrendingTopics = preset === 'trending-topics';

package/build/tools/search-articles.js

@@ -31,7 +31,7 @@ Examples:
   - French front page: { preset: "a-la-une" }
   - Recent photos: { product: ["photo"], lang: ["en"], size: 5 }
   - Page 2 of results: { query: "economy", size: 10, offset: 10 }`,
-    inputSchema: {
+    inputSchema: z.object({
         preset: searchPresetEnum.optional().describe('Optional preset that applies predefined AFP filters. Available presets: a-la-une, agenda, previsions, major-stories.'),
         fullText: z.boolean().optional().describe('When true, returns the full article body. Default is false. If omitted and a preset is used, fullText defaults to true.'),
         query: z.string().optional().describe("List of keywords to search for in the news articles (e.g. 'climate change'), in the language specified by the 'lang' parameter. If not specified, the search will be performed in all languages. Do not use keywords in multiple languages."),
@@ -44,7 +44,7 @@ Examples:
         country: z.string().array().optional().describe("Country filter (e.g. 'fra', 'usa')"),
         slug: z.string().array().optional().describe("Topic/slug filter (e.g. 'economy', 'sports')"),
         product: z.enum(['news', 'factcheck', 'photo', 'video', 'multimedia', 'graphic', 'videographic']).array().optional().describe("Content type filter (default ['news', 'factcheck'])"),
-    },
+    }),
     handler: async (apicore, { preset, fullText = false, query, lang, dateFrom, dateTo, size = DEFAULT_SEARCH_SIZE, sortOrder = 'desc', offset, country, slug, product = ['news', 'factcheck'] }) => {
         try {
             let request = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afpnews-mcp-server",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "",
   "main": "build/index.js",
   "type": "module",

package/build/ai-tools.js

@@ -1,188 +0,0 @@
-import { tool } from 'ai';
-import { z } from 'zod';
-import { ApiCore } from 'afpnews-api';
-import { formatDocument, DEFAULT_FIELDS, GENRE_EXCLUSIONS, textContent, truncateIfNeeded, buildPaginationLine, } from './utils/format.js';
-import { getTopicLabel } from './utils/topics.js';
-import { DEFAULT_SEARCH_SIZE, DEFAULT_FACET_SIZE } from './utils/types.js';
-const SEARCH_PRESET_VALUES = ['a-la-une', 'agenda', 'previsions', 'major-stories'];
-const searchPresetEnum = z.enum(SEARCH_PRESET_VALUES);
-const LIST_PRESET_VALUES = ['trending-topics'];
-const listPresetEnum = z.enum(LIST_PRESET_VALUES);
-const langEnum = z.enum(['en', 'fr', 'de', 'pt', 'es', 'ar']);
-const SEARCH_PRESETS = {
-    'a-la-une': {
-        product: ['news'],
-        lang: ['fr'],
-        slug: ['afp', 'actualites'],
-        dateFrom: 'now-1d',
-        size: 1,
-        genreid: GENRE_EXCLUSIONS,
-    },
-    agenda: {
-        product: ['news'],
-        size: 5,
-        genreid: ['afpattribute:Agenda'],
-    },
-    previsions: {
-        product: ['news'],
-        size: 5,
-        genreid: ['afpattribute:Program', 'afpedtype:TextProgram'],
-    },
-    'major-stories': {
-        product: ['news'],
-        genreid: ['afpattribute:Article'],
-    },
-};
-function formatDocuments(documents, fullText) {
-    return documents.map((doc) => formatDocument(doc, fullText));
-}
-function formatErrorMessage(context, error, hint) {
-    const message = error instanceof Error ? error.message : String(error);
-    return `Error ${context}: ${message}. ${hint}`;
-}
-function contentToText(content) {
-    return content.map((c) => c.text).join('\n\n');
-}
-const searchParameters = z.object({
-    preset: searchPresetEnum.optional().describe('Optional preset that applies predefined AFP filters.'),
-    fullText: z.boolean().optional().describe('When true, returns the full article body. Default is false.'),
-    query: z.string().optional().describe('Keywords to search for (in the language specified by lang).'),
-    lang: langEnum.array().optional().describe("Language filter (e.g. ['en', 'fr'])."),
-    dateFrom: z.string().optional().describe("Start date (ISO or relative e.g. 'now-1d')."),
-    dateTo: z.string().optional().describe('End date (ISO format).'),
-    size: z.number().optional().describe('Number of results (default 10, max 1000).'),
-    sortOrder: z.enum(['asc', 'desc']).optional().describe("Sort order by date (default 'desc')."),
-    offset: z.number().optional().describe('Pagination offset.'),
-    country: z.string().array().optional().describe("Country code filter (e.g. ['fra', 'usa'])."),
-    slug: z.string().array().optional().describe('Topic/slug filter.'),
-    product: z
-        .enum(['news', 'factcheck', 'photo', 'video', 'multimedia', 'graphic', 'videographic'])
-        .array()
-        .optional()
-        .describe("Content type filter (default ['news', 'factcheck'])."),
-});
-const getArticleParameters = z.object({
-    uno: z.string().describe('The unique identifier (UNO) of the article.'),
-});
-const findSimilarParameters = z.object({
-    uno: z.string().describe('The UNO of the reference article.'),
-    lang: langEnum.describe('Language for results.'),
-    size: z.number().optional().describe('Number of similar articles (default 10).'),
-});
-const listFacetsParameters = z.object({
-    preset: listPresetEnum.optional().describe('Optional preset (trending-topics).'),
-    facet: z
-        .string()
-        .optional()
-        .describe("Facet to list (e.g. 'slug', 'genre', 'country'). Required when no preset."),
-    lang: langEnum.optional().describe('Language filter.'),
-    size: z.number().optional().describe('Number of facet values to return.'),
-});
-export function createAiTools(token) {
-    const apicore = new ApiCore();
-    apicore.token = token;
-    return {
-        afp_search_articles: tool({
-            description: `Search AFP news articles with filters and presets.
-Args: preset (a-la-une|agenda|previsions|major-stories), fullText, query, lang, dateFrom, dateTo, size, sortOrder, offset,
-country, slug, product.
-Returns: markdown-formatted articles with headline, metadata and body.`,
-            parameters: searchParameters,
-            execute: async ({ preset, fullText = false, query, lang, dateFrom, dateTo, size = DEFAULT_SEARCH_SIZE, sortOrder = 'desc', offset, country, slug, product = ['news', 'factcheck'], }) => {
-                try {
-                    let request = {
-                        query,
-                        lang,
-                        product,
-                        dateFrom,
-                        dateTo,
-                        size,
-                        sortOrder,
-                        startAt: offset,
-                        country,
-                        slug,
-                        genreid: GENRE_EXCLUSIONS,
-                    };
-                    if (preset) {
-                        request = { ...request, ...SEARCH_PRESETS[preset] };
-                        fullText = true;
-                    }
-                    const { documents, count } = await apicore.search(request, [...DEFAULT_FIELDS]);
-                    if (count === 0)
-                        return 'No results found.';
-                    const currentOffset = offset ?? 0;
-                    const content = [
-                        textContent(buildPaginationLine(documents.length, count, currentOffset)),
-                        ...formatDocuments(documents, fullText),
-                    ];
-                    return contentToText(truncateIfNeeded(content));
-                }
-                catch (error) {
-                    return formatErrorMessage('searching AFP articles', error, 'Check your query parameters and try again.');
-                }
-            },
-        }),
-        afp_get_article: tool({
-            description: 'Get a full AFP news article by its UNO identifier.',
-            parameters: getArticleParameters,
-            execute: async ({ uno }) => {
-                try {
-                    const doc = await apicore.get(uno);
-                    return formatDocument(doc, true).text;
-                }
-                catch (error) {
-                    return formatErrorMessage(`fetching article "${uno}"`, error, 'Verify the UNO identifier is correct.');
-                }
-            },
-        }),
-        afp_find_similar: tool({
-            description: 'Find AFP articles similar to a given article (More Like This).',
-            parameters: findSimilarParameters,
-            execute: async ({ uno, lang, size }) => {
-                try {
-                    const { documents, count } = await apicore.mlt(uno, lang, size);
-                    if (count === 0)
-                        return 'No similar articles found.';
-                    const content = [textContent(`*Found ${count} similar articles.*`), ...formatDocuments(documents, false)];
-                    return contentToText(truncateIfNeeded(content));
-                }
-                catch (error) {
-                    return formatErrorMessage(`finding similar articles for "${uno}"`, error, 'Verify the UNO identifier is correct.');
-                }
-            },
-        }),
-        afp_list_facets: tool({
-            description: `List facet values and article counts. Use preset 'trending-topics' or specify a facet like 'slug',
-'genre', 'country'.`,
-            parameters: listFacetsParameters,
-            execute: async ({ preset, facet, lang, size }) => {
-                try {
-                    const isTrendingTopics = preset === 'trending-topics';
-                    const resolvedFacet = isTrendingTopics ? 'slug' : facet;
-                    if (!resolvedFacet) {
-                        return "Missing required parameter: facet (e.g. 'slug', 'genre', 'country'). Alternatively, use preset: 'trending-topics'.";
-                    }
-                    const params = isTrendingTopics
-                        ? { langs: [lang ?? 'fr'], product: ['news'], dateFrom: 'now-1d' }
-                        : lang
-                            ? { langs: [lang] }
-                            : {};
-                    const resolvedSize = isTrendingTopics ? (size ?? DEFAULT_FACET_SIZE) : size;
-                    const rawResult = await apicore.list(resolvedFacet, params, resolvedSize);
-                    const results = rawResult?.keywords ?? rawResult ?? [];
-                    if (results.length === 0)
-                        return `No facet values found for "${resolvedFacet}".`;
-                    const heading = isTrendingTopics ? 'Trending Topics' : `Facet: ${resolvedFacet}`;
-                    const lines = results.map((item) => {
-                        const label = isTrendingTopics ? (getTopicLabel(item.key) ?? item.key) : item.key;
-                        return `- **${label}** — ${item.count} articles`;
-                    });
-                    return `## ${heading}\n\n${lines.join('\n')}`;
-                }
-                catch (error) {
-                    return formatErrorMessage('listing facet values', error, 'Check that the facet name is valid.');
-                }
-            },
-        }),
-    };
-}