afpnews-mcp-server 1.3.10 → 1.3.11

package/build/prompts/comprehensive-analysis.js

@@ -6,19 +6,17 @@ export const comprehensiveAnalysisPrompt = {
     argsSchema: {
         query: z.string().describe("The topic or query to analyze (e.g. 'climate change', 'French elections')"),
     },
-    handler: async ({ query }) => {
-        return {
-            messages: [{
-                    role: 'user',
-                    content: {
-                        type: 'text',
-                        text: `Perform an in-depth analysis on "${query}":
+    handler: async ({ query }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Perform an in-depth analysis on "${query}":
 1. Use afp_search_articles to find recent articles about "${query}" (size: 10).
 2. Use afp_find_similar on the most relevant article to find related coverage.
 3. Use afp_get_article to retrieve the full text of the most important articles.
 4. Synthesize the information from these articles to write a comprehensive analysis covering: key facts, timeline, different angles, and outlook.`,
-                    },
-                }],
-        };
-    },
+                },
+            }],
+    }),
 };

package/build/prompts/country-news.js

@@ -7,15 +7,13 @@ export const countryNewsPrompt = {
         country: z.string().describe("Country code (e.g. 'fra', 'usa', 'gbr')"),
         lang: z.string().optional().describe("Language (e.g. 'en', 'fr'). Default: 'fr'"),
     },
-    handler: async ({ country, lang = 'fr' }) => {
-        return {
-            messages: [{
-                    role: 'user',
-                    content: {
-                        type: 'text',
-                        text: `Use afp_search_articles to find recent news for country "${country}" (lang: ["${lang}"], country: ["${country}"], size: 15). Write a news summary for this country covering the main stories of the day.`,
-                    },
-                }],
-        };
-    },
+    handler: async ({ country, lang = 'fr' }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Use afp_search_articles to find recent news for country "${country}" (facets: { lang: ["${lang}"], country: ["${country}"] }, size: 15). Write a news summary for this country covering the main stories of the day.`,
+                },
+            }],
+    }),
 };

package/build/prompts/daily-briefing.js

@@ -14,7 +14,7 @@ export const dailyBriefingPrompt = {
                     role: 'user',
                     content: {
                         type: 'text',
-                        text: `Use the afp_search_articles tool to find today's most important news (dateFrom: "${today}", lang: ["${l}"], size: 15, sortOrder: "desc"). Then write a concise daily briefing summarizing the key stories, grouped by theme.`,
+                        text: `Use the afp_search_articles tool to find today's most important news (facets: { dateFrom: "${today}", lang: ["${l}"] }, size: 15, sortOrder: "desc"). Then write a concise daily briefing summarizing the key stories, grouped by theme.`,
                     },
                 }],
         };

package/build/prompts/factcheck.js

@@ -6,18 +6,16 @@ export const factcheckPrompt = {
     argsSchema: {
         query: z.string().describe("The topic or query to verify (e.g. 'climate change', 'French elections')"),
     },
-    handler: async ({ query }) => {
-        return {
-            messages: [{
-                    role: 'user',
-                    content: {
-                        type: 'text',
-                        text: `Factcheck the following query: "${query}":
-1. Use afp_search_articles to find recent factchecks related to "${query}" (genreid:"afpattribute:FactcheckInvestigation") (size: 10).
+    handler: async ({ query }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Factcheck the following query: "${query}":
+1. Use afp_search_articles to find recent factchecks related to "${query}" (facets: { genreid: "afpattribute:FactcheckInvestigation" }, size: 10).
 2. For each relevant factcheck, use afp_get_article to retrieve the full text.
 3. Summarize the findings, including: what is being claimed, what the factcheck verdict is, and the evidence provided.`,
-                    },
-                }],
-        };
-    },
+                },
+            }],
+    }),
 };

package/build/server.js

@@ -1,8 +1,10 @@
+import { createRequire } from 'node:module';
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ApiCore } from "afpnews-api";
 import { registerTools } from "./tools/index.js";
 import { registerResources } from "./resources/index.js";
 import { registerPrompts } from "./prompts/index.js";
+const { version } = createRequire(import.meta.url)('../package.json');
 export async function createServer({ apiKey, username, password, baseUrl, }) {
     if (!apiKey || !username || !password) {
         throw new Error("Missing authentication configuration. Provide APICORE_API_KEY, APICORE_USERNAME and APICORE_PASSWORD.");
@@ -11,7 +13,7 @@ export async function createServer({ apiKey, username, password, baseUrl, }) {
     await apicore.authenticate({ username, password });
     const server = new McpServer({
         name: "afpnews",
-        version: "1.3.9",
+        version,
     });
     const ctx = { server, apicore };
     registerTools(ctx);

package/build/tools/find-similar.js

@@ -1,6 +1,14 @@
 import { z } from 'zod';
-import { formatDocumentsAsJson, formatDocumentsAsCsv, textContent, toolError, truncateIfNeeded, } from '../utils/format.js';
-import { formatDocuments, formatErrorMessage, langEnum, outputFormatEnum, docFieldEnum, DEFAULT_OUTPUT_FIELDS, UNO_FORMAT_NOTE, } from './shared.js';
+import { textContent, toolError, formatDocumentOutput } from '../utils/format.js';
+import { DEFAULT_OUTPUT_FIELDS } from '../utils/types.js';
+import { formatErrorMessage, langEnum, outputFormatEnum, docFieldEnum, UNO_FORMAT_NOTE, } from './shared.js';
+const 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)'),
+    format: outputFormatEnum.optional().describe('Output format: markdown (default, with article excerpt), json (structured, no body), csv (tabular, no body).'),
+    fields: docFieldEnum.array().optional().describe('Fields to include in json/csv output. Default: afpshortid, uno, headline, published, lang, genre.'),
+});
 export const afpFindSimilarTool = {
     name: 'afp_find_similar',
     title: 'Find Similar AFP Articles',
@@ -24,31 +32,18 @@ Returns:
 Examples:
   - Find similar articles in French: { uno: "newsml.afp.com.20260222T090659Z.doc-98hu39e", lang: "fr" }
   - Export similar as CSV: { uno: "newsml.afp.com.20260222T090659Z.doc-98hu39e", lang: "en", format: "csv", fields: ["uno", "headline"] }`,
-    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)'),
-        format: outputFormatEnum.optional().describe('Output format: markdown (default, with article excerpt), json (structured, no body), csv (tabular, no body).'),
-        fields: docFieldEnum.array().optional().describe('Fields to include in json/csv output. Default: afpshortid, uno, headline, published, lang, genre.'),
-    }),
+    inputSchema,
     handler: async (apicore, { uno, lang, size, format = 'markdown', fields }) => {
         try {
             const { documents, count } = await apicore.mlt(uno, lang, size);
             if (count === 0) {
                 return { content: [textContent('No similar articles found.')] };
             }
-            const outputFields = fields ?? DEFAULT_OUTPUT_FIELDS;
-            if (format === 'json') {
-                return { content: [formatDocumentsAsJson(documents, outputFields, { total: count })] };
-            }
-            if (format === 'csv') {
-                return { content: [formatDocumentsAsCsv(documents, outputFields)] };
-            }
-            const content = [
-                textContent(`*Found ${count} similar articles.*`),
-                ...formatDocuments(documents, false),
-            ];
-            return { content: truncateIfNeeded(content) };
+            return formatDocumentOutput(documents, format, {
+                fields: fields ?? [...DEFAULT_OUTPUT_FIELDS],
+                jsonMeta: { total: count },
+                markdownPrefix: [textContent(`*Found ${count} similar articles.*`)],
+            });
         }
         catch (error) {
             return toolError(formatErrorMessage(`finding similar articles for "${uno}"`, error, 'Verify the UNO identifier is correct.'));

package/build/tools/get-article.js

@@ -1,6 +1,9 @@
 import { z } from 'zod';
 import { formatFullArticle, toolError } from '../utils/format.js';
 import { formatErrorMessage, UNO_FORMAT_NOTE } from './shared.js';
+const inputSchema = z.object({
+    uno: z.string().describe('The unique UNO identifier of the article'),
+});
 export const afpGetArticleTool = {
     name: 'afp_get_article',
     title: 'Get AFP Article',
@@ -30,9 +33,7 @@ Returns:
 
 Example:
   { uno: "newsml.afp.com.20260222T090659Z.doc-98hu39e" }`,
-    inputSchema: z.object({
-        uno: z.string().describe('The unique UNO identifier of the article'),
-    }),
+    inputSchema,
     handler: async (apicore, { uno }) => {
         try {
             const doc = await apicore.get(uno);

package/build/tools/list-facets.js

@@ -1,6 +1,13 @@
 import { z } from 'zod';
-import { textContent, toolError } from '../utils/format.js';
+import { escapeCsvValue, textContent, toolError, truncateToLimit, TRUNCATION_HINT } from '../utils/format.js';
 import { formatErrorMessage, langEnum, listPresetEnum, outputFormatEnum, } from './shared.js';
+const 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'),
+    format: outputFormatEnum.optional().describe('Output format: markdown (default), json, or csv.'),
+});
 export const afpListFacetsTool = {
     name: 'afp_list_facets',
     title: 'List AFP Facet Values',
@@ -23,13 +30,7 @@ Examples:
   - Trending topics in English: { preset: "trending-topics", lang: "en" }
   - List available genres as CSV: { facet: "genre", format: "csv" }
   - List countries as JSON: { facet: "country", size: 30, format: "json" }`,
-    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'),
-        format: outputFormatEnum.optional().describe('Output format: markdown (default), json, or csv.'),
-    }),
+    inputSchema,
     handler: async (apicore, { preset, facet, lang, size, format = 'markdown' }) => {
         try {
             const isTrendingTopics = preset === 'trending-topics';
@@ -37,23 +38,29 @@ Examples:
             if (!resolvedFacet) {
                 return toolError("Missing required parameter: facet (e.g. 'slug', 'genre', 'country'). Alternatively, use preset: 'trending-topics'.");
             }
+            const resolvedSize = size ?? 10;
             const params = isTrendingTopics
-                ? { langs: [lang ?? 'fr'], product: ['news'], dateFrom: 'now-1d', size: size ?? 10 }
-                : (lang ? { langs: [lang], size: size ?? 10 } : { size: size ?? 10 });
+                ? { langs: [lang ?? 'fr'], product: ['news'], dateFrom: 'now-1d', size: resolvedSize }
+                : { ...(lang ? { langs: [lang] } : {}), size: resolvedSize };
             const rawResult = await apicore.list(resolvedFacet, params, 1);
             const results = rawResult?.keywords ?? rawResult ?? [];
             if (results.length === 0) {
                 return { content: [textContent(`No facet values found for "${resolvedFacet}".`)] };
             }
             if (format === 'json') {
-                return { content: [textContent(JSON.stringify(results, null, 2))] };
+                const { text, truncated } = truncateToLimit(results, (slice) => JSON.stringify(slice, null, 2));
+                const content = [textContent(text)];
+                if (truncated)
+                    content.push(textContent(TRUNCATION_HINT));
+                return { content };
             }
             if (format === 'csv') {
-                const rows = results.map(r => {
-                    const name = /[",\n\r]/.test(r.name) ? `"${r.name.replaceAll('"', '""')}"` : r.name;
-                    return `${name},${r.count}`;
-                });
-                return { content: [textContent(['name,count', ...rows].join('\n'))] };
+                const rows = results.map(r => `${escapeCsvValue(r.name)},${r.count}`);
+                const { text, truncated } = truncateToLimit(rows, (slice) => ['name,count', ...slice].join('\n'));
+                const content = [textContent(text)];
+                if (truncated)
+                    content.push(textContent(TRUNCATION_HINT));
+                return { content };
             }
             const heading = isTrendingTopics ? 'Trending Topics' : `Facet: ${resolvedFacet}`;
             const lines = results.map((item) => `- **${item.name}** — ${item.count} articles`);

package/build/tools/search-articles.js

@@ -1,7 +1,51 @@
 import { z } from 'zod';
-import { DEFAULT_FIELDS, GENRE_EXCLUSIONS, formatDocumentsAsJson, formatDocumentsAsCsv, textContent, toolError, truncateIfNeeded, buildPaginationLine, } from '../utils/format.js';
-import { DEFAULT_SEARCH_SIZE } from '../utils/types.js';
-import { SEARCH_PRESETS, formatErrorMessage, formatDocuments, langEnum, searchPresetEnum, outputFormatEnum, docFieldEnum, DEFAULT_OUTPUT_FIELDS, UNO_FORMAT_NOTE, } from './shared.js';
+import { MARKDOWN_API_FIELDS, textContent, toolError, buildPaginationLine, formatDocumentOutput, } from '../utils/format.js';
+import { DEFAULT_SEARCH_SIZE, DEFAULT_OUTPUT_FIELDS } from '../utils/types.js';
+import { SEARCH_PRESETS, GENRE_EXCLUSIONS, formatErrorMessage, searchPresetEnum, outputFormatEnum, docFieldEnum, UNO_FORMAT_NOTE, } from './shared.js';
+const facetParamValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.string().array(),
+    z.number().array(),
+    z.object({
+        in: z.union([z.string().array(), z.number().array()]).optional(),
+        exclude: z.union([z.string().array(), z.number().array()]).optional(),
+    }).refine((value) => value.in !== undefined || value.exclude !== undefined, {
+        message: "Facet filter object must include either 'in' or 'exclude'.",
+    }),
+]);
+const reservedFacetKeys = new Set([
+    'preset',
+    'format',
+    'fields',
+    'fullText',
+    'query',
+    'size',
+    'sortOrder',
+    'offset',
+    'facets',
+]);
+const inputSchema = z.object({
+    preset: searchPresetEnum.optional().describe('Optional preset that applies predefined AFP filters. Available presets: a-la-une, agenda, previsions, major-stories.'),
+    format: outputFormatEnum.optional().describe('Output format: markdown (default, with article body), json (structured, no body), csv (tabular, no body).'),
+    fields: docFieldEnum.array().optional().describe('Fields to include in json/csv output. Default: afpshortid, uno, headline, published, lang, genre.'),
+    fullText: z.boolean().optional().describe('When true, returns the full article body (markdown only). Default is false. Presets override to true.'),
+    query: z.string().optional().describe("List of keywords to search for in the news articles (e.g. 'climate change'). If not specified, the search will be performed in all languages."),
+    size: z.number().optional().describe('Number of results to return (default 10, max 1000)'),
+    sortOrder: z.enum(['asc', 'desc']).optional().describe("Sort order by date (default 'desc')"),
+    offset: z.number().optional().describe('Offset for pagination (number of results to skip)'),
+    facets: z.record(z.string(), facetParamValueSchema).optional().describe("Facet filters passed to the AFP query (e.g. { lang: ['fr'], dateFrom: '2026-01-01', dateTo: '2026-01-31', country: ['usa'], genre: 'Papier général', urgency: 1 })."),
+}).strict().superRefine((value, ctx) => {
+    for (const key of Object.keys(value.facets ?? {})) {
+        if (reservedFacetKeys.has(key)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['facets', key],
+                message: `Facet key "${key}" is reserved and must be provided at top-level.`,
+            });
+        }
+    }
+});
 export const afpSearchArticlesTool = {
     name: 'afp_search_articles',
     title: 'Search AFP News Articles',
@@ -15,15 +59,11 @@ Args:
   - fields: Fields to include in json/csv output (default: uno, headline, lang, genre).
             Available: uno, headline, lang, genre, afpshortid, published, status, signal, advisory, country, city, slug, product, revision, created.
   - fullText: Return full article body (true) or excerpt only (false, default). Only applies to markdown. Presets override to true.
-  - query: Search keywords in the language specified by 'lang' (e.g. 'climate change')
-  - lang: Article language filter (e.g. ['en', 'fr']). Use ['en'] for photos.
-  - dateFrom/dateTo: Date range in ISO format (e.g. '2025-01-01') or relative ('now-1d')
+  - query: Search keywords (e.g. 'climate change')
   - size: Number of results (default 10, max 1000)
   - sortOrder: 'asc' or 'desc' by date (default 'desc')
   - offset: Pagination offset (number of results to skip)
-  - country: Country code filter (e.g. ['fra', 'usa'])
-  - slug: Topic/slug filter (e.g. ['economy', 'sports'])
-  - product: Content type filter (default ['news', 'factcheck'])
+  - facets: All facet filters as key/value pairs (e.g. { lang: ['fr'], dateFrom: '2026-01-01', dateTo: '2026-01-31', country: ['usa'], genre: 'Papier général', urgency: 1 })
 
 Returns:
   - markdown: Pagination summary line + formatted articles with headline, metadata, body
@@ -31,64 +71,43 @@ Returns:
   - csv: Header row + data rows with selected fields
 
 Examples:
-  - Latest Ukraine news: { query: "Ukraine", lang: ["en"], size: 5 }
+  - Latest Ukraine news: { query: "Ukraine", facets: { lang: ["en"] }, size: 5 }
   - French front page: { preset: "a-la-une" }
   - Export metadata as CSV: { query: "economy", format: "csv", fields: ["uno", "headline", "country"] }`,
-    inputSchema: z.object({
-        preset: searchPresetEnum.optional().describe('Optional preset that applies predefined AFP filters. Available presets: a-la-une, agenda, previsions, major-stories.'),
-        format: outputFormatEnum.optional().describe('Output format: markdown (default, with article body), json (structured, no body), csv (tabular, no body).'),
-        fields: docFieldEnum.array().optional().describe('Fields to include in json/csv output. Default: afpshortid, uno, headline, published, lang, genre.'),
-        fullText: z.boolean().optional().describe('When true, returns the full article body (markdown only). Default is false. Presets override 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."),
-        lang: langEnum.array().optional().describe("Language of the news articles (e.g. 'en', 'fr'). Always use 'en' if you look for photos."),
-        dateFrom: z.string().optional().describe("Start date for the search in ISO format (e.g. '2023-01-01') or relative (e.g. 'now-1d')"),
-        dateTo: z.string().optional().describe("End date for the search in ISO format (e.g. '2023-12-31')"),
-        size: z.number().optional().describe('Number of results to return (default 10, max 1000)'),
-        sortOrder: z.enum(['asc', 'desc']).optional().describe("Sort order by date (default 'desc')"),
-        offset: z.number().optional().describe('Offset for pagination (number of results to skip)'),
-        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, format = 'markdown', fields, fullText = false, query, lang, dateFrom, dateTo, size = DEFAULT_SEARCH_SIZE, sortOrder = 'desc', offset, country, slug, product = ['news', 'factcheck'] }) => {
+    inputSchema,
+    handler: async (apicore, { preset, format = 'markdown', fields, fullText = false, query, size = DEFAULT_SEARCH_SIZE, sortOrder = 'desc', offset, facets }) => {
         try {
+            const facetFilters = {
+                product: ['news', 'factcheck'],
+                genreid: GENRE_EXCLUSIONS,
+                ...(facets ?? {}),
+            };
             let request = {
                 query,
-                lang,
-                product,
-                dateFrom,
-                dateTo,
                 size,
                 sortOrder,
                 startAt: offset,
-                country,
-                slug,
-                genreid: GENRE_EXCLUSIONS,
+                ...facetFilters,
             };
             if (preset) {
                 request = { ...request, ...SEARCH_PRESETS[preset] };
                 fullText = true;
             }
-            const outputFields = fields ?? DEFAULT_OUTPUT_FIELDS;
+            const outputFields = fields ?? [...DEFAULT_OUTPUT_FIELDS];
             const apiFields = format === 'markdown'
-                ? [...DEFAULT_FIELDS]
+                ? [...MARKDOWN_API_FIELDS]
                 : [...new Set(['afpshortid', 'uno', ...outputFields])];
             const { documents, count } = await apicore.search(request, apiFields);
             if (count === 0) {
                 return { content: [textContent('No results found.')] };
             }
             const currentOffset = offset ?? 0;
-            if (format === 'json') {
-                return { content: [formatDocumentsAsJson(documents, outputFields, { total: count, shown: documents.length, offset: currentOffset })] };
-            }
-            if (format === 'csv') {
-                return { content: [formatDocumentsAsCsv(documents, outputFields)] };
-            }
-            const content = [
-                textContent(buildPaginationLine(documents.length, count, currentOffset)),
-                ...formatDocuments(documents, fullText),
-            ];
-            return { content: truncateIfNeeded(content) };
+            return formatDocumentOutput(documents, format, {
+                fields: outputFields,
+                fullText,
+                jsonMeta: { total: count, offset: currentOffset },
+                markdownPrefix: [textContent(buildPaginationLine(documents.length, count, currentOffset))],
+            });
         }
         catch (error) {
             return toolError(formatErrorMessage('searching AFP articles', error, 'Check your query parameters and try again.'));

package/build/tools/shared.js

@@ -1,7 +1,5 @@
 import { z } from 'zod';
-import { formatDocument, GENRE_EXCLUSIONS, } from '../utils/format.js';
-import { ALL_DOC_FIELDS, DEFAULT_OUTPUT_FIELDS } from '../utils/types.js';
-export { ALL_DOC_FIELDS, DEFAULT_OUTPUT_FIELDS };
+import { ALL_DOC_FIELDS } from '../utils/types.js';
 // UNO format: newsml.afp.com.20260222T090659Z.doc-98hu39e
 //   - timestamp: 20260222T090659Z → 2026-02-22 09:06:59 UTC
 //   - afpshortid: the segment after "doc-" (e.g. 98hu39e)
@@ -23,6 +21,18 @@ export const READ_ONLY_ANNOTATIONS = {
     idempotentHint: true,
     openWorldHint: true,
 };
+export const GENRE_EXCLUSIONS = {
+    exclude: [
+        'afpgenre:Agenda',
+        'afpattribute:Agenda',
+        'afpattribute:Program',
+        'afpattribute:TextProgram',
+        'afpattribute:AdvisoryUpdate',
+        'afpattribute:Advice',
+        'afpattribute:SpecialAnnouncement',
+        'afpattribute:PictureProgram',
+    ],
+};
 export const SEARCH_PRESETS = {
     'a-la-une': {
         product: ['news'],
@@ -51,6 +61,3 @@ export function formatErrorMessage(context, error, hint) {
     const message = error instanceof Error ? error.message : String(error);
     return `Error ${context}: ${message}. ${hint}`;
 }
-export function formatDocuments(documents, fullText) {
-    return documents.map((doc) => formatDocument(doc, fullText));
-}

package/build/utils/format.js

@@ -1,5 +1,8 @@
 import { EXCERPT_PARAGRAPH_COUNT, CHARACTER_LIMIT } from './types.js';
-function escapeCsvValue(value) {
+export const TRUNCATION_HINT = `\n\n---\n*Response truncated (exceeded ${CHARACTER_LIMIT} characters). Use a smaller \`size\` or add filters to reduce results.*`;
+/** Fields requested from the API when rendering markdown output. */
+export const MARKDOWN_API_FIELDS = ['uno', 'status', 'signal', 'advisory', 'headline', 'news', 'lang', 'genre'];
+export function escapeCsvValue(value) {
     const str = Array.isArray(value) ? value.join('|') : String(value ?? '');
     if (/[",\n\r]/.test(str))
         return `"${str.replaceAll('"', '""')}"`;
@@ -9,27 +12,45 @@ export function pickDocFields(doc, fields) {
     const d = doc;
     return Object.fromEntries(fields.map(f => [f, d[f] ?? null]));
 }
-export function formatDocumentsAsJson(docs, fields, meta = {}) {
+/**
+ * Truncate an array of items so the serialized output fits within CHARACTER_LIMIT.
+ * Uses binary search O(log n) when truncation is needed.
+ */
+export function truncateToLimit(items, serialize) {
+    const full = serialize(items);
+    if (full.length <= CHARACTER_LIMIT) {
+        return { text: full, count: items.length, truncated: false };
+    }
+    let lo = 0;
+    let hi = items.length;
+    while (lo < hi) {
+        const mid = Math.ceil((lo + hi) / 2);
+        if (serialize(items.slice(0, mid)).length <= CHARACTER_LIMIT) {
+            lo = mid;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    return { text: serialize(items.slice(0, lo)), count: lo, truncated: true };
+}
+function formatDocumentsAsJsonInner(docs, fields, meta = {}) {
     const documents = docs.map(doc => pickDocFields(doc, fields));
-    return textContent(JSON.stringify({ ...meta, documents }, null, 2));
+    const { text, count, truncated } = truncateToLimit(documents, (slice) => JSON.stringify({ ...meta, shown: slice.length, truncated: slice.length < documents.length, documents: slice }, null, 2));
+    return { content: textContent(text), truncated };
 }
-export function formatDocumentsAsCsv(docs, fields) {
+function formatDocumentsAsCsvInner(docs, fields) {
     const rows = docs.map(doc => fields.map(f => escapeCsvValue(doc[f])).join(','));
-    return textContent([fields.join(','), ...rows].join('\n'));
+    const header = fields.join(',');
+    const { text, truncated } = truncateToLimit(rows, (slice) => [header, ...slice].join('\n'));
+    return { content: textContent(text), truncated };
+}
+export function formatDocumentsAsJson(docs, fields, meta = {}) {
+    return formatDocumentsAsJsonInner(docs, fields, meta).content;
+}
+export function formatDocumentsAsCsv(docs, fields) {
+    return formatDocumentsAsCsvInner(docs, fields).content;
 }
-export const GENRE_EXCLUSIONS = {
-    exclude: [
-        'afpgenre:Agenda',
-        'afpattribute:Agenda',
-        'afpattribute:Program',
-        'afpattribute:TextProgram',
-        'afpattribute:AdvisoryUpdate',
-        'afpattribute:Advice',
-        'afpattribute:SpecialAnnouncement',
-        'afpattribute:PictureProgram'
-    ]
-};
-export const DEFAULT_FIELDS = ['uno', 'status', 'signal', 'advisory', 'headline', 'news', 'lang', 'genre'];
 export function formatDocument(doc, fullText = false) {
     const d = doc;
     const meta = [
@@ -47,8 +68,7 @@ export function formatDocument(doc, fullText = false) {
     const body = fullText
         ? paragraphs.join('\n\n')
         : paragraphs.slice(0, EXCERPT_PARAGRAPH_COUNT).join('\n\n');
-    const text = `## ${d.headline}\n*${meta.join(' | ')}*\n\n${body}`;
-    return { type: 'text', text };
+    return textContent(`## ${d.headline}\n*${meta.join(' | ')}*\n\n${body}`);
 }
 export function formatFullArticle(doc) {
     const d = doc;
@@ -67,7 +87,32 @@ export function formatFullArticle(doc) {
         lines.push(flags);
     const meta = lines.join('\n');
     const body = (Array.isArray(d.news) ? d.news : []).join('\n\n');
-    return { type: 'text', text: `## ${d.headline}\n\n${meta}\n\n---\n\n${body}` };
+    return textContent(`## ${d.headline}\n\n${meta}\n\n---\n\n${body}`);
+}
+/**
+ * Unified output formatter for multi-document tool results.
+ * Handles json/csv/markdown branching in one place.
+ */
+export function formatDocumentOutput(documents, format, opts) {
+    if (format === 'json') {
+        const { content, truncated } = formatDocumentsAsJsonInner(documents, opts.fields, opts.jsonMeta);
+        const result = [content];
+        if (truncated)
+            result.push(textContent(TRUNCATION_HINT));
+        return { content: result };
+    }
+    if (format === 'csv') {
+        const { content, truncated } = formatDocumentsAsCsvInner(documents, opts.fields);
+        const result = [content];
+        if (truncated)
+            result.push(textContent(TRUNCATION_HINT));
+        return { content: result };
+    }
+    const content = [
+        ...(opts.markdownPrefix ?? []),
+        ...documents.map(doc => formatDocument(doc, opts.fullText ?? false)),
+    ];
+    return { content: truncateIfNeeded(content) };
 }
 export function textContent(text) {
     return { type: 'text', text };
@@ -75,7 +120,7 @@ export function textContent(text) {
 export function toolError(message) {
     return {
         isError: true,
-        content: [textContent(message)]
+        content: [textContent(message)],
     };
 }
 export function truncateIfNeeded(content) {
@@ -95,7 +140,7 @@ export function truncateIfNeeded(content) {
         truncated.push(item);
         accumulated += item.text.length;
     }
-    truncated.push(textContent(`\n\n---\n*Response truncated (exceeded ${CHARACTER_LIMIT} characters). Use a smaller \`size\` or add filters to reduce results.*`));
+    truncated.push(textContent(TRUNCATION_HINT));
     return truncated;
 }
 export function buildPaginationLine(shown, total, offset) {

package/build/utils/topics.js

@@ -117,16 +117,3 @@ export const TOPICS = {
         { label: "معرض الصور", value: "ONLINE-NEWS-AR_PHO-GAL" },
     ],
 };
-export function getTopicLabel(value) {
-    for (const topics of Object.values(TOPICS)) {
-        const topic = topics.find(t => t.value === value);
-        if (topic)
-            return topic.label;
-    }
-    return undefined;
-}
-export function formatTopicList() {
-    return Object.entries(TOPICS)
-        .map(([lang, topics]) => `${lang}: ${topics.map(t => `${t.label} (${t.value})`).join(', ')}`)
-        .join('\n');
-}

package/build/utils/types.js

@@ -1,7 +1,6 @@
 export const EXCERPT_PARAGRAPH_COUNT = 4;
 export const CHARACTER_LIMIT = 25_000;
 export const DEFAULT_SEARCH_SIZE = 10;
-export const DEFAULT_FACET_SIZE = 20;
 export const ALL_DOC_FIELDS = [
     'afpshortid', 'uno', 'headline', 'published', 'lang', 'genre',
     'status', 'signal', 'advisory', 'country', 'city', 'slug', 'product', 'revision', 'created',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afpnews-mcp-server",
-  "version": "1.3.10",
+  "version": "1.3.11",
   "description": "",
   "main": "build/index.js",
   "type": "module",
@@ -8,11 +8,6 @@
     ".": "./build/index.js",
     "./definitions": "./build/definitions.js"
   },
-  "scripts": {
-    "build": "tsc && chmod 755 build/index.js",
-    "start": "node build/index.js",
-    "test": "vitest run"
-  },
   "bin": {
     "search": "./build/index.js"
   },
@@ -22,7 +17,6 @@
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "packageManager": "pnpm@10.29.3",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "afpnews-api": "^2.4.0",
@@ -35,5 +29,11 @@
     "@types/node": "^25.2.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "clean": "rm -rf build",
+    "build": "pnpm run clean && tsc && chmod 755 build/index.js",
+    "start": "node build/index.js",
+    "test": "vitest run"
   }
-}
+}