ris-mcp-ts 1.0.0

package/dist/formatting.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Formatting utilities for RIS MCP Server responses.
+ *
+ * This module provides functions to format RIS API responses for optimal
+ * LLM consumption, including proper Austrian legal citations, search results
+ * formatting, and document content preparation.
+ */
+import type { Document, SearchResult } from './types.js';
+/**
+ * Convert API date format to readable German format.
+ */
+export declare function formatDate(dateStr: string | null | undefined): string;
+/**
+ * Convert HTML to clean readable text using cheerio.
+ */
+export declare function htmlToText(htmlContent: string): string;
+/**
+ * Document data for citation formatting.
+ */
+interface CitationData {
+    applikation?: string;
+    titel?: string;
+    kurztitel?: string | null;
+    dokumentnummer?: string;
+    citation?: {
+        kurztitel?: string | null;
+        langtitel?: string | null;
+        kundmachungsorgan?: string | null;
+        paragraph?: string | null;
+        inkrafttreten?: string | null;
+    };
+}
+/**
+ * Format a proper Austrian legal citation.
+ */
+export declare function formatCitation(doc: Document | CitationData): string;
+/**
+ * Format search results for display.
+ */
+export declare function formatSearchResults(results: SearchResult | Record<string, unknown>, format?: 'markdown' | 'json'): string;
+/**
+ * Metadata for document formatting.
+ */
+export interface DocumentMetadata {
+    dokumentnummer?: string;
+    applikation?: string;
+    titel?: string;
+    kurztitel?: string | null;
+    citation?: {
+        kurztitel?: string | null;
+        langtitel?: string | null;
+        kundmachungsorgan?: string | null;
+        paragraph?: string | null;
+        eli?: string | null;
+        inkrafttreten?: string | null;
+        ausserkrafttreten?: string | null;
+    };
+    dokument_url?: string | null;
+    gesamte_rechtsvorschrift_url?: string | null;
+}
+/**
+ * Format a full document for LLM context.
+ */
+export declare function formatDocument(content: string, metadata: DocumentMetadata, format?: 'markdown' | 'json'): string;
+/**
+ * Truncate response if too long.
+ */
+export declare function truncateResponse(text: string, limit?: number): string;
+export {};
+//# sourceMappingURL=formatting.d.ts.map

package/dist/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../src/formatting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAYzD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAiBrE;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAuBtD;AAMD;;GAEG;AACH,UAAU,YAAY;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,CAcnE;AA6GD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,MAAM,GAAE,UAAU,GAAG,MAAmB,GACvC,MAAM,CAsBR;AA6FD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4BAA4B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,GAAE,UAAU,GAAG,MAAmB,GACvC,MAAM,CAaR;AAuFD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAkB,GAAG,MAAM,CAsC9E"}

package/dist/formatting.js

@@ -0,0 +1,366 @@
+/**
+ * Formatting utilities for RIS MCP Server responses.
+ *
+ * This module provides functions to format RIS API responses for optimal
+ * LLM consumption, including proper Austrian legal citations, search results
+ * formatting, and document content preparation.
+ */
+import * as cheerio from 'cheerio';
+// =============================================================================
+// Constants
+// =============================================================================
+const CHARACTER_LIMIT = 25000;
+// =============================================================================
+// Date Formatting
+// =============================================================================
+/**
+ * Convert API date format to readable German format.
+ */
+export function formatDate(dateStr) {
+    if (!dateStr) {
+        return '';
+    }
+    try {
+        // Handle ISO format (YYYY-MM-DD)
+        const datePart = dateStr.slice(0, 10);
+        const parts = datePart.split('-');
+        if (parts.length === 3) {
+            const [year, month, day] = parts;
+            return `${day}.${month}.${year}`;
+        }
+        return dateStr;
+    }
+    catch {
+        return dateStr;
+    }
+}
+// =============================================================================
+// HTML Processing
+// =============================================================================
+/**
+ * Convert HTML to clean readable text using cheerio.
+ */
+export function htmlToText(htmlContent) {
+    if (!htmlContent) {
+        return '';
+    }
+    const $ = cheerio.load(htmlContent);
+    // Remove script, style, and head elements
+    $('script, style, head').remove();
+    // Process the body or entire document
+    let text = $('body').length > 0 ? $('body').text() : $.text();
+    // Clean up whitespace
+    text = text
+        .replace(/\n{3,}/g, '\n\n') // Normalize multiple newlines
+        .replace(/[ \t]+/g, ' ') // Normalize multiple spaces
+        .split('\n')
+        .map((line) => line.trim())
+        .join('\n')
+        .trim();
+    return text;
+}
+/**
+ * Format a proper Austrian legal citation.
+ */
+export function formatCitation(doc) {
+    const data = doc;
+    const applikation = data.applikation ?? '';
+    const citationData = data.citation ?? {};
+    const titel = data.titel ?? '';
+    const kurztitel = data.kurztitel ?? citationData.kurztitel ?? '';
+    // Handle court decisions (Judikatur)
+    if (['Justiz', 'Vfgh', 'Vwgh', 'Bvwg', 'Lvwg', 'Dsk'].includes(applikation)) {
+        return formatCourtCitation(data, applikation, titel);
+    }
+    // Handle federal law (Bundesrecht)
+    return formatLawCitation(data, kurztitel, citationData);
+}
+/**
+ * Format citation for court decisions.
+ */
+function formatCourtCitation(data, applikation, titel) {
+    const courtPrefixes = {
+        Justiz: '',
+        Vfgh: 'VfGH',
+        Vwgh: 'VwGH',
+        Bvwg: 'BVwG',
+        Lvwg: 'LVwG',
+        Dsk: 'DSK',
+    };
+    const dokumentnummer = data.dokumentnummer ?? '';
+    // For ordinary courts
+    if (applikation === 'Justiz') {
+        // Title often contains "OGH 5 Ob 123/23t" or similar
+        const match = titel.match(/(OGH|OLG|LG|BG)\s*[,:]?\s*(\d+\s*\w+\s*\d+\/\d+\w?)/i);
+        if (match) {
+            return `${match[1]} ${match[2]}`;
+        }
+        // Try to extract from dokumentnummer
+        const dokMatch = dokumentnummer.match(/(OGH|OLG|LG|BG)\d+/i);
+        if (dokMatch) {
+            const court = dokMatch[1].toUpperCase();
+            const caseMatch = dokumentnummer.match(/_(\d+\w+)_(\d+)([A-Z])\d+_/);
+            if (caseMatch) {
+                return `${court} ${caseMatch[1]}/${caseMatch[2]}${caseMatch[3].toLowerCase()}`;
+            }
+        }
+    }
+    // For VfGH, VwGH etc.
+    const prefix = courtPrefixes[applikation] ?? '';
+    if (prefix) {
+        const dateMatch = titel.match(/(\d{1,2}\.\d{1,2}\.\d{4})/);
+        const caseMatch = titel.match(/([EGUBVW]\s*\d+\/\d+)/i);
+        if (dateMatch && caseMatch) {
+            return `${prefix} ${dateMatch[1]}, ${caseMatch[1]}`;
+        }
+        if (caseMatch) {
+            return `${prefix} ${caseMatch[1]}`;
+        }
+    }
+    // Fallback
+    if (titel.length <= 60) {
+        return titel;
+    }
+    return dokumentnummer;
+}
+/**
+ * Format citation for laws and regulations.
+ */
+function formatLawCitation(data, kurztitel, citationData) {
+    const paragraph = citationData?.paragraph ?? '';
+    const kundmachungsorgan = citationData?.kundmachungsorgan ?? '';
+    const parts = [];
+    if (paragraph) {
+        parts.push(paragraph);
+    }
+    if (kurztitel) {
+        parts.push(kurztitel);
+    }
+    if (kundmachungsorgan && kundmachungsorgan.length < 30) {
+        parts.push(`(${kundmachungsorgan})`);
+    }
+    if (parts.length > 0) {
+        return parts.join(' ');
+    }
+    return data.titel ?? data.dokumentnummer ?? '';
+}
+// =============================================================================
+// Search Results Formatting
+// =============================================================================
+/**
+ * Document to dictionary representation.
+ */
+function documentToDict(doc) {
+    return {
+        dokumentnummer: doc.dokumentnummer,
+        applikation: doc.applikation,
+        titel: doc.titel,
+        kurztitel: doc.kurztitel,
+        citation: doc.citation,
+        content_urls: doc.content_urls,
+        dokument_url: doc.dokument_url,
+        gesamte_rechtsvorschrift_url: doc.gesamte_rechtsvorschrift_url,
+    };
+}
+/**
+ * Format search results for display.
+ */
+export function formatSearchResults(results, format = 'markdown') {
+    let data;
+    if ('documents' in results && Array.isArray(results.documents)) {
+        // It's a SearchResult
+        const sr = results;
+        data = {
+            total_hits: sr.total_hits,
+            page: sr.page,
+            page_size: sr.page_size,
+            has_more: sr.has_more,
+            documents: sr.documents.map(documentToDict),
+        };
+    }
+    else {
+        data = results;
+    }
+    if (format === 'json') {
+        return JSON.stringify(data, null, 2);
+    }
+    return formatSearchResultsMarkdown(data);
+}
+/**
+ * Format search results as markdown.
+ */
+function formatSearchResultsMarkdown(data) {
+    const totalHits = data.total_hits ?? 0;
+    const page = data.page ?? 1;
+    const pageSize = data.page_size ?? 20;
+    const hasMore = data.has_more ?? false;
+    const documents = data.documents ?? [];
+    const totalPages = pageSize > 0 ? Math.ceil(totalHits / pageSize) : 1;
+    const lines = [];
+    // Summary line
+    lines.push(`**Gefunden: ${totalHits} Treffer** (Seite ${page} von ${totalPages})`);
+    lines.push('');
+    if (documents.length === 0) {
+        lines.push('_Keine Dokumente gefunden._');
+        return lines.join('\n');
+    }
+    // Format each document
+    for (let i = 0; i < documents.length; i++) {
+        const doc = documents[i];
+        const citation = formatCitation(doc);
+        lines.push(`### ${i + 1}. ${citation}`);
+        // Title (if different from citation)
+        const titel = doc.titel ?? '';
+        if (titel && titel !== citation) {
+            lines.push(`**${titel}**`);
+        }
+        // Metadata
+        const citationData = doc.citation ?? {};
+        const metadataParts = [];
+        // Long title
+        const langtitel = citationData.langtitel;
+        if (langtitel) {
+            metadataParts.push(`_${langtitel}_`);
+        }
+        // Inkrafttreten
+        const inkrafttreten = citationData.inkrafttreten;
+        if (inkrafttreten) {
+            metadataParts.push(`In Kraft seit: ${formatDate(inkrafttreten)}`);
+        }
+        // Ausserkrafttreten
+        const ausserkrafttreten = citationData.ausserkrafttreten;
+        if (ausserkrafttreten && ausserkrafttreten !== '9999-12-31') {
+            metadataParts.push(`Außer Kraft: ${formatDate(ausserkrafttreten)}`);
+        }
+        // Kundmachungsorgan
+        const kundmachungsorgan = citationData.kundmachungsorgan;
+        if (kundmachungsorgan) {
+            metadataParts.push(`Fundstelle: ${kundmachungsorgan}`);
+        }
+        if (metadataParts.length > 0) {
+            lines.push(metadataParts.join('  \n'));
+        }
+        // Document number for retrieval
+        const dokumentnummer = doc.dokumentnummer ?? '';
+        if (dokumentnummer) {
+            lines.push(`\`Dokumentnummer: ${dokumentnummer}\``);
+        }
+        lines.push('');
+    }
+    // Pagination hint
+    if (hasMore) {
+        lines.push('---');
+        lines.push(`_Weitere Treffer verfügbar. Verwende \`seite: ${page + 1}\` für die nächste Seite._`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a full document for LLM context.
+ */
+export function formatDocument(content, metadata, format = 'markdown') {
+    if (format === 'json') {
+        return JSON.stringify({
+            metadata,
+            content: htmlToText(content),
+        }, null, 2);
+    }
+    return formatDocumentMarkdown(content, metadata);
+}
+/**
+ * Format document as markdown.
+ */
+function formatDocumentMarkdown(content, metadata) {
+    const lines = [];
+    // Citation header
+    const citation = formatCitation(metadata);
+    lines.push(`# ${citation}`);
+    lines.push('');
+    // Metadata block
+    lines.push('## Dokumentinformation');
+    lines.push('');
+    const citationData = metadata.citation ?? {};
+    // Full title
+    const langtitel = citationData.langtitel ?? metadata.titel ?? '';
+    if (langtitel) {
+        lines.push(`**Titel:** ${langtitel}`);
+    }
+    // Paragraph
+    const paragraph = citationData.paragraph;
+    if (paragraph) {
+        lines.push(`**Paragraph:** ${paragraph}`);
+    }
+    // Kundmachungsorgan
+    const kundmachungsorgan = citationData.kundmachungsorgan;
+    if (kundmachungsorgan) {
+        lines.push(`**Kundmachungsorgan:** ${kundmachungsorgan}`);
+    }
+    // Dates
+    const inkrafttreten = citationData.inkrafttreten;
+    if (inkrafttreten) {
+        lines.push(`**In Kraft seit:** ${formatDate(inkrafttreten)}`);
+    }
+    const ausserkrafttreten = citationData.ausserkrafttreten;
+    if (ausserkrafttreten && ausserkrafttreten !== '9999-12-31') {
+        lines.push(`**Außer Kraft:** ${formatDate(ausserkrafttreten)}`);
+    }
+    // ELI
+    const eli = citationData.eli;
+    if (eli) {
+        lines.push(`**ELI:** ${eli}`);
+    }
+    // Document number
+    const dokumentnummer = metadata.dokumentnummer ?? '';
+    if (dokumentnummer) {
+        lines.push(`**Dokumentnummer:** \`${dokumentnummer}\``);
+    }
+    // URLs
+    const dokumentUrl = metadata.dokument_url;
+    if (dokumentUrl) {
+        lines.push(`**Quelle:** [${dokumentUrl}](${dokumentUrl})`);
+    }
+    const gesamteUrl = metadata.gesamte_rechtsvorschrift_url;
+    if (gesamteUrl) {
+        lines.push(`**Gesamte Rechtsvorschrift:** [${gesamteUrl}](${gesamteUrl})`);
+    }
+    lines.push('');
+    // Content
+    lines.push('## Inhalt');
+    lines.push('');
+    const cleanContent = htmlToText(content);
+    lines.push(cleanContent);
+    return lines.join('\n');
+}
+// =============================================================================
+// Response Truncation
+// =============================================================================
+/**
+ * Truncate response if too long.
+ */
+export function truncateResponse(text, limit = CHARACTER_LIMIT) {
+    if (text.length <= limit) {
+        return text;
+    }
+    const originalLen = text.length;
+    // Reserve space for the warning message
+    const truncateAt = limit - 200;
+    // Try to truncate at a paragraph boundary
+    let truncated = text.slice(0, truncateAt);
+    // Find last paragraph break
+    const lastPara = truncated.lastIndexOf('\n\n');
+    if (lastPara > truncateAt * 0.7) {
+        truncated = truncated.slice(0, lastPara);
+    }
+    else {
+        // Try sentence boundary
+        const lastSentence = Math.max(truncated.lastIndexOf('. '), truncated.lastIndexOf('.\n'), truncated.lastIndexOf('? '), truncated.lastIndexOf('! '));
+        if (lastSentence > truncateAt * 0.8) {
+            truncated = truncated.slice(0, lastSentence + 1);
+        }
+    }
+    const newLen = truncated.length;
+    const warning = `\n\n---\n` +
+        `Antwort gekuerzt (${originalLen} -> ${newLen} Zeichen). ` +
+        `Verwende spezifischere Suchparameter oder ris_dokument fuer Einzeldokumente.`;
+    return truncated + warning;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/formatting.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Helper functions for MCP tool handlers.
+ *
+ * Extracted from server.ts to reduce file size and improve maintainability.
+ */
+/**
+ * Format an error response in German.
+ */
+export declare function formatErrorResponse(error: unknown): string;
+/** MCP tool response type with index signature for SDK compatibility */
+export type McpToolResponse = {
+    [x: string]: unknown;
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+/**
+ * Create a standard MCP text response.
+ */
+export declare function createMcpResponse(text: string): McpToolResponse;
+/**
+ * Create a validation error response listing required parameters.
+ */
+export declare function createValidationErrorResponse(requiredParams: string[]): McpToolResponse;
+/**
+ * Check if any of the specified parameters has a truthy value.
+ */
+export declare function hasAnyParam(args: Record<string, unknown>, keys: string[]): boolean;
+/**
+ * Build base API parameters common to all search requests.
+ */
+export declare function buildBaseParams(applikation: string, limit: number, seite: number): Record<string, unknown>;
+/**
+ * Add optional parameters to the params object.
+ * Only adds values that are truthy (not undefined, null, or empty string).
+ */
+export declare function addOptionalParams(params: Record<string, unknown>, mappings: [value: unknown, key: string][]): void;
+/** Search function type for API calls */
+export type SearchFunction = (params: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Execute a search tool and return formatted results.
+ * Handles the common try-catch, parsing, formatting, and truncation logic.
+ */
+export declare function executeSearchTool(searchFn: SearchFunction, params: Record<string, unknown>, responseFormat: 'markdown' | 'json'): Promise<McpToolResponse>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2B1D;AAMD,wEAAwE;AAExE,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAE/D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,eAAe,CAKvF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAKlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GACxC,IAAI,CAMN;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnF;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,UAAU,GAAG,MAAM,GAClC,OAAO,CAAC,eAAe,CAAC,CAU1B"}

package/dist/helpers.js

@@ -0,0 +1,92 @@
+/**
+ * Helper functions for MCP tool handlers.
+ *
+ * Extracted from server.ts to reduce file size and improve maintainability.
+ */
+import { RISAPIError, RISParsingError, RISTimeoutError } from './client.js';
+import { formatSearchResults, truncateResponse } from './formatting.js';
+import { parseSearchResults } from './parser.js';
+import { limitToDokumenteProSeite } from './types.js';
+// =============================================================================
+// Error Handling
+// =============================================================================
+/**
+ * Format an error response in German.
+ */
+export function formatErrorResponse(error) {
+    if (error instanceof RISTimeoutError) {
+        return ('**Fehler:** Die Anfrage an das RIS hat zu lange gedauert.\n\n' +
+            'Bitte versuche es erneut oder verwende spezifischere Suchparameter.');
+    }
+    if (error instanceof RISParsingError) {
+        return ('**Fehler:** Die Antwort des RIS konnte nicht verarbeitet werden.\n\n' +
+            `Technische Details: ${error.message}`);
+    }
+    if (error instanceof RISAPIError) {
+        const statusInfo = error.statusCode ? ` (Status: ${error.statusCode})` : '';
+        return (`**Fehler:** Das RIS hat einen Fehler zurueckgegeben${statusInfo}.\n\n` +
+            `Details: ${error.message}`);
+    }
+    return ('**Fehler:** Ein unerwarteter Fehler ist aufgetreten.\n\n' +
+        `Details: ${error instanceof Error ? error.message : String(error)}`);
+}
+/**
+ * Create a standard MCP text response.
+ */
+export function createMcpResponse(text) {
+    return { content: [{ type: 'text', text }] };
+}
+/**
+ * Create a validation error response listing required parameters.
+ */
+export function createValidationErrorResponse(requiredParams) {
+    const paramList = requiredParams.map((p) => `- \`${p}\``).join('\n');
+    return createMcpResponse('**Fehler:** Bitte gib mindestens einen Suchparameter an:\n' + paramList);
+}
+/**
+ * Check if any of the specified parameters has a truthy value.
+ */
+export function hasAnyParam(args, keys) {
+    return keys.some((key) => {
+        const value = args[key];
+        return value !== undefined && value !== null && value !== '';
+    });
+}
+/**
+ * Build base API parameters common to all search requests.
+ */
+export function buildBaseParams(applikation, limit, seite) {
+    return {
+        Applikation: applikation,
+        DokumenteProSeite: limitToDokumenteProSeite(limit),
+        Seitennummer: seite,
+    };
+}
+/**
+ * Add optional parameters to the params object.
+ * Only adds values that are truthy (not undefined, null, or empty string).
+ */
+export function addOptionalParams(params, mappings) {
+    for (const [value, key] of mappings) {
+        if (value !== undefined && value !== null && value !== '') {
+            params[key] = value;
+        }
+    }
+}
+/**
+ * Execute a search tool and return formatted results.
+ * Handles the common try-catch, parsing, formatting, and truncation logic.
+ */
+export async function executeSearchTool(searchFn, params, responseFormat) {
+    try {
+        const apiResponse = await searchFn(params);
+        const searchResult = parseSearchResults(apiResponse);
+        const formatted = formatSearchResults(searchResult, responseFormat);
+        const result = truncateResponse(formatted);
+        return createMcpResponse(result);
+    }
+    catch (e) {
+        return createMcpResponse(formatErrorResponse(e));
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the RIS MCP Server.
+ *
+ * Starts the MCP server with stdio transport for communication
+ * with Claude Desktop or other MCP clients.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the RIS MCP Server.
+ *
+ * Starts the MCP server with stdio transport for communication
+ * with Claude Desktop or other MCP clients.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { server } from './server.js';
+/**
+ * Main function to start the MCP server.
+ */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Failed to start RIS MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}