/**
 * @fileoverview Tool to search Census Bureau variables by keyword across labels and concepts.
 * @module mcp-server/tools/definitions/census-search-variables
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const censusSearchVariables: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    query: z.ZodString;
    dataset: z.ZodOptional<z.ZodString>;
    year: z.ZodOptional<z.ZodNumber>;
    limit: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    variables: z.ZodArray<z.ZodObject<{
        variable_code: z.ZodString;
        label: z.ZodString;
        concept: z.ZodString;
        predicate_type: z.ZodString;
        estimate_code: z.ZodOptional<z.ZodString>;
        moe_code: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>>;
}, z.core.$strip>, readonly [{
    readonly reason: "dataset_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "Dataset code is not recognized.";
    readonly thrownBy: "service";
    readonly recovery: "Call census_list_datasets to discover valid dataset codes like acs/acs5.";
}, {
    readonly reason: "year_not_available";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "The dataset does not serve the requested vintage year.";
    readonly thrownBy: "service";
    readonly recovery: "Retry with a year from available_years in census_list_datasets; the error names the years this dataset serves.";
}, {
    readonly reason: "variables_unavailable";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "Variable metadata could not be fetched or parsed from the Census API.";
    readonly retryable: true;
    readonly thrownBy: "service";
    readonly recovery: "Retry the request; if persistent, the dataset and year combination may not be available.";
}], {
    readonly effectiveQuery: z.ZodString;
    readonly dataset: z.ZodString;
    readonly year: z.ZodNumber;
    readonly totalMatches: z.ZodNumber;
    readonly truncated: z.ZodOptional<z.ZodBoolean>;
    readonly shown: z.ZodOptional<z.ZodNumber>;
    readonly cap: z.ZodOptional<z.ZodNumber>;
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=census-search-variables.tool.d.ts.map