/**
 * @fileoverview Tool to resolve place names and addresses to Census FIPS identifiers.
 * @module mcp-server/tools/definitions/census-resolve-geography
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const censusResolveGeography: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    name: z.ZodString;
    geography_type: z.ZodOptional<z.ZodEnum<{
        "combined statistical area": "combined statistical area";
        "consolidated city": "consolidated city";
        county: "county";
        "metropolitan statistical area/micropolitan statistical area": "metropolitan statistical area/micropolitan statistical area";
        place: "place";
        state: "state";
        tract: "tract";
    }>>;
    county_fips: z.ZodOptional<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    name: z.ZodString;
    geography_type: z.ZodString;
    state_fips: z.ZodOptional<z.ZodString>;
    county_fips: z.ZodOptional<z.ZodString>;
    tract_fips: z.ZodOptional<z.ZodString>;
    place_fips: z.ZodOptional<z.ZodString>;
    fips_summary: z.ZodString;
}, z.core.$strip>, readonly [{
    readonly reason: "no_match";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "Place name not recognized at any geography level tried for it.";
    readonly thrownBy: "service";
    readonly recovery: "Check the spelling, set geography_type to search a different level, or pass a full street address.";
}, {
    readonly reason: "ambiguous_name";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Name matched more than one geography.";
    readonly thrownBy: "service";
    readonly recovery: "Take fips_summary from the candidate you want in the error, or re-call with the candidate name — tract candidates need county_fips instead, since they share a name.";
}, {
    readonly reason: "county_scope_unsupported";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "county_fips was combined with a street address, or with a geography_type — set or auto-detected — that does not sit within a county.";
    readonly thrownBy: "service";
    readonly recovery: "Drop county_fips, or set geography_type to \"county\" or \"tract\" to use it.";
}, {
    readonly reason: "resolution_unavailable";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "Geography resolution endpoint was unreachable.";
    readonly retryable: true;
    readonly thrownBy: "service";
    readonly recovery: "Retry the request — the Census geography endpoints are free-tier with no auth requirements.";
}], undefined>;
//# sourceMappingURL=census-resolve-geography.tool.d.ts.map