@cyanheads/libofcongress-mcp-server 0.2.1

package/changelog/template.md

@@ -0,0 +1,119 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Server-specific configuration for libofcongress-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    userAgent: z.ZodDefault<z.ZodString>;
+    requestDelayMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;iBAatB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}

package/dist/config/server-config.js

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Server-specific configuration for libofcongress-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    userAgent: z
+        .string()
+        .default('libofcongress-mcp-server/0.2.1')
+        .describe('User-Agent header sent with LOC API requests. LOC recommends a descriptive value for polite access.'),
+    requestDelayMs: z.coerce
+        .number()
+        .default(3100)
+        .describe('Delay in milliseconds between LOC API requests to stay under the 20 req/min rate limit (~19/min at default).'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        userAgent: 'LOC_USER_AGENT',
+        requestDelayMs: 'LOC_REQUEST_DELAY_MS',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,OAAO,CAAC,gCAAgC,CAAC;SACzC,QAAQ,CACP,qGAAqG,CACtG;IACH,cAAc,EAAE,CAAC,CAAC,MAAM;SACrB,MAAM,EAAE;SACR,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,8GAA8G,CAC/G;CACJ,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,SAAS,EAAE,gBAAgB;QAC3B,cAAc,EAAE,sBAAsB;KACvC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview libofcongress-mcp-server MCP server entry point.
+ * @module index
+ */
+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;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview libofcongress-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { locItemResource } from './mcp-server/resources/definitions/libofcongress-item.resource.js';
+import { locBrowseCollections } from './mcp-server/tools/definitions/libofcongress-browse-collections.tool.js';
+import { locGetItem } from './mcp-server/tools/definitions/libofcongress-get-item.tool.js';
+import { locGetNewspaperPage } from './mcp-server/tools/definitions/libofcongress-get-newspaper-page.tool.js';
+import { locSearch } from './mcp-server/tools/definitions/libofcongress-search.tool.js';
+import { locSearchNewspapers } from './mcp-server/tools/definitions/libofcongress-search-newspapers.tool.js';
+import { locSearchSubjects } from './mcp-server/tools/definitions/libofcongress-search-subjects.tool.js';
+import { initLcLinkedDataService } from './services/lc-linked-data/lc-linked-data-service.js';
+import { initLocApiService } from './services/loc-api/loc-api-service.js';
+await createApp({
+    tools: [
+        locSearch,
+        locGetItem,
+        locSearchNewspapers,
+        locGetNewspaperPage,
+        locSearchSubjects,
+        locBrowseCollections,
+    ],
+    resources: [locItemResource],
+    prompts: [],
+    instructions: 'Library of Congress digital collections server. Use libofcongress_search_subjects to find exact LCSH terms before subject-filtering libofcongress_search. ' +
+        'Newspaper research: libofcongress_search_newspapers → libofcongress_get_newspaper_page (two hops). ' +
+        'Rate limit: 20 req/min; violations block for 1 hour.',
+    setup(core) {
+        initLocApiService(core.config, core.storage);
+        initLcLinkedDataService(core.config, core.storage);
+    },
+});
+//# 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;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,yEAAyE,CAAC;AAC/G,OAAO,EAAE,UAAU,EAAE,MAAM,+DAA+D,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,yEAAyE,CAAC;AAC9G,OAAO,EAAE,SAAS,EAAE,MAAM,6DAA6D,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wEAAwE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,sEAAsE,CAAC;AACzG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,SAAS;QACT,UAAU;QACV,mBAAmB;QACnB,mBAAmB;QACnB,iBAAiB;QACjB,oBAAoB;KACrB;IACD,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,OAAO,EAAE,EAAE;IACX,YAAY,EACV,4JAA4J;QAC5J,qGAAqG;QACrG,sDAAsD;IACxD,KAAK,CAAC,IAAI;QACR,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/libofcongress-item.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview libofcongress://item/{item_id} resource — stable LOC item metadata URI for agent context injection.
+ * @module mcp-server/resources/definitions/libofcongress-item.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const locItemResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    item_id: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=libofcongress-item.resource.d.ts.map

package/dist/mcp-server/resources/definitions/libofcongress-item.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-item.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/libofcongress-item.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,eAAe;;wCAoB1B,CAAC"}

package/dist/mcp-server/resources/definitions/libofcongress-item.resource.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview libofcongress://item/{item_id} resource — stable LOC item metadata URI for agent context injection.
+ * @module mcp-server/resources/definitions/libofcongress-item.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getLocApiService } from '../../../services/loc-api/loc-api-service.js';
+export const locItemResource = resource('libofcongress://item/{item_id}', {
+    name: 'loc-item',
+    title: 'LOC Item',
+    description: 'LOC digital item metadata by ID. Stable URI for injecting item context into agent conversations. Returns the same full record as libofcongress_get_item. Use libofcongress_search to discover item IDs first.',
+    mimeType: 'application/json',
+    params: z.object({
+        item_id: z
+            .string()
+            .describe('LOC item ID (e.g., "loc.pnp.ppmsc.02404" or "2009632251"). Same ID as in libofcongress_search result "id" field.'),
+    }),
+    handler(params, ctx) {
+        ctx.log.debug('libofcongress://item resource', { item_id: params.item_id });
+        const svc = getLocApiService();
+        // Service throws notFound when the item doesn't exist — let it bubble.
+        return svc.getItem(params.item_id, ctx);
+    },
+});
+//# sourceMappingURL=libofcongress-item.resource.js.map

package/dist/mcp-server/resources/definitions/libofcongress-item.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-item.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/libofcongress-item.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,gCAAgC,EAAE;IACxE,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,WAAW,EACT,+MAA+M;IACjN,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,kHAAkH,CACnH;KACJ,CAAC;IAEF,OAAO,CAAC,MAAM,EAAE,GAAG;QACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;QAC/B,uEAAuE;QACvE,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview libofcongress_browse_collections tool — list and browse LOC curated digital collections.
+ * @module mcp-server/tools/definitions/libofcongress-browse-collections.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const locBrowseCollections: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    collections: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        item_count: z.ZodOptional<z.ZodNumber>;
+        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 collections matched the keyword filter.";
+    readonly recovery: "Broaden the keyword or call without a query to list all LOC digital collections.";
+}, {
+    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-browse-collections.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-browse-collections.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-browse-collections.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,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmI/B,CAAC"}

package/dist/mcp-server/tools/definitions/libofcongress-browse-collections.tool.js

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview libofcongress_browse_collections tool — list and browse LOC curated digital collections.
+ * @module mcp-server/tools/definitions/libofcongress-browse-collections.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getLocApiService } from '../../../services/loc-api/loc-api-service.js';
+export const locBrowseCollections = tool('libofcongress_browse_collections', {
+    title: 'Browse LOC Collections',
+    description: 'List and browse Library of Congress curated digital collections. Returns collection names, descriptions, item counts, slugs, and URLs. Optionally filter by keyword. Collections are curated subsets of the digital holdings with specific focuses (e.g., "Civil War Glass Negatives", "Baseball Cards", "WPA Posters"). Use the slug value with libofcongress_search to scope searches to a single collection by passing it as a partof facet filter.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        query: z
+            .string()
+            .optional()
+            .describe('Optional keyword to filter collections by name or description. Omit to list all collections.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe('Maximum number of collections to return. Default 25, max 100.'),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .default(1)
+            .describe('1-indexed page number for paginating results.'),
+    }),
+    output: z.object({
+        collections: z
+            .array(z
+            .object({
+            slug: z
+                .string()
+                .describe('Collection URL slug — use as a partof facet value in libofcongress_search to scope searches to this collection.'),
+            title: z.string().describe('Collection name.'),
+            description: z
+                .string()
+                .optional()
+                .describe("Description of the collection's scope and contents."),
+            item_count: z
+                .number()
+                .optional()
+                .describe('Approximate number of items in this collection. Omitted when unavailable.'),
+            url: z.string().describe('Collection URL on loc.gov.'),
+        })
+            .describe('A single LOC curated digital collection.'))
+            .describe('LOC curated collections matching the keyword filter, or all collections when no keyword is specified.'),
+        total: z.number().describe('Total number of matching collections across all pages.'),
+        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 — suggests broadening the keyword. Absent on non-empty result pages.'),
+    }),
+    errors: [
+        {
+            reason: 'empty_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No collections matched the keyword filter.',
+            recovery: 'Broaden the keyword or call without a query to list all LOC digital collections.',
+        },
+        {
+            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_browse_collections', { query: input.query, page: input.page });
+        const svc = getLocApiService();
+        const result = await svc.browseCollections({
+            ...(input.query?.trim() && { query: input.query.trim() }),
+            limit: input.limit,
+            page: input.page,
+        }, ctx);
+        if (result.items.length === 0) {
+            return {
+                collections: [],
+                total: 0,
+                page: input.page,
+                pages: 0,
+                has_next: false,
+                message: input.query
+                    ? `No collections matched "${input.query}". Try a broader keyword or call without a query to list all LOC digital collections.`
+                    : 'No collections found. The LOC collections endpoint may be temporarily unavailable.',
+            };
+        }
+        return {
+            collections: result.items,
+            total: result.pagination.total,
+            page: result.pagination.page,
+            pages: result.pagination.pages,
+            has_next: result.pagination.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 col of result.collections) {
+            lines.push(`\n## ${col.title}`);
+            lines.push(`**Slug:** ${col.slug}`);
+            if (col.item_count !== undefined)
+                lines.push(`**Items:** ${col.item_count}`);
+            if (col.description)
+                lines.push(col.description);
+            lines.push(`**URL:** ${col.url}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=libofcongress-browse-collections.tool.js.map

package/dist/mcp-server/tools/definitions/libofcongress-browse-collections.tool.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview libofcongress_get_item tool — retrieve full metadata for a LOC digital item.
+ * @module mcp-server/tools/definitions/libofcongress-get-item.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const locGetItem: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    item_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    item_id: z.ZodString;
+    title: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    contributors: z.ZodArray<z.ZodString>;
+    subject_headings: z.ZodArray<z.ZodString>;
+    notes: z.ZodArray<z.ZodString>;
+    rights_information: z.ZodOptional<z.ZodString>;
+    physical_description: z.ZodOptional<z.ZodString>;
+    resource_links: z.ZodArray<z.ZodString>;
+    related_items: z.ZodArray<z.ZodString>;
+    url: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "item_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No item exists for the given ID.";
+    readonly recovery: "Verify the ID from libofcongress_search results. IDs are not guessable — use libofcongress_search to find a valid ID.";
+}, {
+    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-get-item.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-get-item.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-get-item.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,UAAU;;;;;;;;;;;;;;;;;;;;;;;;GA8FrB,CAAC"}

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

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview libofcongress_get_item tool — retrieve full metadata for a LOC digital item.
+ * @module mcp-server/tools/definitions/libofcongress-get-item.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getLocApiService } from '../../../services/loc-api/loc-api-service.js';
+export const locGetItem = tool('libofcongress_get_item', {
+    title: 'Get LOC Item',
+    description: 'Retrieve the full metadata record for a specific LOC digital item. Returns contributors, subjects, rights information, physical description, notes, related items, and links to digital resources (TIFF, JPEG, PDF) for items with digital surrogates. Use after libofcongress_search to get complete details on a result. Pass the bare item ID from the search result — do not include URL path segments.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        item_id: z
+            .string()
+            .min(1)
+            .describe('LOC item ID from a libofcongress_search result\'s "id" field (e.g., "loc.pnp.ppmsc.02404" or "2009632251"). Pass the bare ID only — no URL path segments.'),
+    }),
+    output: z.object({
+        item_id: z.string().describe('The LOC item ID.'),
+        title: z.string().describe('Item title.'),
+        date: z.string().optional().describe('Publication or creation date.'),
+        contributors: z
+            .array(z.string())
+            .describe('Names of contributors, creators, or photographers.'),
+        subject_headings: z.array(z.string()).describe('LCSH subject headings assigned to this item.'),
+        notes: z.array(z.string()).describe('Descriptive notes and annotations from catalogers.'),
+        rights_information: z
+            .string()
+            .optional()
+            .describe('Rights and reproduction statement for this item.'),
+        physical_description: z
+            .string()
+            .optional()
+            .describe('Physical or technical description of the original item.'),
+        resource_links: z
+            .array(z.string())
+            .describe('URLs to downloadable digital files (TIFF, JPEG, PDF). Empty when no digital surrogate exists.'),
+        related_items: z
+            .array(z.string())
+            .describe('IDs or URLs of related LOC items for follow-up retrieval.'),
+        url: z.string().describe('Canonical LOC item URL.'),
+    }),
+    errors: [
+        {
+            reason: 'item_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No item exists for the given ID.',
+            recovery: 'Verify the ID from libofcongress_search results. IDs are not guessable — use libofcongress_search to find a valid ID.',
+        },
+        {
+            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_item', { item_id: input.item_id });
+        const svc = getLocApiService();
+        return svc.getItem(input.item_id, ctx);
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`# ${result.title}`);
+        lines.push(`**ID:** ${result.item_id}`);
+        if (result.date)
+            lines.push(`**Date:** ${result.date}`);
+        if (result.contributors.length > 0)
+            lines.push(`**Contributors:** ${result.contributors.join(', ')}`);
+        if (result.subject_headings.length > 0)
+            lines.push(`**Subjects:** ${result.subject_headings.join(', ')}`);
+        if (result.physical_description)
+            lines.push(`**Physical description:** ${result.physical_description}`);
+        if (result.rights_information)
+            lines.push(`**Rights:** ${result.rights_information}`);
+        if (result.notes.length > 0) {
+            lines.push('**Notes:**');
+            for (const note of result.notes)
+                lines.push(`- ${note}`);
+        }
+        if (result.resource_links.length > 0) {
+            lines.push(`**Digital resources (${result.resource_links.length}):**`);
+            for (const link of result.resource_links.slice(0, 5))
+                lines.push(`- ${link}`);
+            if (result.resource_links.length > 5)
+                lines.push(`- … and ${result.resource_links.length - 5} more`);
+        }
+        if (result.related_items.length > 0) {
+            lines.push(`**Related items:** ${result.related_items.slice(0, 5).join(', ')}`);
+            if (result.related_items.length > 5)
+                lines.push(`- … and ${result.related_items.length - 5} more`);
+        }
+        lines.push(`**URL:** ${result.url}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=libofcongress-get-item.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"libofcongress-get-item.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/libofcongress-get-item.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,EAAE;IACvD,KAAK,EAAE,cAAc;IACrB,WAAW,EACT,6YAA6Y;IAC/Y,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,2JAA2J,CAC5J;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACrE,YAAY,EAAE,CAAC;aACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CAAC,oDAAoD,CAAC;QACjE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC9F,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QACzF,kBAAkB,EAAE,CAAC;aAClB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;QAC/D,oBAAoB,EAAE,CAAC;aACpB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,cAAc,EAAE,CAAC;aACd,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,+FAA+F,CAChG;QACH,aAAa,EAAE,CAAC;aACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CAAC,2DAA2D,CAAC;QACxE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACpD,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,kCAAkC;YACxC,QAAQ,EACN,uHAAuH;SAC1H;QACD;YACE,MAAM,EAAE,qBAAqB;YAC7B,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;YACzC,IAAI,EAAE,6EAA6E;YACnF,QAAQ,EACN,+FAA+F;SAClG;KACF;IAED,OAAO,CAAC,KAAK,EAAE,GAAG;QAChB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,oBAAoB;YAC7B,KAAK,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,kBAAkB;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACtF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,cAAc,CAAC,MAAM,MAAM,CAAC,CAAC;YACvE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC9E,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChF,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * @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 { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const locGetNewspaperPage: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    page_url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    page_url: z.ZodString;
+    newspaper_title: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    edition: z.ZodOptional<z.ZodString>;
+    sequence: z.ZodOptional<z.ZodNumber>;
+    ocr_text: z.ZodString;
+    ocr_available: z.ZodBoolean;
+}, z.core.$strip>, readonly [{
+    readonly reason: "page_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The URL does not resolve to a valid LOC newspaper page resource.";
+    readonly recovery: "Re-run libofcongress_search_newspapers to get a fresh url from current results. Do not modify or guess page URLs.";
+}, {
+    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-get-newspaper-page.tool.d.ts.map

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

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