/**
 * @fileoverview Election lookup tool — find federal election races and candidate
 * financial summaries by office, cycle, state, and district.
 * @module mcp-server/tools/definitions/lookup-elections.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const lookupElections: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    mode: z.ZodDefault<z.ZodEnum<{
        search: "search";
        summary: "summary";
    }>>;
    office: z.ZodEnum<{
        H: "H";
        P: "P";
        S: "S";
    }>;
    cycle: z.ZodNumber;
    state: z.ZodOptional<z.ZodString>;
    district: z.ZodOptional<z.ZodString>;
    zip: z.ZodOptional<z.ZodString>;
    election_full: z.ZodOptional<z.ZodBoolean>;
    page: z.ZodDefault<z.ZodNumber>;
    per_page: z.ZodDefault<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    results: z.ZodArray<z.ZodObject<{}, z.core.$loose>>;
    mode: z.ZodEnum<{
        search: "search";
        summary: "summary";
    }>;
    pagination: z.ZodObject<{
        page: z.ZodNumber;
        pages: z.ZodNumber;
        count: z.ZodNumber;
        per_page: z.ZodNumber;
    }, z.core.$strip>;
    search_criteria: z.ZodObject<{}, z.core.$loose>;
}, z.core.$strip>, readonly [{
    readonly reason: "cycle_must_be_even";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Cycle is an odd year";
    readonly recovery: "Federal election cycles are two-year periods ending in even years (e.g., 2024, 2026).";
}, {
    readonly reason: "missing_state_for_office";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Senate or House office without a state and without a zip";
    readonly recovery: "Provide a two-letter state code (e.g., AZ) or a zip code to scope the senate or house race.";
}, {
    readonly reason: "missing_district_for_house";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "House office without a district number and without a zip";
    readonly recovery: "Provide a two-digit district number (e.g., \"07\") or a zip code to identify the House race.";
}, {
    readonly reason: "summary_does_not_support_zip";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Summary mode invoked with a zip parameter";
    readonly recovery: "Use mode \"search\" for ZIP-based lookups, or remove zip and use state and district for summary mode.";
}, {
    readonly reason: "inputs_not_applicable_to_mode";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "election_full supplied alongside zip — a ZIP-scoped search runs an endpoint that has no such parameter";
    readonly recovery: "Drop election_full to keep the ZIP lookup, or drop zip and scope the race with state and district, where election_full applies.";
}], {
    readonly totalCount: z.ZodNumber;
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=lookup-elections.tool.d.ts.map