/**
 * @fileoverview Tool for searching the Project Gutenberg catalog by title, author,
 * topic, language, author lifespan, or a specific list of IDs.
 * @module mcp-server/tools/definitions/gutenberg-search-books
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const gutenbergSearchBooks: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    query: z.ZodOptional<z.ZodString>;
    topic: z.ZodOptional<z.ZodString>;
    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
    author_year_start: z.ZodOptional<z.ZodNumber>;
    author_year_end: z.ZodOptional<z.ZodNumber>;
    sort: z.ZodDefault<z.ZodEnum<{
        ascending: "ascending";
        descending: "descending";
        popular: "popular";
    }>>;
    ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
    page: z.ZodDefault<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    books: z.ZodArray<z.ZodObject<{
        id: z.ZodNumber;
        title: z.ZodString;
        authors: z.ZodArray<z.ZodObject<{
            name: z.ZodString;
            birth_year: z.ZodNullable<z.ZodNumber>;
            death_year: z.ZodNullable<z.ZodNumber>;
        }, z.core.$strip>>;
        languages: z.ZodArray<z.ZodString>;
        subjects: z.ZodArray<z.ZodString>;
        download_count: z.ZodNumber;
        has_plain_text: z.ZodBoolean;
    }, z.core.$strip>>;
    totalCount: z.ZodNumber;
    page: z.ZodNumber;
    hasMore: z.ZodBoolean;
}, z.core.$strip>, readonly [{
    readonly reason: "no_results";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "The query matched no books in the catalog.";
    readonly recovery: "Broaden the search — try fewer or different query words, remove language filters, or check the topic spelling.";
}, {
    readonly reason: "page_out_of_range";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "The requested page number is past the last page of results for this query.";
    readonly recovery: "Request a page within the available range, or restart at page 1. The first page reports totalCount — divide it by the page size (32) to find the last page.";
}, {
    readonly reason: "catalog_unavailable";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "The Project Gutenberg catalog did not answer within the time this server allows for one search.";
    readonly recovery: "The catalog is unreachable or too slow right now. Retry in a few seconds; if it keeps failing, the catalog service itself is degraded and a different query will not help.";
    readonly retryable: true;
    readonly thrownBy: "service";
}], undefined>;
//# sourceMappingURL=gutenberg-search-books.tool.d.ts.map