/**
 * @fileoverview Tool for browsing the most-downloaded Project Gutenberg books,
 * optionally filtered by language or topic.
 * @module mcp-server/tools/definitions/gutenberg-browse-popular
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const gutenbergBrowsePopular: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
    topic: z.ZodOptional<z.ZodString>;
    limit: 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>;
        download_count: z.ZodNumber;
        has_plain_text: z.ZodBoolean;
    }, z.core.$strip>>;
    totalInCatalog: z.ZodNumber;
}, z.core.$strip>, readonly [{
    readonly reason: "no_results";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "No books match the language/topic filter combination.";
    readonly recovery: "Try a broader topic phrase or remove the language filter. The catalog is large but topic matching is phrase-based — \"detective fiction\" may miss books shelved under \"Mystery\".";
}, {
    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 browse.";
    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 narrower filter will not help.";
    readonly retryable: true;
    readonly thrownBy: "service";
}], {
    readonly truncated: z.ZodBoolean;
    readonly shown: z.ZodNumber;
    readonly cap: z.ZodNumber;
    readonly truncationCeiling: z.ZodOptional<z.ZodNumber>;
}>;
//# sourceMappingURL=gutenberg-browse-popular.tool.d.ts.map