@cyanheads/openlibrary-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Resolve cover image URLs from Open Library's Covers API.
+ * @module mcp-server/tools/definitions/openlibrary-get-cover-url.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const openlibraryGetCoverUrl: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    identifier: z.ZodString;
+    id_type: z.ZodEnum<{
+        isbn: "isbn";
+        olid: "olid";
+        id: "id";
+    }>;
+    target: z.ZodDefault<z.ZodEnum<{
+        author: "author";
+        book: "book";
+    }>>;
+    size: z.ZodDefault<z.ZodEnum<{
+        S: "S";
+        M: "M";
+        L: "L";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    url: z.ZodString;
+    note: z.ZodString;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=openlibrary-get-cover-url.tool.d.ts.map

package/dist/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openlibrary-get-cover-url.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;6BA+DjC,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Resolve cover image URLs from Open Library's Covers API.
+ * @module mcp-server/tools/definitions/openlibrary-get-cover-url.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenLibraryService } from '../../../services/open-library/open-library-service.js';
+export const openlibraryGetCoverUrl = tool('openlibrary_get_cover_url', {
+    title: 'Get Cover URL',
+    description: 'Resolve a cover image URL for a book or author photo. Returns a direct HTTPS URL in the requested size (S/M/L). The Covers API always returns HTTP 200 — missing covers return a 1×1 placeholder GIF, not a 404. URLs can be embedded in markdown as ![cover](url).',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        identifier: z
+            .string()
+            .describe('The identifier value. For "id": numeric cover ID from work/edition data. For "isbn": 10 or 13 digits, hyphens stripped. For "olid": edition OLID (OL…M) or author OLID (OL…A) when target is "author".'),
+        id_type: z
+            .enum(['id', 'isbn', 'olid'])
+            .describe('"id" is the numeric cover_i / cover ID from search or work results. "isbn" and "olid" look up the cover from those identifiers.'),
+        target: z
+            .enum(['book', 'author'])
+            .default('book')
+            .describe('"book" returns a book cover from covers.openlibrary.org/b/. "author" returns an author photo from covers.openlibrary.org/a/ — use with id_type "id" (photo_id) or "olid" (author OLID).'),
+        size: z
+            .enum(['S', 'M', 'L'])
+            .default('M')
+            .describe('Image size. S = small (~45px tall), M = medium (~150px tall), L = large (~400px tall).'),
+    }),
+    output: z.object({
+        url: z
+            .string()
+            .describe('Direct HTTPS URL to the cover image. The Covers API returns HTTP 200 for all requests — a 1×1 placeholder GIF is returned when no cover exists for the identifier.'),
+        note: z
+            .string()
+            .describe('Reminder that the URL always returns HTTP 200; a placeholder GIF is served when no cover exists.'),
+    }),
+    handler(input, ctx) {
+        ctx.log.info('Resolving cover URL', {
+            identifier: input.identifier,
+            id_type: input.id_type,
+            target: input.target,
+            size: input.size,
+        });
+        const svc = getOpenLibraryService();
+        const url = svc.getCoverUrl(input.identifier, input.id_type, input.target, input.size);
+        return {
+            url,
+            note: 'The Covers API returns HTTP 200 for all requests — a 1×1 placeholder GIF is served if no cover exists for this identifier.',
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**Cover URL:** ${result.url}`);
+        lines.push(`**Note:** ${result.note}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openlibrary-get-cover-url.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openlibrary-get-cover-url.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-get-cover-url.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,2BAA2B,EAAE;IACtE,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,qQAAqQ;IACvQ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IACzD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CACP,wMAAwM,CACzM;QACH,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;aAC5B,QAAQ,CACP,iIAAiI,CAClI;QACH,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;aACxB,OAAO,CAAC,MAAM,CAAC;aACf,QAAQ,CACP,yLAAyL,CAC1L;QACH,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;aACrB,OAAO,CAAC,GAAG,CAAC;aACZ,QAAQ,CACP,wFAAwF,CACzF;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,CACP,oKAAoK,CACrK;QACH,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,kGAAkG,CACnG;KACJ,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,GAAG;QAChB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvF,OAAO;YACL,GAAG;YACH,IAAI,EAAE,4HAA4H;SACnI,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,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/openlibrary-get-edition.tool.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Fetch a single edition by identifier (ISBN, OCLC, LCCN, or OLID).
+ * @module mcp-server/tools/definitions/openlibrary-get-edition.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openlibraryGetEdition: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    identifier: z.ZodString;
+    id_type: z.ZodEnum<{
+        isbn: "isbn";
+        oclc: "oclc";
+        lccn: "lccn";
+        olid: "olid";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    edition_id: z.ZodString;
+    title: z.ZodString;
+    authors: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        author_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    publish_date: z.ZodOptional<z.ZodString>;
+    publishers: z.ZodArray<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    isbn_10: z.ZodArray<z.ZodString>;
+    isbn_13: z.ZodArray<z.ZodString>;
+    oclc: z.ZodArray<z.ZodString>;
+    lccn: z.ZodArray<z.ZodString>;
+    page_count: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    cover_ids: z.ZodArray<z.ZodNumber>;
+    work_id: z.ZodOptional<z.ZodString>;
+    ebook_url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No edition found for the given identifier.";
+    readonly recovery: "Verify the identifier value or try searching by title/author with openlibrary_search_books.";
+}, {
+    readonly reason: "invalid_identifier";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Identifier format is invalid for the specified id_type.";
+    readonly recovery: "Check the identifier format: ISBNs are 10 or 13 digits; OLIDs end in M (e.g., OL7353617M).";
+}]>;
+//# sourceMappingURL=openlibrary-get-edition.tool.d.ts.map

package/dist/mcp-server/tools/definitions/openlibrary-get-edition.tool.d.ts.map

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

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

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Fetch a single edition by identifier (ISBN, OCLC, LCCN, or OLID).
+ * @module mcp-server/tools/definitions/openlibrary-get-edition.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 openlibraryGetEdition = tool('openlibrary_get_edition', {
+    title: 'Get Edition',
+    description: 'Fetch a single edition by identifier: ISBN-10, ISBN-13, OCLC, LCCN, or Open Library Edition ID (OL…M). Returns full edition metadata including authors, publisher, language, all identifier types, and the parent work ID. Use for ISBN lookups — pass id_type "isbn" for both ISBN-10 and ISBN-13.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        identifier: z
+            .string()
+            .describe('The identifier value. For ISBN: 10 or 13 digits, hyphens stripped. For OCLC: numeric string. For LCCN: string as-is. For OLID: Open Library edition ID (e.g., OL7353617M).'),
+        id_type: z
+            .enum(['isbn', 'oclc', 'lccn', 'olid'])
+            .describe('Identifier type. "isbn" handles both ISBN-10 and ISBN-13. "olid" is the native Open Library edition ID (OL…M).'),
+    }),
+    output: z.object({
+        edition_id: z.string().describe('Open Library Edition ID (OL…M).'),
+        title: z.string().describe('Edition title.'),
+        authors: z
+            .array(z
+            .object({
+            name: z.string().describe('Author display name.'),
+            author_id: z
+                .string()
+                .optional()
+                .describe('Open Library Author ID (OL…A). Use openlibrary_get_author for bio and details.'),
+        })
+            .describe('An author contributor for this edition.'))
+            .describe('Authors of this edition.'),
+        publish_date: z
+            .string()
+            .optional()
+            .describe('Publication date string. Absent when not recorded.'),
+        publishers: z.array(z.string()).describe('Publisher names.'),
+        language: z
+            .string()
+            .optional()
+            .describe('3-letter ISO language code (e.g., "eng"). Absent when not recorded.'),
+        isbn_10: z.array(z.string()).describe('ISBN-10 identifiers.'),
+        isbn_13: z.array(z.string()).describe('ISBN-13 identifiers.'),
+        oclc: z.array(z.string()).describe('OCLC/WorldCat numbers.'),
+        lccn: z.array(z.string()).describe('Library of Congress Control Numbers.'),
+        page_count: z.number().optional().describe('Page count. Absent when not recorded.'),
+        description: z.string().optional().describe('Edition description. Absent when not provided.'),
+        cover_ids: z.array(z.number()).describe('Numeric cover IDs for openlibrary_get_cover_url.'),
+        work_id: z
+            .string()
+            .optional()
+            .describe('Parent Work ID (OL…W). Use openlibrary_get_work for work-level metadata.'),
+        ebook_url: z
+            .string()
+            .optional()
+            .describe('Internet Archive URL for reading/borrowing. Present when an IA item exists.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No edition found for the given identifier.',
+            recovery: 'Verify the identifier value or try searching by title/author with openlibrary_search_books.',
+        },
+        {
+            reason: 'invalid_identifier',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Identifier format is invalid for the specified id_type.',
+            recovery: 'Check the identifier format: ISBNs are 10 or 13 digits; OLIDs end in M (e.g., OL7353617M).',
+        },
+    ],
+    handler(input, ctx) {
+        ctx.log.info('Fetching edition', { identifier: input.identifier, id_type: input.id_type });
+        // Basic validation — return rejected Promise so callers can use await
+        if (input.id_type === 'isbn') {
+            const digits = input.identifier.replace(/-/g, '');
+            if (!/^\d{10}$/.test(digits) && !/^\d{13}$/.test(digits)) {
+                return Promise.reject(ctx.fail('invalid_identifier', `"${input.identifier}" is not a valid ISBN (must be 10 or 13 digits).`));
+            }
+        }
+        else if (input.id_type === 'olid') {
+            if (!/^OL\d+M$/i.test(input.identifier)) {
+                return Promise.reject(ctx.fail('invalid_identifier', `"${input.identifier}" is not a valid Open Library Edition ID. Expected format: OL…M (e.g., OL7353617M).`));
+            }
+        }
+        const svc = getOpenLibraryService();
+        return svc.getEditionByIdentifier(input.identifier, input.id_type, ctx);
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## ${result.title}`);
+        lines.push(`**Edition ID:** ${result.edition_id}`);
+        if (result.authors.length) {
+            const authorStr = result.authors
+                .map((a) => (a.author_id ? `${a.name} (${a.author_id})` : a.name))
+                .join(', ');
+            lines.push(`**Authors:** ${authorStr}`);
+        }
+        const meta = [];
+        if (result.publish_date)
+            meta.push(`Published: ${result.publish_date}`);
+        if (result.publishers.length)
+            meta.push(`Publisher: ${result.publishers.join(', ')}`);
+        if (result.language)
+            meta.push(`Language: ${result.language}`);
+        if (result.page_count != null)
+            meta.push(`Pages: ${result.page_count}`);
+        if (meta.length)
+            lines.push(meta.join(' | '));
+        if (result.isbn_13.length)
+            lines.push(`**ISBN-13:** ${result.isbn_13.join(', ')}`);
+        if (result.isbn_10.length)
+            lines.push(`**ISBN-10:** ${result.isbn_10.join(', ')}`);
+        if (result.oclc.length)
+            lines.push(`**OCLC:** ${result.oclc.join(', ')}`);
+        if (result.lccn.length)
+            lines.push(`**LCCN:** ${result.lccn.join(', ')}`);
+        if (result.description) {
+            lines.push('');
+            lines.push(result.description);
+        }
+        if (result.cover_ids.length)
+            lines.push(`**Cover IDs:** ${result.cover_ids.join(', ')}`);
+        if (result.work_id)
+            lines.push(`**Work ID:** ${result.work_id}`);
+        if (result.ebook_url)
+            lines.push(`**E-book:** ${result.ebook_url}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openlibrary-get-edition.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openlibrary-get-edition.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/openlibrary-get-edition.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,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,yBAAyB,EAAE;IACnE,KAAK,EAAE,aAAa;IACpB,WAAW,EACT,qSAAqS;IACvS,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CACP,4KAA4K,CAC7K;QACH,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;aACtC,QAAQ,CACP,gHAAgH,CACjH;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC5C,OAAO,EAAE,CAAC;aACP,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACjD,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,gFAAgF,CACjF;SACJ,CAAC;aACD,QAAQ,CAAC,yCAAyC,CAAC,CACvD;aACA,QAAQ,CAAC,0BAA0B,CAAC;QACvC,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;QACjE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC5D,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;QAClF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC7D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC7D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC5D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACnF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAC7F,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC3F,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0EAA0E,CAAC;QACvF,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,6EAA6E,CAAC;KAC3F,CAAC;IACF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,4CAA4C;YAClD,QAAQ,EACN,6FAA6F;SAChG;QACD;YACE,MAAM,EAAE,oBAAoB;YAC5B,IAAI,EAAE,gBAAgB,CAAC,aAAa;YACpC,IAAI,EAAE,yDAAyD;YAC/D,QAAQ,EACN,4FAA4F;SAC/F;KACF;IAED,OAAO,CAAC,KAAK,EAAE,GAAG;QAChB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAE3F,sEAAsE;QACtE,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,OAAO,OAAO,CAAC,MAAM,CACnB,GAAG,CAAC,IAAI,CACN,oBAAoB,EACpB,IAAI,KAAK,CAAC,UAAU,kDAAkD,CACvE,CACF,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,OAAO,OAAO,CAAC,MAAM,CACnB,GAAG,CAAC,IAAI,CACN,oBAAoB,EACpB,IAAI,KAAK,CAAC,UAAU,qFAAqF,CAC1G,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;iBAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;iBACjE,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,YAAY;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,MAAM,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzF,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACpE,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/openlibrary-get-editions.tool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview List editions of a work.
+ * @module mcp-server/tools/definitions/openlibrary-get-editions.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openlibraryGetEditions: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    work_id: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    work_id: z.ZodString;
+    editions: z.ZodArray<z.ZodObject<{
+        edition_id: z.ZodString;
+        title: z.ZodString;
+        publish_date: z.ZodOptional<z.ZodString>;
+        publishers: z.ZodArray<z.ZodString>;
+        languages: z.ZodArray<z.ZodString>;
+        isbn_10: z.ZodArray<z.ZodString>;
+        isbn_13: z.ZodArray<z.ZodString>;
+        page_count: z.ZodOptional<z.ZodNumber>;
+        cover_ids: z.ZodArray<z.ZodNumber>;
+        work_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Work ID does not exist on Open Library.";
+    readonly recovery: "Verify the Work ID format (e.g., \"OL45804W\") or use openlibrary_search_books first.";
+}]>;
+//# sourceMappingURL=openlibrary-get-editions.tool.d.ts.map

package/dist/mcp-server/tools/definitions/openlibrary-get-editions.tool.d.ts.map

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

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

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview List editions of a work.
+ * @module mcp-server/tools/definitions/openlibrary-get-editions.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 openlibraryGetEditions = tool('openlibrary_get_editions', {
+    title: 'Get Editions',
+    description: 'List editions of a work — different publishers, languages, formats, and print runs. Returns ISBNs, publisher, language, page count, and edition OLIDs. Use after openlibrary_get_work or openlibrary_search_books to find a specific printing.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        work_id: z
+            .string()
+            .describe('Open Library Work ID (OL…W). A leading "/works/" prefix is stripped if provided.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(10)
+            .describe('Max editions to return. Prefer 10–20 for exploration.'),
+        offset: z.number().int().min(0).default(0).describe('Zero-based offset for pagination.'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total editions for this work.'),
+        work_id: z.string().describe('Open Library Work ID.'),
+        editions: z
+            .array(z
+            .object({
+            edition_id: z
+                .string()
+                .describe('Open Library Edition ID (OL…M). Use for openlibrary_get_edition with id_type "olid".'),
+            title: z
+                .string()
+                .describe('Edition title (may differ from work title for translated editions).'),
+            publish_date: z
+                .string()
+                .optional()
+                .describe('Publication date string (e.g., "2003", "January 2003"). Absent when not recorded.'),
+            publishers: z.array(z.string()).describe('Publisher names.'),
+            languages: z
+                .array(z.string())
+                .describe('3-letter ISO language codes (e.g., "eng", "fre").'),
+            isbn_10: z.array(z.string()).describe('ISBN-10 identifiers.'),
+            isbn_13: z.array(z.string()).describe('ISBN-13 identifiers.'),
+            page_count: z.number().optional().describe('Page count. Absent when not recorded.'),
+            cover_ids: z
+                .array(z.number())
+                .describe('Numeric cover IDs for openlibrary_get_cover_url.'),
+            work_id: z
+                .string()
+                .optional()
+                .describe('Parent Work ID. Usually matches the requested work_id.'),
+        })
+            .describe('A single edition of the work.'))
+            .describe('Editions of the work, up to limit.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Work ID does not exist on Open Library.',
+            recovery: 'Verify the Work ID format (e.g., "OL45804W") or use openlibrary_search_books first.',
+        },
+    ],
+    handler(input, ctx) {
+        ctx.log.info('Fetching editions', {
+            work_id: input.work_id,
+            limit: input.limit,
+            offset: input.offset,
+        });
+        const svc = getOpenLibraryService();
+        return svc.getEditions(input.work_id, input.limit, input.offset, ctx);
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**Work ID:** ${result.work_id} | **Total editions:** ${result.total} | **Returned:** ${result.editions.length}`);
+        for (const ed of result.editions) {
+            lines.push('');
+            lines.push(`### ${ed.title}`);
+            lines.push(`**Edition ID:** ${ed.edition_id}`);
+            const meta = [];
+            if (ed.publish_date)
+                meta.push(`Published: ${ed.publish_date}`);
+            if (ed.publishers.length)
+                meta.push(`Publisher: ${ed.publishers.join(', ')}`);
+            if (ed.languages.length)
+                meta.push(`Language: ${ed.languages.join(', ')}`);
+            if (ed.page_count != null)
+                meta.push(`Pages: ${ed.page_count}`);
+            if (meta.length)
+                lines.push(meta.join(' | '));
+            if (ed.isbn_13.length)
+                lines.push(`**ISBN-13:** ${ed.isbn_13.join(', ')}`);
+            if (ed.isbn_10.length)
+                lines.push(`**ISBN-10:** ${ed.isbn_10.join(', ')}`);
+            if (ed.cover_ids.length)
+                lines.push(`**Cover IDs:** ${ed.cover_ids.join(', ')}`);
+            if (ed.work_id)
+                lines.push(`**Work ID:** ${ed.work_id}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openlibrary-get-editions.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Browse works by subject on Open Library.
+ * @module mcp-server/tools/definitions/openlibrary-get-subject.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openlibraryGetSubject: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    subject: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    ebooks_only: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    subject_name: z.ZodString;
+    subject_key: z.ZodString;
+    work_count: z.ZodNumber;
+    works: z.ZodArray<z.ZodObject<{
+        work_id: z.ZodString;
+        title: z.ZodString;
+        author_names: z.ZodArray<z.ZodString>;
+        edition_count: z.ZodNumber;
+        cover_id: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Subject not found or has no works.";
+    readonly recovery: "Try a broader or alternate subject term (e.g., \"fiction\" instead of a specific subgenre).";
+}]>;
+//# sourceMappingURL=openlibrary-get-subject.tool.d.ts.map

package/dist/mcp-server/tools/definitions/openlibrary-get-subject.tool.d.ts.map

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

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

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Browse works by subject on Open Library.
+ * @module mcp-server/tools/definitions/openlibrary-get-subject.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 openlibraryGetSubject = tool('openlibrary_get_subject', {
+    title: 'Get Subject',
+    description: 'Browse works by subject. Returns matching works with edition counts and cover IDs, plus the total work count for the subject. Subjects are user-contributed and may be inconsistent ("science fiction", "Science fiction", "SF" are separate tags). Try lowercase forms first.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        subject: z
+            .string()
+            .describe('Subject name. Spaces are converted to underscores internally (e.g., "science fiction" → "science_fiction"). Use lowercase for best results.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(12)
+            .describe('Max works to return. Subject pages typically show 12 at a time.'),
+        offset: z.number().int().min(0).default(0).describe('Zero-based offset for pagination.'),
+        ebooks_only: z
+            .boolean()
+            .default(false)
+            .describe('Restrict to works with a readable or borrowable e-book on Internet Archive.'),
+    }),
+    output: z.object({
+        subject_name: z.string().describe('Canonical subject name as stored on Open Library.'),
+        subject_key: z.string().describe('Normalized subject key (lowercase, underscores).'),
+        work_count: z.number().describe('Total works tagged with this subject.'),
+        works: z
+            .array(z
+            .object({
+            work_id: z.string().describe('Open Library Work ID (OL…W).'),
+            title: z.string().describe('Work title.'),
+            author_names: z.array(z.string()).describe('Author display names.'),
+            edition_count: z.number().describe('Total editions for this work.'),
+            cover_id: z
+                .number()
+                .optional()
+                .describe('Numeric cover ID. Absent when no cover exists.'),
+        })
+            .describe('A work under this subject.'))
+            .describe('Works under this subject, up to limit.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Subject not found or has no works.',
+            recovery: 'Try a broader or alternate subject term (e.g., "fiction" instead of a specific subgenre).',
+        },
+    ],
+    handler(input, ctx) {
+        ctx.log.info('Fetching subject', {
+            subject: input.subject,
+            limit: input.limit,
+            ebooks_only: input.ebooks_only,
+        });
+        const svc = getOpenLibraryService();
+        return svc.getSubject(input.subject, input.limit, input.offset, input.ebooks_only, ctx);
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## Subject: ${result.subject_name}`);
+        lines.push(`**Key:** ${result.subject_key} | **Total works:** ${result.work_count} | **Returned:** ${result.works.length}`);
+        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(', ')}`);
+            lines.push(`**Editions:** ${work.edition_count}`);
+            if (work.cover_id != null)
+                lines.push(`**Cover ID:** ${work.cover_id}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=openlibrary-get-subject.tool.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Fetch a work by Open Library Work ID.
+ * @module mcp-server/tools/definitions/openlibrary-get-work.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const openlibraryGetWork: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    work_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    work_id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    subjects: z.ZodArray<z.ZodString>;
+    subject_places: z.ZodArray<z.ZodString>;
+    subject_times: z.ZodArray<z.ZodString>;
+    subject_people: z.ZodArray<z.ZodString>;
+    cover_ids: z.ZodArray<z.ZodNumber>;
+    author_ids: z.ZodArray<z.ZodString>;
+    created: z.ZodOptional<z.ZodString>;
+    last_modified: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Work ID does not exist on Open Library.";
+    readonly recovery: "Verify the OLID format (e.g., \"OL45804W\") or use openlibrary_search_books to find the correct ID.";
+}]>;
+//# sourceMappingURL=openlibrary-get-work.tool.d.ts.map

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

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