/**
 * @fileoverview Search itemized individual contributions (Schedule A) or get
 * aggregate breakdowns by size, state, employer, or occupation. Central tool
 * for answering "who's funding this candidate/committee?"
 * @module mcp-server/tools/definitions/search-contributions.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const searchContributions: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    mode: z.ZodDefault<z.ZodEnum<{
        by_employer: "by_employer";
        by_occupation: "by_occupation";
        by_size: "by_size";
        by_state: "by_state";
        itemized: "itemized";
    }>>;
    committee_id: z.ZodOptional<z.ZodString>;
    candidate_id: z.ZodOptional<z.ZodString>;
    contributor_name: z.ZodOptional<z.ZodString>;
    contributor_employer: z.ZodOptional<z.ZodString>;
    contributor_occupation: z.ZodOptional<z.ZodString>;
    contributor_city: z.ZodOptional<z.ZodString>;
    contributor_state: z.ZodOptional<z.ZodString>;
    contributor_zip: z.ZodOptional<z.ZodString>;
    cycle: z.ZodOptional<z.ZodNumber>;
    min_date: z.ZodOptional<z.ZodString>;
    max_date: z.ZodOptional<z.ZodString>;
    min_amount: z.ZodOptional<z.ZodNumber>;
    max_amount: z.ZodOptional<z.ZodNumber>;
    is_individual: z.ZodOptional<z.ZodBoolean>;
    sort: z.ZodOptional<z.ZodEnum<{
        "-contribution_receipt_amount": "-contribution_receipt_amount";
        "-contribution_receipt_date": "-contribution_receipt_date";
        contribution_receipt_amount: "contribution_receipt_amount";
        contribution_receipt_date: "contribution_receipt_date";
    }>>;
    page: z.ZodDefault<z.ZodNumber>;
    per_page: z.ZodDefault<z.ZodNumber>;
    cursor: z.ZodOptional<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    results: z.ZodArray<z.ZodObject<{}, z.core.$loose>>;
    mode: z.ZodEnum<{
        by_employer: "by_employer";
        by_occupation: "by_occupation";
        by_size: "by_size";
        by_size_candidate: "by_size_candidate";
        by_state: "by_state";
        by_state_candidate: "by_state_candidate";
        itemized: "itemized";
    }>;
    committee: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
    count: z.ZodOptional<z.ZodNumber>;
    pagination: z.ZodOptional<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: "itemized_requires_committee_id";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Itemized mode invoked without a committee_id";
    readonly recovery: "Provide a committee_id, switch to a by_size or by_state aggregate mode with candidate_id, or look up the candidate's committee with openfec_search_committees.";
}, {
    readonly reason: "aggregate_requires_committee_id";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "by_employer or by_occupation aggregate without a committee_id";
    readonly recovery: "These aggregates roll up to a single committee — provide a committee_id for the spending committee.";
}, {
    readonly reason: "itemized_only_filters_in_aggregate_mode";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it";
    readonly recovery: "Re-run with mode \"itemized\" (requires committee_id) to filter by contributor, date range, or amount, or drop the named inputs to keep the aggregate. Aggregate modes accept only committee_id, candidate_id, cycle, mode, page, per_page.";
}], {
    readonly totalCount: z.ZodNumber;
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=search-contributions.tool.d.ts.map