/**
 * @fileoverview Tool for searching and retrieving FEC candidate records.
 * Supports full-text search, single-candidate lookup by ID, and optional
 * financial totals merging from the /candidates/totals/ endpoint.
 * @module mcp-server/tools/definitions/search-candidates.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const searchCandidates: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    query: z.ZodOptional<z.ZodString>;
    candidate_id: z.ZodOptional<z.ZodString>;
    state: z.ZodOptional<z.ZodString>;
    district: z.ZodOptional<z.ZodString>;
    office: z.ZodOptional<z.ZodEnum<{
        H: "H";
        P: "P";
        S: "S";
    }>>;
    party: z.ZodOptional<z.ZodString>;
    cycle: z.ZodOptional<z.ZodNumber>;
    election_year: z.ZodOptional<z.ZodNumber>;
    incumbent_challenge: z.ZodOptional<z.ZodEnum<{
        C: "C";
        I: "I";
        O: "O";
    }>>;
    candidate_status: z.ZodOptional<z.ZodEnum<{
        C: "C";
        F: "F";
        N: "N";
        P: "P";
    }>>;
    has_raised_funds: z.ZodOptional<z.ZodBoolean>;
    include_totals: z.ZodOptional<z.ZodBoolean>;
    page: z.ZodDefault<z.ZodNumber>;
    per_page: z.ZodDefault<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    candidates: z.ZodArray<z.ZodObject<{}, z.core.$loose>>;
    totals: z.ZodOptional<z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
    missing_totals: z.ZodOptional<z.ZodArray<z.ZodString>>;
    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: "candidate_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "Single-candidate lookup by candidate_id returned no record";
    readonly recovery: "Verify the candidate_id format (H/S/P + digits) or drop it and search by name, state, or cycle.";
}], {
    readonly totalCount: z.ZodNumber;
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=search-candidates.tool.d.ts.map