@cyanheads/libofcongress-mcp-server 0.2.1

package/dist/services/loc-api/loc-api-service.js

@@ -0,0 +1,418 @@
+/**
+ * @fileoverview LOC JSON API service — wraps www.loc.gov with rate limiting, retry, and response normalization.
+ * @module services/loc-api/loc-api-service
+ */
+import { notFound, rateLimited, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { getServerConfig } from '../../config/server-config.js';
+const LOC_BASE = 'https://www.loc.gov';
+/** Format slug → LOC endpoint path segment */
+const FORMAT_SLUG_MAP = {
+    photo: 'photos',
+    map: 'maps',
+    newspaper: 'newspapers',
+    manuscript: 'manuscripts',
+    audio: 'audio',
+    film: 'film-and-videos',
+    book: 'books',
+    'notated-music': 'notated-music',
+};
+/**
+ * Rate-limiting state: tracks when the 1-hour block expires.
+ * Stored in module-level variable (single service instance per process).
+ */
+let rateLimitBlockedUntil = 0;
+/** Paces requests to stay under 20 req/min: resolves after the configured delay. */
+let lastRequestAt = 0;
+async function pace(delayMs) {
+    const now = Date.now();
+    const elapsed = now - lastRequestAt;
+    if (elapsed < delayMs) {
+        await new Promise((resolve) => setTimeout(resolve, delayMs - elapsed));
+    }
+    lastRequestAt = Date.now();
+}
+function extractFirstString(value) {
+    if (!value)
+        return;
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+function extractStringArray(value) {
+    if (!value)
+        return [];
+    if (Array.isArray(value))
+        return value;
+    return [value];
+}
+function extractId(result) {
+    // LOC IDs come as full URLs like https://www.loc.gov/item/2009632251/
+    // or as short strings like loc.pnp.ppmsc.02404
+    const rawId = result.id ?? result.url ?? '';
+    // Strip URL to just the path component's last segment
+    const urlMatch = rawId.match(/\/item\/([^/]+)\/?$/);
+    if (urlMatch?.[1])
+        return urlMatch[1];
+    return rawId.replace(/^https?:\/\/[^/]+\//, '').replace(/\/$/, '');
+}
+function normalizeSearchResult(result) {
+    const title = extractFirstString(result.title) ?? 'Untitled';
+    const description = Array.isArray(result.description)
+        ? result.description.join(' ')
+        : result.description;
+    const format = (result.original_format ?? result.online_format ?? [])[0] ?? undefined;
+    const id = extractId(result);
+    const url = result.url ?? `${LOC_BASE}/item/${id}/`;
+    return {
+        id,
+        title,
+        ...(result.date && { date: result.date }),
+        ...(description && { description }),
+        ...(format && { format }),
+        url,
+    };
+}
+function normalizePagination(raw, page, limit) {
+    const total = raw?.total ?? raw?.results ?? 0;
+    const perPage = raw?.perpage ?? limit;
+    const pages = raw?.pages ?? (total > 0 ? Math.ceil(total / perPage) : 1);
+    const hasNext = page < pages;
+    return { total, page, perPage, pages, hasNext };
+}
+export class LocApiService {
+    userAgent;
+    requestDelayMs;
+    constructor(_config, _storage) {
+        const serverConfig = getServerConfig();
+        this.userAgent = serverConfig.userAgent;
+        this.requestDelayMs = serverConfig.requestDelayMs;
+    }
+    checkRateLimit() {
+        if (rateLimitBlockedUntil > Date.now()) {
+            const minutesLeft = Math.ceil((rateLimitBlockedUntil - Date.now()) / 60_000);
+            throw rateLimited(`LOC API rate limit exceeded. Requests are blocked for approximately ${minutesLeft} more minute(s). Reduce request frequency to stay under 20 req/min.`, {
+                reason: 'rate_limit_exceeded',
+                blockedUntil: new Date(rateLimitBlockedUntil).toISOString(),
+                recovery: {
+                    hint: 'Wait for the block to expire before retrying. Reduce the number of API calls per minute.',
+                },
+            });
+        }
+    }
+    async fetch(url, ctx, opts) {
+        this.checkRateLimit();
+        await pace(this.requestDelayMs);
+        ctx.log.debug('LOC API request', { url });
+        const response = await fetch(url, {
+            headers: { 'User-Agent': this.userAgent, Accept: 'application/json' },
+            signal: ctx.signal,
+        });
+        if (response.status === 429) {
+            // Block for 1 hour
+            rateLimitBlockedUntil = Date.now() + 60 * 60 * 1000;
+            throw rateLimited('LOC API rate limit exceeded. Requests are blocked for approximately 1 hour. Reduce request frequency to stay under 20 req/min.', {
+                reason: 'rate_limit_exceeded',
+                recovery: {
+                    hint: 'Wait at least 1 hour before retrying. Reduce request frequency to stay under 20 req/min.',
+                },
+            });
+        }
+        if (response.status === 404) {
+            return response; // Caller handles 404
+        }
+        // Callers can opt-in to receiving certain non-2xx statuses for graceful handling
+        if (opts?.allowStatus?.includes(response.status)) {
+            return response;
+        }
+        if (!response.ok) {
+            throw serviceUnavailable(`LOC API returned HTTP ${response.status}`, {
+                status: response.status,
+            });
+        }
+        return response;
+    }
+    async fetchJson(url, ctx) {
+        const response = await this.fetch(url, ctx);
+        if (response.status === 404) {
+            throw notFound('LOC resource not found', { url });
+        }
+        const text = await response.text();
+        if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+            throw serviceUnavailable('LOC API returned HTML — may be rate-limited or temporarily unavailable.', { url });
+        }
+        return JSON.parse(text);
+    }
+    /**
+     * Fetch a LOC search endpoint, treating HTTP 400 and 520 as out-of-range page responses
+     * (LOC returns these for page numbers beyond the result set).
+     * Returns null when the page is out of range.
+     */
+    async fetchSearchJson(url, ctx) {
+        const response = await this.fetch(url, ctx, { allowStatus: [400, 520] });
+        if (response.status === 404) {
+            throw notFound('LOC resource not found', { url });
+        }
+        // LOC returns 400 or 520 for out-of-range page numbers — treat as empty
+        if (response.status === 400 || response.status === 520) {
+            ctx.log.debug('LOC search returned out-of-range page', { status: response.status, url });
+            return null;
+        }
+        const text = await response.text();
+        if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+            throw serviceUnavailable('LOC API returned HTML — may be rate-limited or temporarily unavailable.', { url });
+        }
+        return JSON.parse(text);
+    }
+    /** Search LOC digital collections */
+    async search(params, ctx) {
+        const limit = Math.min(params.limit ?? 25, 100);
+        const page = params.page ?? 1;
+        const formatSlug = params.format ? FORMAT_SLUG_MAP[params.format] : undefined;
+        const endpoint = formatSlug ? `${LOC_BASE}/${formatSlug}/` : `${LOC_BASE}/search/`;
+        const qs = new URLSearchParams({ fo: 'json', q: params.query, at: 'results,pagination' });
+        qs.set('c', String(limit));
+        qs.set('sp', String(page));
+        if (params.dateStart !== undefined || params.dateEnd !== undefined) {
+            const start = params.dateStart ?? 1600;
+            const end = params.dateEnd ?? new Date().getFullYear();
+            qs.set('dates', `${start}/${end}`);
+        }
+        const fa = [];
+        if (params.subject)
+            fa.push(`subject:${params.subject}`);
+        if (params.location)
+            fa.push(`location:${params.location}`);
+        if (fa.length > 0)
+            qs.set('fa', fa.join('|'));
+        const url = `${endpoint}?${qs}`;
+        const data = await this.fetchSearchJson(url, ctx);
+        if (data === null) {
+            // Out-of-range page — return empty with pagination stub so callers can surface a message
+            return { items: [], pagination: normalizePagination(undefined, page, limit) };
+        }
+        const rawResults = data.results ?? data.content?.results ?? [];
+        const rawPagination = data.pagination ?? data.content?.pagination;
+        const items = rawResults.map(normalizeSearchResult);
+        return { items, pagination: normalizePagination(rawPagination, page, limit) };
+    }
+    /** Get full metadata for a single LOC item */
+    async getItem(itemId, ctx) {
+        const url = `${LOC_BASE}/item/${encodeURIComponent(itemId)}/?fo=json&at=item,resources,related_items`;
+        const data = await this.fetchJson(url, ctx);
+        const item = data.item;
+        if (!item) {
+            throw notFound(`LOC item not found: ${itemId}`, { itemId });
+        }
+        const title = extractFirstString(item.title) ?? 'Untitled';
+        const physDesc = extractFirstString(item.physical_description ?? item.medium);
+        // Collect resource links: flatten nested file arrays
+        const resourceLinks = [];
+        for (const resource of data.resources ?? []) {
+            if (resource.url)
+                resourceLinks.push(resource.url);
+            if (resource.image)
+                resourceLinks.push(resource.image);
+            if (resource.pdf)
+                resourceLinks.push(resource.pdf);
+            for (const fileGroup of resource.files ?? []) {
+                for (const file of fileGroup) {
+                    if (file.url)
+                        resourceLinks.push(file.url);
+                }
+            }
+        }
+        const relatedItems = [];
+        for (const rel of data.related_items ?? []) {
+            if (rel.id)
+                relatedItems.push(rel.id);
+            else if (rel.url)
+                relatedItems.push(rel.url);
+        }
+        // Also check item.related_items
+        relatedItems.push(...(item.related_items ?? []));
+        const rights = item.rights_information ?? item.rights;
+        return {
+            item_id: itemId,
+            title,
+            ...(item.date && { date: item.date }),
+            contributors: extractStringArray(item.contributor),
+            subject_headings: extractStringArray(item.subject),
+            notes: extractStringArray(item.notes),
+            ...(rights && { rights_information: rights }),
+            ...(physDesc && { physical_description: physDesc }),
+            resource_links: [...new Set(resourceLinks)],
+            related_items: [...new Set(relatedItems)],
+            url: item.url ?? `${LOC_BASE}/item/${itemId}/`,
+        };
+    }
+    /** Search historical newspaper pages via the /newspapers/ endpoint */
+    async searchNewspapers(params, ctx) {
+        const limit = Math.min(params.limit ?? 25, 100);
+        const page = params.page ?? 1;
+        const qs = new URLSearchParams({ fo: 'json', q: params.query, at: 'results,pagination' });
+        qs.set('c', String(limit));
+        qs.set('sp', String(page));
+        if (params.dateStart !== undefined || params.dateEnd !== undefined) {
+            const start = params.dateStart ?? 1770;
+            const end = params.dateEnd ?? 1963;
+            qs.set('dates', `${start}/${end}`);
+        }
+        const fa = [];
+        if (params.state)
+            fa.push(`location:${params.state.toLowerCase()}`);
+        if (params.newspaperTitle)
+            fa.push(`partof_title:${params.newspaperTitle}`);
+        if (fa.length > 0)
+            qs.set('fa', fa.join('|'));
+        const url = `${LOC_BASE}/newspapers/?${qs}`;
+        const data = await this.fetchSearchJson(url, ctx);
+        if (data === null) {
+            return { items: [], pagination: normalizePagination(undefined, page, limit) };
+        }
+        const rawResults = data.results ?? data.content?.results ?? [];
+        const rawPagination = data.pagination ?? data.content?.pagination;
+        const items = rawResults.map((r) => {
+            const descArr = Array.isArray(r.description)
+                ? r.description
+                : r.description
+                    ? [r.description]
+                    : [];
+            const description = descArr.slice(0, 3).join(' ').substring(0, 500);
+            // partof_title holds the canonical publication title for Chronicling America pages.
+            // Fall back to last entry of partof if partof_title absent.
+            const rawTitle = extractFirstString(r.partof_title) ??
+                (Array.isArray(r.partof) ? r.partof[r.partof.length - 1] : r.partof);
+            // location_state is the US state; location[0] is often a city or "united states".
+            const rawState = extractFirstString(r.location_state) ?? extractFirstString(r.location);
+            return {
+                url: r.url ?? '',
+                title: extractFirstString(r.title) ?? 'Untitled',
+                ...(description && { description }),
+                ...(r.date && { date: r.date }),
+                ...(rawState && { state: rawState }),
+                ...(rawTitle && { newspaper_title: rawTitle }),
+            };
+        });
+        return { items, pagination: normalizePagination(rawPagination, page, limit) };
+    }
+    /** Retrieve full OCR text for a specific newspaper page via its resource URL */
+    async getNewspaperPage(pageUrl, ctx) {
+        // Strip search-specific params (q=) that LOC echoes into fulltext_file URLs,
+        // causing tile.loc.gov OCR requests to 404. Keep sp= (selects the page within a resource).
+        const parsed = new URL(pageUrl);
+        parsed.searchParams.delete('q');
+        const cleanUrl = parsed.toString();
+        // Build the resource endpoint URL
+        const resourceUrl = cleanUrl.includes('?')
+            ? `${cleanUrl}&fo=json&at=resource`
+            : `${cleanUrl}?fo=json&at=resource`;
+        const resourceData = await this.fetchJson(resourceUrl, ctx);
+        const res = resourceData.resource;
+        if (!res) {
+            throw notFound(`LOC newspaper page not found: ${pageUrl}`, { pageUrl });
+        }
+        // Extract metadata
+        const title = res.title;
+        const dateIssued = res.date_issued;
+        const sequence = res.sequence;
+        // Try to get state from part_of or notes
+        let state;
+        const partOf = res.part_of;
+        if (partOf) {
+            // part_of is like "Oklahoma newspapers" or a title string
+            const stateMatch = partOf.match(/^([A-Za-z ]+)\s+newspapers?/i);
+            if (stateMatch?.[1])
+                state = stateMatch[1].trim();
+        }
+        // Fetch full OCR text if fulltext_file is available
+        let ocrText = '';
+        let ocrAvailable = false;
+        if (res.fulltext_file) {
+            ocrAvailable = true;
+            try {
+                // fulltext_file is already a fully-qualified URL from the LOC resource API.
+                // Strip q= to avoid echoed search terms causing tile.loc.gov 404s.
+                const fulltextUrl = new URL(res.fulltext_file);
+                fulltextUrl.searchParams.delete('q');
+                const textUrl = fulltextUrl.toString();
+                ctx.log.debug('Fetching OCR text', { url: textUrl });
+                const textResponse = await fetch(textUrl, {
+                    headers: { 'User-Agent': this.userAgent },
+                    signal: ctx.signal,
+                });
+                if (textResponse.ok) {
+                    const altoXml = await textResponse.text();
+                    // Extract plain text from ALTO XML <String CONTENT="..."> attributes
+                    ocrText =
+                        altoXml
+                            .match(/CONTENT="([^"]*)"/g)
+                            ?.map((m) => m.slice(9, -1))
+                            .join(' ') ?? '';
+                }
+                else {
+                    // OCR service unavailable — return empty text, still mark as available
+                    ctx.log.warning('OCR text service returned error', {
+                        status: textResponse.status,
+                    });
+                }
+            }
+            catch (err) {
+                ctx.log.warning('OCR text fetch failed', { error: String(err) });
+            }
+        }
+        return {
+            page_url: pageUrl,
+            ...(title && { newspaper_title: title }),
+            ...(dateIssued && { date: dateIssued }),
+            ...(state && { state }),
+            ...(res.part_of && { edition: res.part_of }),
+            ...(sequence !== undefined && { sequence }),
+            ocr_text: ocrText,
+            ocr_available: ocrAvailable,
+        };
+    }
+    /** Browse LOC curated digital collections */
+    async browseCollections(params, ctx) {
+        const limit = Math.min(params.limit ?? 25, 100);
+        const page = params.page ?? 1;
+        const qs = new URLSearchParams({ fo: 'json', at: 'results,pagination' });
+        qs.set('c', String(limit));
+        qs.set('sp', String(page));
+        if (params.query)
+            qs.set('q', params.query);
+        const url = `${LOC_BASE}/collections/?${qs}`;
+        const data = await this.fetchSearchJson(url, ctx);
+        if (data === null) {
+            return { items: [], pagination: normalizePagination(undefined, page, limit) };
+        }
+        const rawResults = data.results ?? data.content?.results ?? [];
+        const rawPagination = data.pagination ?? data.content?.pagination;
+        const items = rawResults.map((r) => {
+            const title = extractFirstString(r.title) ?? 'Untitled';
+            const description = Array.isArray(r.description) ? r.description.join(' ') : r.description;
+            const itemUrl = r.url ?? '';
+            // Extract slug from URL: https://www.loc.gov/collections/civil-war-glass-negatives/ → civil-war-glass-negatives
+            const slugMatch = itemUrl.match(/\/collections\/([^/]+)\/?$/);
+            const slug = slugMatch?.[1] ?? title.toLowerCase().replace(/\s+/g, '-');
+            return {
+                slug,
+                title,
+                ...(description && { description }),
+                url: itemUrl,
+            };
+        });
+        return { items, pagination: normalizePagination(rawPagination, page, limit) };
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initLocApiService(config, storage) {
+    _service = new LocApiService(config, storage);
+}
+export function getLocApiService() {
+    if (!_service) {
+        throw new Error('LocApiService not initialized — call initLocApiService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=loc-api-service.js.map

package/dist/services/loc-api/loc-api-service.js.map

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

package/dist/services/loc-api/types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview Domain types for the LOC JSON API service.
+ * @module services/loc-api/types
+ */
+/** Raw result item from LOC /search/ and format-specific endpoints */
+export type RawLocSearchResult = {
+    id?: string;
+    url?: string;
+    title?: string | string[];
+    date?: string;
+    description?: string | string[];
+    original_format?: string[];
+    online_format?: string[];
+    subject?: string[];
+    contributor?: string[];
+    location?: string[];
+    /** State-level location facet (e.g. "new york (state)") — more precise than location[] for newspapers */
+    location_state?: string[];
+    language?: string[];
+    /** Canonical publication title for Chronicling America results (e.g. "The Evening World") */
+    partof_title?: string[];
+    /** Hierarchy of containing collections/publications */
+    partof?: string[];
+    /** Number of digitized items */
+    item?: Record<string, unknown>;
+};
+/** Raw pagination object from LOC search responses */
+export type RawLocPagination = {
+    from?: number;
+    to?: number;
+    total?: number;
+    perpage?: number;
+    results?: number;
+    page?: number;
+    last?: number;
+    of?: number;
+    pages?: number;
+    next?: string;
+    previous?: string;
+};
+/** Raw LOC search API response envelope */
+export type RawLocSearchResponse = {
+    results?: RawLocSearchResult[];
+    pagination?: RawLocPagination;
+    content?: {
+        results?: RawLocSearchResult[];
+        pagination?: RawLocPagination;
+    };
+};
+/** Raw LOC item detail response */
+export type RawLocItemResponse = {
+    item?: {
+        id?: string;
+        title?: string | string[];
+        date?: string;
+        created_published?: string | string[];
+        contributor?: string[];
+        subject?: string[];
+        notes?: string[];
+        rights?: string;
+        rights_information?: string;
+        medium?: string | string[];
+        physical_description?: string | string[];
+        summary?: string | string[];
+        language?: string[];
+        location?: string[];
+        related_items?: string[];
+        url?: string;
+        other_title?: string[];
+        number_former_id?: string[];
+        call_number?: string[];
+        type?: string[];
+        format?: string[];
+        original_format?: string[];
+        access_restricted?: boolean;
+        online_format?: string[];
+    };
+    resources?: Array<{
+        url?: string;
+        caption?: string;
+        image?: string;
+        pdf?: string;
+        files?: Array<Array<{
+            url?: string;
+            mimeType?: string;
+            size?: number;
+            levels?: number;
+            info?: string;
+        }>>;
+    }>;
+    related_items?: Array<{
+        id?: string;
+        title?: string;
+        url?: string;
+    }>;
+};
+/** Normalized item summary returned from search */
+export type LocItemSummary = {
+    id: string;
+    title: string;
+    date?: string;
+    description?: string;
+    format?: string;
+    url: string;
+};
+/** Normalized pagination info */
+export type LocPagination = {
+    total: number;
+    page: number;
+    perPage: number;
+    pages: number;
+    hasNext: boolean;
+};
+/** Normalized full item record */
+export type LocItemDetail = {
+    item_id: string;
+    title: string;
+    date?: string;
+    contributors: string[];
+    subject_headings: string[];
+    notes: string[];
+    rights_information?: string;
+    physical_description?: string;
+    resource_links: string[];
+    related_items: string[];
+    url: string;
+};
+/** Normalized newspaper page search result */
+export type LocNewspaperPage = {
+    url: string;
+    title: string;
+    description?: string;
+    date?: string;
+    state?: string;
+    newspaper_title?: string;
+};
+/** Normalized newspaper page full detail */
+export type LocNewspaperPageDetail = {
+    page_url: string;
+    newspaper_title?: string;
+    date?: string;
+    state?: string;
+    edition?: string;
+    sequence?: number;
+    ocr_text: string;
+    ocr_available: boolean;
+};
+/** Normalized collection record */
+export type LocCollection = {
+    slug: string;
+    title: string;
+    description?: string;
+    item_count?: number;
+    url: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/services/loc-api/types.d.ts.map

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

package/dist/services/loc-api/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Domain types for the LOC JSON API service.
+ * @module services/loc-api/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/loc-api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/loc-api/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}