/**
 * @fileoverview PubMed citation tool — generates formatted citations (APA, MLA,
 * BibTeX, RIS) for one or more PubMed articles.
 * @module src/mcp-server/tools/definitions/format-citations.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
export declare const formatCitationsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    pmids: z.ZodArray<z.ZodString>;
    format: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
        apa: "apa";
        mla: "mla";
        bibtex: "bibtex";
        ris: "ris";
    }>, z.ZodArray<z.ZodEnum<{
        apa: "apa";
        mla: "mla";
        bibtex: "bibtex";
        ris: "ris";
    }>>]>>;
}, z.core.$strip>, z.ZodObject<{
    citations: z.ZodArray<z.ZodObject<{
        pmid: z.ZodString;
        title: z.ZodOptional<z.ZodString>;
        citations: z.ZodRecord<z.ZodString, z.ZodString>;
    }, z.core.$strip>>;
    totalSubmitted: z.ZodNumber;
    totalFormatted: z.ZodNumber;
    unavailablePmids: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strip>, readonly [{
    readonly reason: "queue_full";
    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
    readonly when: "Local NCBI request queue is at capacity.";
    readonly recovery: "Retry after 1-2 seconds; the request queue hit the NCBI rate limit.";
    readonly retryable: true;
}, {
    readonly reason: "ncbi_unreachable";
    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "NCBI E-utilities is unreachable after all retry attempts.";
    readonly recovery: "Retry after a brief delay; NCBI was unreachable across all retry attempts.";
    readonly retryable: true;
}, {
    readonly reason: "ncbi_deadline_exceeded";
    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Timeout;
    readonly when: "Total request deadline expired before NCBI returned a response.";
    readonly recovery: "Reduce batch size or retry; NCBI may be under temporary load.";
    readonly retryable: true;
}, {
    readonly reason: "ncbi_invalid_response";
    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.SerializationError;
    readonly when: "NCBI returned a body that could not be parsed (invalid XML/JSON).";
    readonly recovery: "Retry the request; NCBI returned a malformed response that could not be parsed.";
    readonly retryable: true;
}, {
    readonly reason: "ncbi_resource_not_found";
    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
    readonly when: "NCBI returned a structured \"not found\" error for the requested ID(s).";
    readonly recovery: "Verify the ID exists in PubMed; the resource was not found in NCBI and retrying will not help.";
    readonly retryable: false;
}]>;
//# sourceMappingURL=format-citations.tool.d.ts.map