/**
 * @fileoverview Tool to fetch full metadata for one or more Census variable codes.
 * @module mcp-server/tools/definitions/census-get-variable
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const censusGetVariable: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    variables: z.ZodArray<z.ZodString>;
    dataset: z.ZodOptional<z.ZodString>;
    year: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    variables: z.ZodArray<z.ZodObject<{
        variable_code: z.ZodString;
        label: z.ZodString;
        concept: z.ZodOptional<z.ZodString>;
        predicate_type: z.ZodString;
        universe: z.ZodOptional<z.ZodString>;
        attribute_of: z.ZodOptional<z.ZodString>;
        attribute_type: z.ZodOptional<z.ZodString>;
        estimate_code: z.ZodOptional<z.ZodString>;
        moe_code: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>>;
    dataset: z.ZodString;
    year: z.ZodNumber;
}, z.core.$strip>, readonly [{
    readonly reason: "variable_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "One or more variable codes were not found in the dataset and year.";
    readonly thrownBy: "service";
    readonly recovery: "Use census_search_variables to discover valid variable codes for this dataset and year.";
}, {
    readonly reason: "dataset_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "Dataset code is not recognized, even after case and shorthand resolution.";
    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 — the dataset's variables.json, groups.json, or an attribute column's own entry — could not be fetched or parsed.";
    readonly retryable: true;
    readonly thrownBy: "service";
    readonly recovery: "Retry the request; if persistent, the dataset and year combination may not be available.";
}], undefined>;
//# sourceMappingURL=census-get-variable.tool.d.ts.map