@cyanheads/libofcongress-mcp-server 0.2.1

package/dist/mcp-server/tools/definitions/libofcongress-get-newspaper-page.tool.js

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview libofcongress_get_newspaper_page tool — retrieve full OCR text for a specific newspaper page.
+ * @module mcp-server/tools/definitions/libofcongress-get-newspaper-page.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, validationError } from '@cyanheads/mcp-ts-core/errors';
+import { getLocApiService } from '../../../services/loc-api/loc-api-service.js';
+const LOC_PAGE_URL_PREFIX = 'https://www.loc.gov/resource/';
+export const locGetNewspaperPage = tool('libofcongress_get_newspaper_page', {
+    title: 'Get Newspaper Page',
+    description: 'Retrieve the full OCR text of a specific historical newspaper page along with publication metadata. Pass the url field from a libofcongress_search_newspapers result — do not construct this URL manually. OCR quality varies by digitization batch and era: 19th-century and degraded materials may contain fragmented text, garbled words, and line-break artifacts that are surfaced as-is. When a page exists but has no digitized text, ocr_available is false and ocr_text is empty — this is a data property, not an error.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        page_url: z
+            .string()
+            .describe('The url field from a libofcongress_search_newspapers result. Format: https://www.loc.gov/resource/sn{number}/{date-id}.{seq}/. Always pass the value directly from search results — do not construct or modify this URL.'),
+    }),
+    output: z.object({
+        page_url: z.string().describe('The LOC resource URL for this newspaper page.'),
+        newspaper_title: z.string().optional().describe('Title of the newspaper publication.'),
+        date: z.string().optional().describe('Issue publication date.'),
+        state: z.string().optional().describe('State where the newspaper was published.'),
+        edition: z.string().optional().describe('Edition or publication context identifier.'),
+        sequence: z.number().optional().describe('Page sequence number within the issue.'),
+        ocr_text: z
+            .string()
+            .describe('Full plain-text OCR content for the page. Empty string when ocr_available is false. May contain fragmented words, line-break artifacts, and misspellings inherent to historical OCR — do not attempt to repair.'),
+        ocr_available: z
+            .boolean()
+            .describe('True when digitized OCR text exists for this page. False for image-only digitization batches where OCR has not been applied.'),
+    }),
+    errors: [
+        {
+            reason: 'page_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The URL does not resolve to a valid LOC newspaper page resource.',
+            recovery: 'Re-run libofcongress_search_newspapers to get a fresh url from current results. Do not modify or guess page URLs.',
+        },
+        {
+            reason: 'rate_limit_exceeded',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'LOC API rate limit exceeded; requests are blocked for approximately 1 hour.',
+            recovery: 'Wait approximately 1 hour before retrying. Reduce request frequency to stay under 20 req/min.',
+        },
+    ],
+    handler(input, ctx) {
+        ctx.log.info('libofcongress_get_newspaper_page', { page_url: input.page_url });
+        // Validate before any outbound request: must be a well-formed URL on www.loc.gov/resource/
+        let parsed;
+        try {
+            parsed = new URL(input.page_url);
+        }
+        catch {
+            throw validationError('page_url must be a valid LOC newspaper page URL (e.g. https://www.loc.gov/resource/sn.../date/). Get it from a libofcongress_search_newspapers result.', { field: 'page_url' });
+        }
+        if (!input.page_url.startsWith(LOC_PAGE_URL_PREFIX)) {
+            throw validationError('page_url must begin with https://www.loc.gov/resource/. Pass the url field directly from a libofcongress_search_newspapers result.', { field: 'page_url', received: `${parsed.origin}${parsed.pathname}` });
+        }
+        const svc = getLocApiService();
+        return svc.getNewspaperPage(input.page_url, ctx);
+    },
+    format: (result) => {
+        const lines = [];
+        if (result.newspaper_title)
+            lines.push(`# ${result.newspaper_title}`);
+        lines.push(`**URL:** ${result.page_url}`);
+        if (result.date)
+            lines.push(`**Date:** ${result.date}`);
+        if (result.state)
+            lines.push(`**State:** ${result.state}`);
+        if (result.edition)
+            lines.push(`**Edition:** ${result.edition}`);
+        if (result.sequence !== undefined)
+            lines.push(`**Sequence:** ${result.sequence}`);
+        lines.push(`**OCR available:** ${result.ocr_available ? 'Yes' : 'No'}`);
+        if (result.ocr_available && result.ocr_text) {
+            lines.push('\n---\n');
+            lines.push(result.ocr_text);
+        }
+        else if (result.ocr_available && !result.ocr_text) {
+            lines.push('\n_OCR is digitized for this page but the text could not be retrieved._');
+        }
+        else {
+            lines.push('\n_No digitized OCR text available for this page (image-only digitization batch)._');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=libofcongress-get-newspaper-page.tool.js.map

package/dist/mcp-server/tools/definitions/libofcongress-get-newspaper-page.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-get-newspaper-page.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-get-newspaper-page.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/libofcongress-search-newspapers.tool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview libofcongress_search_newspapers tool — search historical newspaper pages in the Chronicling America corpus.
+ * @module mcp-server/tools/definitions/libofcongress-search-newspapers.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const locSearchNewspapers: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    date_start: z.ZodOptional<z.ZodNumber>;
+    date_end: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodOptional<z.ZodString>;
+    newspaper_title: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+        newspaper_title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    pages: z.ZodNumber;
+    has_next: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "empty_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No newspaper pages matched the query and filters.";
+    readonly recovery: "Broaden the date range, remove the state filter, or try different keywords. OCR search is approximate — spelling variations in historical text are common.";
+}, {
+    readonly reason: "rate_limit_exceeded";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "LOC API rate limit exceeded; requests are blocked for approximately 1 hour.";
+    readonly recovery: "Wait approximately 1 hour before retrying. Reduce request frequency to stay under 20 req/min.";
+}]>;
+//# sourceMappingURL=libofcongress-search-newspapers.tool.d.ts.map

package/dist/mcp-server/tools/definitions/libofcongress-search-newspapers.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-search-newspapers.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-search-newspapers.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,+BAA+B,CAAC;AAGlF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmL9B,CAAC"}

package/dist/mcp-server/tools/definitions/libofcongress-search-newspapers.tool.js

@@ -0,0 +1,162 @@
+/**
+ * @fileoverview libofcongress_search_newspapers tool — search historical newspaper pages in the Chronicling America corpus.
+ * @module mcp-server/tools/definitions/libofcongress-search-newspapers.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, validationError } from '@cyanheads/mcp-ts-core/errors';
+import { getLocApiService } from '../../../services/loc-api/loc-api-service.js';
+export const locSearchNewspapers = tool('libofcongress_search_newspapers', {
+    title: 'Search Historical Newspapers',
+    description: 'Search historical newspaper pages in the Chronicling America corpus. Returns matching pages with OCR text excerpts (~500 characters), publication title, date, state, and the page URL needed for libofcongress_get_newspaper_page. Filters by keyword, date range, US state, and newspaper title. The OCR excerpts are sufficient for relevance assessment — call libofcongress_get_newspaper_page with the returned url field to read the full page text. OCR quality varies: 19th-century and degraded materials may contain fragmented or garbled text.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        query: z.string().min(1).describe('Keyword search across OCR text and newspaper metadata.'),
+        date_start: z
+            .number()
+            .int()
+            .optional()
+            .describe('Start year for date filter, inclusive (e.g., 1900). Omit for no lower bound.'),
+        date_end: z
+            .number()
+            .int()
+            .optional()
+            .describe('End year for date filter, inclusive (e.g., 1920). Omit for no upper bound.'),
+        state: z
+            .string()
+            .optional()
+            .describe('Filter to newspapers published in this US state. Use the full state name, lowercase (e.g., "oklahoma", "new york").'),
+        newspaper_title: z
+            .string()
+            .optional()
+            .describe('Filter to a specific newspaper by title (partial match accepted).'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe('Results per page. Default 25, max 100.'),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .default(1)
+            .describe('1-indexed page number for paginating results.'),
+    }),
+    output: z.object({
+        items: z
+            .array(z
+            .object({
+            url: z
+                .string()
+                .describe('LOC resource URL for this page — pass to libofcongress_get_newspaper_page to get full OCR text.'),
+            title: z.string().describe('Page or issue title.'),
+            description: z
+                .string()
+                .optional()
+                .describe('OCR text excerpt (~500 chars) for relevance assessment.'),
+            date: z.string().optional().describe('Issue publication date.'),
+            state: z.string().optional().describe('State where the newspaper was published.'),
+            newspaper_title: z.string().optional().describe('Newspaper publication title.'),
+        })
+            .describe('A single newspaper page search result.'))
+            .describe('Newspaper page results matching the search query and filters.'),
+        total: z.number().describe('Total number of matching newspaper pages in the result set.'),
+        page: z.number().describe('Current 1-indexed page number.'),
+        pages: z.number().describe('Total number of pages available.'),
+        has_next: z.boolean().describe('True when more pages are available after this one.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty — echoes the applied filters and suggests how to broaden. Absent on non-empty result pages.'),
+    }),
+    errors: [
+        {
+            reason: 'empty_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No newspaper pages matched the query and filters.',
+            recovery: 'Broaden the date range, remove the state filter, or try different keywords. OCR search is approximate — spelling variations in historical text are common.',
+        },
+        {
+            reason: 'rate_limit_exceeded',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'LOC API rate limit exceeded; requests are blocked for approximately 1 hour.',
+            recovery: 'Wait approximately 1 hour before retrying. Reduce request frequency to stay under 20 req/min.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('libofcongress_search_newspapers', {
+            query: input.query,
+            state: input.state,
+            page: input.page,
+        });
+        if (input.date_start !== undefined &&
+            input.date_end !== undefined &&
+            input.date_start > input.date_end) {
+            throw validationError(`date_start (${input.date_start}) must be ≤ date_end (${input.date_end}). Reverse the values to form a valid date range.`, { field: 'date_start', date_start: input.date_start, date_end: input.date_end });
+        }
+        const svc = getLocApiService();
+        const result = await svc.searchNewspapers({
+            query: input.query,
+            ...(input.date_start !== undefined && { dateStart: input.date_start }),
+            ...(input.date_end !== undefined && { dateEnd: input.date_end }),
+            ...(input.state?.trim() && { state: input.state.trim() }),
+            ...(input.newspaper_title?.trim() && { newspaperTitle: input.newspaper_title.trim() }),
+            limit: input.limit,
+            page: input.page,
+        }, ctx);
+        if (result.items.length === 0) {
+            return {
+                items: [],
+                total: 0,
+                page: input.page,
+                pages: 0,
+                has_next: false,
+                message: `No newspaper pages matched "${input.query}"` +
+                    (input.state ? ` in state "${input.state}"` : '') +
+                    (input.date_start || input.date_end
+                        ? ` in dates ${input.date_start ?? ''}–${input.date_end ?? ''}`
+                        : '') +
+                    '. Try broadening the date range, removing the state filter, or using different keywords. Historical OCR is approximate — variant spellings are common.',
+            };
+        }
+        const { total, page, pages, hasNext } = result.pagination;
+        if (pages > 0 && page > pages) {
+            return {
+                items: [],
+                total,
+                page,
+                pages,
+                has_next: false,
+                message: `No results on page ${page} — query has ${pages} page(s) total (${total} items). Use a page number between 1 and ${pages}.`,
+            };
+        }
+        return {
+            items: result.items,
+            total,
+            page,
+            pages,
+            has_next: hasNext,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**Total:** ${result.total} | **Page:** ${result.page} of ${result.pages} | **has_next:** ${result.has_next}`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const item of result.items) {
+            lines.push(`\n## ${item.title}`);
+            if (item.newspaper_title)
+                lines.push(`**Publication:** ${item.newspaper_title}`);
+            if (item.date)
+                lines.push(`**Date:** ${item.date}`);
+            if (item.state)
+                lines.push(`**State:** ${item.state}`);
+            if (item.description)
+                lines.push(item.description);
+            lines.push(`**URL:** ${item.url}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=libofcongress-search-newspapers.tool.js.map

package/dist/mcp-server/tools/definitions/libofcongress-search-newspapers.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-search-newspapers.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-search-newspapers.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/libofcongress-search-subjects.tool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview libofcongress_search_subjects tool — search Library of Congress Subject Headings (LCSH).
+ * @module mcp-server/tools/definitions/libofcongress-search-subjects.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const locSearchSubjects: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    subjects: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        uri: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "empty_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No LCSH headings matched the query.";
+    readonly recovery: "Try broader or different terms. LCSH uses inverted forms for many headings (e.g., \"Photography, Aerial\" not \"Aerial photography\").";
+}]>;
+//# sourceMappingURL=libofcongress-search-subjects.tool.d.ts.map

package/dist/mcp-server/tools/definitions/libofcongress-search-subjects.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-search-subjects.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-search-subjects.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;GA4F5B,CAAC"}

package/dist/mcp-server/tools/definitions/libofcongress-search-subjects.tool.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview libofcongress_search_subjects tool — search Library of Congress Subject Headings (LCSH).
+ * @module mcp-server/tools/definitions/libofcongress-search-subjects.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getLcLinkedDataService } from '../../../services/lc-linked-data/lc-linked-data-service.js';
+export const locSearchSubjects = tool('libofcongress_search_subjects', {
+    title: 'Search LC Subject Headings',
+    description: 'Search Library of Congress Subject Headings (LCSH) by keyword. Returns controlled-vocabulary subject labels and their URIs. Use the returned label as the subject filter in libofcongress_search — LCSH uses precise, standardized terms that differ from natural language (e.g., "World War, 1939-1945" not "World War II"; "Photography, Aerial" not "Aerial photography"). Running this tool before a subject-filtered libofcongress_search dramatically improves result quality.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        query: z
+            .string()
+            .min(1)
+            .describe('Keyword or partial subject heading to search for (e.g., "civil war", "immigration", "jazz").'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .default(10)
+            .describe('Maximum number of subject headings to return. Default 10, max 50.'),
+    }),
+    output: z.object({
+        subjects: z
+            .array(z
+            .object({
+            label: z
+                .string()
+                .describe('Standardized LCSH heading — use this exact string in the libofcongress_search subject filter.'),
+            uri: z
+                .string()
+                .describe('Stable LOC URI identifying this subject heading in the authority file.'),
+            count: z
+                .number()
+                .optional()
+                .describe('Approximate number of LOC items carrying this heading. Omitted when unavailable.'),
+        })
+            .describe('A single LCSH subject heading record.'))
+            .describe('LCSH subject headings matching the query, ordered by relevance.'),
+        total: z.number().describe('Number of subject headings returned.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty — suggests alternative search strategies. Absent on non-empty result pages.'),
+    }),
+    errors: [
+        {
+            reason: 'empty_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No LCSH headings matched the query.',
+            recovery: 'Try broader or different terms. LCSH uses inverted forms for many headings (e.g., "Photography, Aerial" not "Aerial photography").',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('libofcongress_search_subjects', { query: input.query, limit: input.limit });
+        const svc = getLcLinkedDataService();
+        const subjects = await svc.searchSubjects(input.query, input.limit, ctx);
+        if (subjects.length === 0) {
+            return {
+                subjects: [],
+                total: 0,
+                message: `No LCSH headings matched "${input.query}". Try broader or different terms. LCSH uses inverted forms for many headings — for example, "Photography, Aerial" instead of "Aerial photography", or "World War, 1939-1945" instead of "World War II".`,
+            };
+        }
+        return {
+            subjects,
+            total: subjects.length,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**${result.total} subject heading(s) found**`);
+        if (result.message)
+            lines.push(`\n> ${result.message}`);
+        for (const s of result.subjects) {
+            lines.push(`\n## ${s.label}`);
+            lines.push(`**URI:** ${s.uri}`);
+            if (s.count !== undefined)
+                lines.push(`**Items:** ${s.count}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=libofcongress-search-subjects.tool.js.map

package/dist/mcp-server/tools/definitions/libofcongress-search-subjects.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-search-subjects.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-search-subjects.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/libofcongress-search.tool.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview libofcongress_search tool — search Library of Congress digital collections.
+ * @module mcp-server/tools/definitions/libofcongress-search.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const locSearch: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        map: "map";
+        photo: "photo";
+        newspaper: "newspaper";
+        manuscript: "manuscript";
+        audio: "audio";
+        film: "film";
+        book: "book";
+        "notated-music": "notated-music";
+    }>>;
+    date_start: z.ZodOptional<z.ZodNumber>;
+    date_end: z.ZodOptional<z.ZodNumber>;
+    subject: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        date: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    pages: z.ZodNumber;
+    has_next: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "empty_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No items matched the query and filters.";
+    readonly recovery: "Broaden the query, widen the date range, or use libofcongress_search_subjects to find the correct subject heading spelling.";
+}, {
+    readonly reason: "rate_limit_exceeded";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "LOC API rate limit exceeded; requests are blocked for approximately 1 hour.";
+    readonly recovery: "Wait approximately 1 hour before retrying. Reduce request frequency to stay under 20 req/min.";
+}]>;
+//# sourceMappingURL=libofcongress-search.tool.d.ts.map

package/dist/mcp-server/tools/definitions/libofcongress-search.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-search.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-search.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,+BAA+B,CAAC;AAGlF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+LpB,CAAC"}