@cyanheads/openlibrary-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Fetch a work by Open Library Work ID.
+ * @module mcp-server/tools/definitions/openlibrary-get-work.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
+export const openlibraryGetWork = tool('openlibrary_get_work', {
+    title: 'Get Work',
+    description: 'Fetch a work by Open Library Work ID (OL…W). Returns title, description, subjects, cover IDs, and linked author IDs for follow-up lookups. Works represent the abstract book concept independent of any specific edition. Note: author names are not included — use openlibrary_get_author or openlibrary_search_books for names.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        work_id: z
+            .string()
+            .describe('Open Library Work ID. Format: OL…W (e.g., "OL45804W"). A leading "/works/" prefix is stripped if provided.'),
+    }),
+    output: z.object({
+        work_id: z.string().describe('Canonical Open Library Work ID (OL…W).'),
+        title: z.string().describe('Work title.'),
+        description: z
+            .string()
+            .optional()
+            .describe('Work description or blurb. Absent when not provided.'),
+        subjects: z.array(z.string()).describe('Subject tags for this work.'),
+        subject_places: z.array(z.string()).describe('Geographic subjects.'),
+        subject_times: z.array(z.string()).describe('Time period subjects.'),
+        subject_people: z.array(z.string()).describe('People subjects.'),
+        cover_ids: z
+            .array(z.number())
+            .describe('Numeric cover IDs. Pass to openlibrary_get_cover_url with id_type "id".'),
+        author_ids: z
+            .array(z.string())
+            .describe('Open Library Author IDs (OL…A). Use openlibrary_get_author for names and bio.'),
+        created: z
+            .string()
+            .optional()
+            .describe('ISO 8601 creation timestamp. Absent when not available.'),
+        last_modified: z
+            .string()
+            .optional()
+            .describe('ISO 8601 last-modified timestamp. Absent when not available.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Work ID does not exist on Open Library.',
+            recovery: 'Verify the OLID format (e.g., "OL45804W") or use openlibrary_search_books to find the correct ID.',
+        },
+    ],
+    handler(input, ctx) {
+        ctx.log.info('Fetching work', { work_id: input.work_id });
+        const svc = getOpenLibraryService();
+        return svc.getWork(input.work_id, ctx);
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## ${result.title}`);
+        lines.push(`**Work ID:** ${result.work_id}`);
+        if (result.description) {
+            lines.push('');
+            lines.push(result.description);
+        }
+        if (result.author_ids.length) {
+            lines.push('');
+            lines.push(`**Author IDs:** ${result.author_ids.join(', ')}`);
+        }
+        if (result.cover_ids.length) {
+            lines.push(`**Cover IDs:** ${result.cover_ids.join(', ')}`);
+        }
+        if (result.subjects.length) {
+            lines.push(`**Subjects:** ${result.subjects.slice(0, 10).join(', ')}`);
+        }
+        if (result.subject_places.length) {
+            lines.push(`**Places:** ${result.subject_places.join(', ')}`);
+        }
+        if (result.subject_times.length) {
+            lines.push(`**Time periods:** ${result.subject_times.join(', ')}`);
+        }
+        if (result.subject_people.length) {
+            lines.push(`**People:** ${result.subject_people.join(', ')}`);
+        }
+        if (result.created)
+            lines.push(`**Created:** ${result.created}`);
+        if (result.last_modified)
+            lines.push(`**Last modified:** ${result.last_modified}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openlibrary-get-work.tool.js.map

package/dist/mcp-server/tools/definitions/openlibrary-get-work.tool.js.map

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

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

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Search Open Library authors by name.
+ * @module mcp-server/tools/definitions/openlibrary-search-authors.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openlibrarySearchAuthors: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    authors: z.ZodArray<z.ZodObject<{
+        author_id: z.ZodString;
+        name: z.ZodString;
+        alternate_names: z.ZodArray<z.ZodString>;
+        birth_date: z.ZodOptional<z.ZodString>;
+        death_date: z.ZodOptional<z.ZodString>;
+        top_work: z.ZodOptional<z.ZodString>;
+        work_count: z.ZodNumber;
+        top_subjects: z.ZodArray<z.ZodString>;
+        ratings_average: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Query matched no authors.";
+    readonly recovery: "Check the spelling, try a partial name, or use an alternate name form.";
+}]>;
+//# sourceMappingURL=openlibrary-search-authors.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openlibrary-search-authors.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-search-authors.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,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;GAuGnC,CAAC"}

package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.js

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview Search Open Library authors by name.
+ * @module mcp-server/tools/definitions/openlibrary-search-authors.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
+export const openlibrarySearchAuthors = tool('openlibrary_search_authors', {
+    title: 'Search Authors',
+    description: 'Search Open Library authors by name. Returns Open Library Author IDs, names, birth/death dates, top works, and subject associations. Use author IDs for openlibrary_get_author (bio, remote IDs) or openlibrary_get_author_works (list of works).',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        query: z.string().describe('Author name search query. Partial names and alternate names work.'),
+        limit: z.number().int().min(1).max(100).default(10).describe('Max results to return.'),
+        offset: z.number().int().min(0).default(0).describe('Zero-based offset for pagination.'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total matching authors across all pages.'),
+        authors: z
+            .array(z
+            .object({
+            author_id: z.string().describe('Open Library Author ID (OL…A).'),
+            name: z.string().describe('Primary author name.'),
+            alternate_names: z.array(z.string()).describe('Alternate or transliterated names.'),
+            birth_date: z
+                .string()
+                .optional()
+                .describe('Birth date string. Absent when not recorded.'),
+            death_date: z
+                .string()
+                .optional()
+                .describe('Death date string. Absent when not recorded.'),
+            top_work: z
+                .string()
+                .optional()
+                .describe("Title of the author's most popular work. Absent when unavailable."),
+            work_count: z.number().describe('Number of works catalogued for this author.'),
+            top_subjects: z
+                .array(z.string())
+                .describe("Most common subject tags across the author's works."),
+            ratings_average: z
+                .number()
+                .optional()
+                .describe("Average community rating across the author's works. Absent when no ratings exist."),
+        })
+            .describe('A matching author record.'))
+            .describe('Matching authors, up to limit.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty. Absent when results are found.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Query matched no authors.',
+            recovery: 'Check the spelling, try a partial name, or use an alternate name form.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Searching authors', { query: input.query, limit: input.limit });
+        const svc = getOpenLibraryService();
+        const result = await svc.searchAuthors(input.query, input.limit, input.offset, ctx);
+        if (result.authors.length === 0) {
+            return {
+                total: 0,
+                authors: [],
+                message: `No authors matched "${input.query}". Try a partial name, check spelling, or use an alternate name form.`,
+            };
+        }
+        return result;
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**Total:** ${result.total} | **Returned:** ${result.authors.length}`);
+        if (result.message) {
+            lines.push('');
+            lines.push(`> ${result.message}`);
+        }
+        for (const author of result.authors) {
+            lines.push('');
+            lines.push(`## ${author.name}`);
+            lines.push(`**Author ID:** ${author.author_id}`);
+            const meta = [];
+            if (author.birth_date)
+                meta.push(`Born: ${author.birth_date}`);
+            if (author.death_date)
+                meta.push(`Died: ${author.death_date}`);
+            meta.push(`Works: ${author.work_count}`);
+            if (author.ratings_average != null)
+                meta.push(`Rating: ${author.ratings_average.toFixed(1)}`);
+            if (meta.length)
+                lines.push(meta.join(' | '));
+            if (author.top_work)
+                lines.push(`**Top work:** ${author.top_work}`);
+            if (author.alternate_names.length)
+                lines.push(`**Alternate names:** ${author.alternate_names.join(', ')}`);
+            if (author.top_subjects.length)
+                lines.push(`**Top subjects:** ${author.top_subjects.slice(0, 5).join(', ')}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openlibrary-search-authors.tool.js.map

package/dist/mcp-server/tools/definitions/openlibrary-search-authors.tool.js.map

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

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

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Full-text book search across Open Library works.
+ * @module mcp-server/tools/definitions/openlibrary-search-books.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openlibrarySearchBooks: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    subject: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    isbn: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        relevance: "relevance";
+        editions: "editions";
+        new: "new";
+        old: "old";
+        rating: "rating";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    include_availability: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    works: z.ZodArray<z.ZodObject<{
+        work_id: z.ZodString;
+        title: z.ZodString;
+        author_names: z.ZodArray<z.ZodString>;
+        author_ids: z.ZodArray<z.ZodString>;
+        first_publish_year: z.ZodOptional<z.ZodNumber>;
+        edition_count: z.ZodNumber;
+        cover_id: z.ZodOptional<z.ZodNumber>;
+        subjects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        ebook_access: z.ZodEnum<{
+            no_ebook: "no_ebook";
+            printdisabled: "printdisabled";
+            borrowable: "borrowable";
+            public: "public";
+        }>;
+        has_fulltext: z.ZodBoolean;
+        ratings_average: z.ZodOptional<z.ZodNumber>;
+        availability: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            status: z.ZodString;
+            available_to_browse: z.ZodBoolean;
+            available_to_borrow: z.ZodBoolean;
+            available_to_waitlist: z.ZodBoolean;
+            is_readable: z.ZodBoolean;
+            is_lendable: z.ZodBoolean;
+            is_previewable: z.ZodBoolean;
+            is_restricted: z.ZodBoolean;
+            openlibrary_edition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        ia_identifiers: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Query matched no works.";
+    readonly recovery: "Broaden the query, check spelling, or try different search terms.";
+}]>;
+//# sourceMappingURL=openlibrary-search-books.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openlibrary-search-books.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-search-books.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,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyOjC,CAAC"}

package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.js

@@ -0,0 +1,217 @@
+/**
+ * @fileoverview Full-text book search across Open Library works.
+ * @module mcp-server/tools/definitions/openlibrary-search-books.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
+export const openlibrarySearchBooks = tool('openlibrary_search_books', {
+    title: 'Search Books',
+    description: 'Full-text book search across Open Library works. Supports field filters (title, author, subject, publisher, ISBN, language) and returns work-level records with edition counts, cover IDs, and reading availability. Use query for general search or combine specific field filters. Results are work-level — drill into editions via openlibrary_get_editions.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        query: z
+            .string()
+            .optional()
+            .describe('Full-text search query. Supports Solr field prefixes: title:, author:, subject:, publisher:, isbn:, language:. Omit to use the filter parameters instead.'),
+        title: z
+            .string()
+            .optional()
+            .describe('Filter by title. Matched against work title and alternative titles.'),
+        author: z.string().optional().describe('Filter by author name. Partial names work.'),
+        subject: z
+            .string()
+            .optional()
+            .describe('Filter by subject tag (e.g., "science fiction", "history").'),
+        publisher: z
+            .string()
+            .optional()
+            .describe('Filter by publisher name. Partial names work (e.g., "Penguin").'),
+        isbn: z
+            .string()
+            .optional()
+            .describe('Find works that have editions with this ISBN (10 or 13 digits, hyphens ignored).'),
+        language: z
+            .string()
+            .optional()
+            .describe('Two-letter ISO 639-1 language code (e.g., "en", "fr"). Influences but does not exclude results; use language:fr in query to hard-filter.'),
+        sort: z
+            .enum(['relevance', 'new', 'old', 'rating', 'editions'])
+            .default('relevance')
+            .describe('Sort order. "relevance" uses Solr scoring. "new"/"old" sort by first publish year. "rating" by average community rating. "editions" by edition count.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(10)
+            .describe('Max results to return. Higher values increase response size; prefer 10–20 for exploration.'),
+        offset: z.number().int().min(0).default(0).describe('Zero-based offset for pagination.'),
+        include_availability: z
+            .boolean()
+            .default(false)
+            .describe('Include live reading availability from Internet Archive (borrow/read status). Adds ~200ms latency. Use when the user needs to know if they can read the book online.'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total matching works across all pages.'),
+        offset: z.number().describe('Zero-based offset of the first returned result.'),
+        works: z
+            .array(z
+            .object({
+            work_id: z
+                .string()
+                .describe('Open Library Work ID (OL…W). Use for openlibrary_get_work or openlibrary_get_editions.'),
+            title: z.string().describe('Work title.'),
+            author_names: z.array(z.string()).describe('Author display names.'),
+            author_ids: z
+                .array(z.string())
+                .describe('Open Library Author IDs (OL…A) for follow-up lookups.'),
+            first_publish_year: z
+                .number()
+                .optional()
+                .describe('Year of first publication. Absent when unknown.'),
+            edition_count: z.number().describe('Total editions catalogued for this work.'),
+            cover_id: z
+                .number()
+                .optional()
+                .describe('Numeric cover ID. Pass to openlibrary_get_cover_url with id_type "id". Absent when no cover is available.'),
+            subjects: z
+                .array(z.string())
+                .optional()
+                .describe('Up to 5 subject tags. Absent when no subjects are tagged.'),
+            ebook_access: z
+                .enum(['no_ebook', 'printdisabled', 'borrowable', 'public'])
+                .describe('"public" = freely readable. "borrowable" = borrow on Internet Archive. "printdisabled" = access for print-disabled users. "no_ebook" = no digital version.'),
+            has_fulltext: z
+                .boolean()
+                .describe('True when a full-text version exists on Internet Archive.'),
+            ratings_average: z
+                .number()
+                .optional()
+                .describe('Average community rating (1–5). Absent when no ratings exist.'),
+            availability: z
+                .object({
+                status: z.string().describe('Availability status string from Internet Archive.'),
+                available_to_browse: z
+                    .boolean()
+                    .describe('True when the book can be browsed for free.'),
+                available_to_borrow: z.boolean().describe('True when the book can be borrowed.'),
+                available_to_waitlist: z.boolean().describe('True when a waitlist is available.'),
+                is_readable: z.boolean().describe('True when the book is freely readable online.'),
+                is_lendable: z.boolean().describe('True when the book can be lent.'),
+                is_previewable: z.boolean().describe('True when a limited preview is available.'),
+                is_restricted: z.boolean().describe('True when access is restricted.'),
+                openlibrary_edition: z
+                    .string()
+                    .optional()
+                    .describe('Edition OLID the availability check was resolved against.'),
+            })
+                .nullable()
+                .optional()
+                .describe('Live reading availability from Internet Archive. Present when include_availability is true and the work has an Internet Archive item. Null when include_availability is true but no IA item exists.'),
+            ia_identifiers: z
+                .array(z.string())
+                .describe('Internet Archive item identifiers associated with this work.'),
+        })
+            .describe('A work-level result from the search.'))
+            .describe('Matching works, up to limit.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty — echoes the search criteria and suggests how to broaden. Absent when results are found.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Query matched no works.',
+            recovery: 'Broaden the query, check spelling, or try different search terms.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Searching books', {
+            query: input.query,
+            title: input.title,
+            author: input.author,
+            subject: input.subject,
+            limit: input.limit,
+            offset: input.offset,
+        });
+        const svc = getOpenLibraryService();
+        const result = await svc.searchBooks(input, ctx);
+        if (result.works.length === 0) {
+            const terms = [];
+            if (input.query)
+                terms.push(`query "${input.query}"`);
+            if (input.title)
+                terms.push(`title "${input.title}"`);
+            if (input.author)
+                terms.push(`author "${input.author}"`);
+            if (input.subject)
+                terms.push(`subject "${input.subject}"`);
+            const hint = terms.length
+                ? `No works matched ${terms.join(', ')}. Try broader or different terms.`
+                : 'No works matched your search. Try different filters or a general query.';
+            return {
+                total: 0,
+                offset: result.offset,
+                works: [],
+                message: hint,
+            };
+        }
+        return { total: result.total, offset: result.offset, works: result.works };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**Total results:** ${result.total} | **Offset:** ${result.offset} | **Returned:** ${result.works.length}`);
+        if (result.message) {
+            lines.push('');
+            lines.push(`> ${result.message}`);
+        }
+        for (const work of result.works) {
+            lines.push('');
+            lines.push(`## ${work.title}`);
+            lines.push(`**Work ID:** ${work.work_id}`);
+            if (work.author_names.length) {
+                lines.push(`**Authors:** ${work.author_names.join(', ')} (IDs: ${work.author_ids.join(', ')})`);
+            }
+            const meta = [];
+            if (work.first_publish_year != null)
+                meta.push(`First published: ${work.first_publish_year}`);
+            meta.push(`Editions: ${work.edition_count}`);
+            meta.push(`E-book: ${work.ebook_access}`);
+            if (work.has_fulltext)
+                meta.push('Has full text');
+            if (work.ratings_average != null)
+                meta.push(`Rating: ${work.ratings_average.toFixed(1)}`);
+            lines.push(meta.join(' | '));
+            if (work.cover_id != null)
+                lines.push(`**Cover ID:** ${work.cover_id}`);
+            if (work.subjects?.length)
+                lines.push(`**Subjects:** ${work.subjects.join(', ')}`);
+            if (work.ia_identifiers.length)
+                lines.push(`**IA:** ${work.ia_identifiers.join(', ')}`);
+            if (work.availability != null) {
+                const avParts = [
+                    `Status: ${work.availability.status}`,
+                    `Browse: ${work.availability.available_to_browse}`,
+                    `Borrow: ${work.availability.available_to_borrow}`,
+                    `Waitlist: ${work.availability.available_to_waitlist}`,
+                    `Read: ${work.availability.is_readable}`,
+                    `Lend: ${work.availability.is_lendable}`,
+                    `Preview: ${work.availability.is_previewable}`,
+                    `Restricted: ${work.availability.is_restricted}`,
+                ];
+                if (work.availability.openlibrary_edition) {
+                    avParts.push(`Edition: ${work.availability.openlibrary_edition}`);
+                }
+                lines.push(`**Availability:** ${avParts.join(' | ')}`);
+            }
+            else if (work.availability === null) {
+                lines.push('**Availability:** No Internet Archive item found.');
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openlibrary-search-books.tool.js.map

package/dist/mcp-server/tools/definitions/openlibrary-search-books.tool.js.map

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

package/dist/services/open-library/open-library-service.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Open Library REST API client. Handles search, works, editions, authors,
+ * subjects, and cover URL construction with retry and timeout.
+ * @module services/open-library/open-library-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AuthorDetail, AuthorSearchResult, AuthorWork, EditionDetail, EditionIdType, EditionSummary, SearchWork, SubjectWork, WorkDetail } from './types.js';
+export declare class OpenLibraryService {
+    private readonly userAgent;
+    constructor(userAgent: string);
+    private headers;
+    private fetch;
+    searchBooks(params: {
+        query?: string | undefined;
+        title?: string | undefined;
+        author?: string | undefined;
+        subject?: string | undefined;
+        publisher?: string | undefined;
+        isbn?: string | undefined;
+        language?: string | undefined;
+        sort?: string | undefined;
+        limit: number;
+        offset: number;
+        include_availability?: boolean | undefined;
+    }, ctx: Context): Promise<{
+        total: number;
+        offset: number;
+        works: SearchWork[];
+    }>;
+    getWork(workId: string, ctx: Context): Promise<WorkDetail>;
+    getEditions(workId: string, limit: number, offset: number, ctx: Context): Promise<{
+        total: number;
+        work_id: string;
+        editions: EditionSummary[];
+    }>;
+    getEditionByIdentifier(identifier: string, idType: EditionIdType, ctx: Context): Promise<EditionDetail>;
+    searchAuthors(query: string, limit: number, offset: number, ctx: Context): Promise<{
+        total: number;
+        authors: AuthorSearchResult[];
+    }>;
+    getAuthor(authorId: string, ctx: Context): Promise<AuthorDetail>;
+    getAuthorWorks(authorId: string, limit: number, offset: number, ctx: Context): Promise<{
+        total: number;
+        author_id: string;
+        works: AuthorWork[];
+    }>;
+    getSubject(subject: string, limit: number, offset: number, ebooksOnly: boolean, ctx: Context): Promise<{
+        subject_name: string;
+        subject_key: string;
+        work_count: number;
+        works: SubjectWork[];
+    }>;
+    getCoverUrl(identifier: string, idType: 'id' | 'isbn' | 'olid', target: 'book' | 'author', size: 'S' | 'M' | 'L'): string;
+}
+export declare function initOpenLibraryService(): void;
+export declare function getOpenLibraryService(): OpenLibraryService;
+//# sourceMappingURL=open-library-service.d.ts.map

package/dist/services/open-library/open-library-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-library-service.d.ts","sourceRoot":"","sources":["../../../src/services/open-library/open-library-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAItD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EAEX,UAAU,EACX,MAAM,YAAY,CAAC;AA+BpB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,EAAE,MAAM;IAI7B,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IA4BP,WAAW,CACf,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAC5C,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IA4E5D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAuC1D,WAAW,CACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAyCpE,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,aAAa,CAAC;IAoInB,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;IAmCtD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAkDhE,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IA6B/D,UAAU,CACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,EACnB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,WAAW,EAAE,CAAC;KACtB,CAAC;IA8CF,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC9B,MAAM,EAAE,MAAM,GAAG,QAAQ,EACzB,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GACpB,MAAM;CAKV;AAMD,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAO1D"}