afpnews-mcp-server 1.3.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afpnews-mcp-server",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "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.');
-                }
-            },
-        }),
-    };
-}