/**
 * resolve_entity: map a football entity to its IDs at every provider, through
 * the Reep register (https://reep.football).
 *
 * Three sources, tried in this order:
 *   1. A local copy of the free register (REEP_DUCKDB_PATH). No key, whole
 *      register, queried on this machine. The tool checks the file's release
 *      stamp against the published latest.json and tells the agent when a
 *      newer release exists.
 *   2. The Reep API (REEP_API_KEY). Keys are issued by hand on request; there
 *      is no self-service sign-up.
 *   3. Neither: no network call. The answer says how to set up either source
 *      and gives the DuckDB query that answers the question from the download.
 */
export declare const REEP_CONTACT = "getintouch+nutmeg@withqwerty.com";
export declare const REEP_DOWNLOAD_URL = "https://reep.football/downloads/duckdb";
export declare const REEP_LATEST_URL = "https://data.reep.football/releases/latest.json";
export declare const ENTITY_TYPES: readonly ["player", "coach", "referee", "team", "competition", "season", "stage", "match"];
export type EntityType = (typeof ENTITY_TYPES)[number];
export type ResolveEntityArgs = {
    name?: string;
    provider?: string;
    id?: string;
    namespace?: string;
    reep_id?: string;
    type?: EntityType;
};
type ToolResponse = {
    isError?: boolean;
    content: Array<{
        type: "text";
        text: string;
    }>;
};
type Row = Record<string, unknown>;
/** A read-only view of a local register file. Injectable so tests need no 700 MB file. */
export interface LocalRegister {
    stamp: string | null;
    query(sql: string, params: Record<string, string>): Promise<Row[]>;
}
export type ResolveEntityOptions = {
    env?: Record<string, string | undefined>;
    fetchImpl?: typeof fetch;
    openLocal?: (path: string) => Promise<LocalRegister>;
};
export declare function resolveEntity(args: ResolveEntityArgs, options?: ResolveEntityOptions): Promise<ToolResponse>;
export {};