/**
 * @fileoverview Built-in known-server registry. Curated list of public BrAPI v2
 * endpoints that ship as default connection aliases — operators can call
 * `brapi_connect({ alias: 'bti-cassava' })` (or any other entry) without setting
 * `BRAPI_<ALIAS>_BASE_URL`. Each entry carries CC-BY attribution metadata so
 * the orientation envelope can surface license + citation alongside the data.
 *
 * Override behavior: env-set `BRAPI_<ALIAS>_BASE_URL` always wins over the
 * builtin URL — the builtin is a fallback, not a lock. Per-alias credentials
 * (`BRAPI_<ALIAS>_USERNAME` / `_PASSWORD` / etc.) layer on top of any selected
 * baseUrl, so write workflows still need a separate registration on each
 * upstream instance.
 *
 * Opt-out: comma-separated alias names in `BRAPI_BUILTIN_ALIASES_DISABLED`
 * remove specific builtins from resolution and discovery (matched
 * case-insensitively).
 *
 * @module config/builtin-aliases
 */
export interface BuiltinAlias {
    readonly alias: string;
    readonly baseUrl: string;
    readonly citation: string;
    readonly cropFocus: string;
    readonly homepage: string;
    readonly isDemo?: boolean;
    readonly license: 'CC-BY';
    readonly organizationName: string;
}
/**
 * Frozen registry of known public BrAPI v2 servers. Each entry was verified
 * against the live upstream surface — anonymous reads return real data and
 * the standard `/studies`, `/germplasm`, `/variables` endpoints respond with
 * non-trivial totals. Servers that flipped to an auth wall (musabase,
 * solgenomics) are intentionally absent.
 */
export declare const BUILTIN_ALIASES: ReadonlyArray<BuiltinAlias>;
/**
 * Resolve a builtin entry by alias. Case-insensitive lookup; respects the
 * `BRAPI_BUILTIN_ALIASES_DISABLED` opt-out list. Returns `undefined` when the
 * alias is unknown or disabled — callers fall through to the next baseUrl
 * source (default env, then a thrown ValidationError).
 */
export declare function findBuiltinAlias(alias: string, env?: NodeJS.ProcessEnv): BuiltinAlias | undefined;
/**
 * Active builtins — the registry minus any aliases listed in
 * `BRAPI_BUILTIN_ALIASES_DISABLED`. Used by alias discovery so the connect
 * tool description can advertise what's available out-of-the-box.
 */
export declare function listBuiltinAliases(env?: NodeJS.ProcessEnv): ReadonlyArray<BuiltinAlias>;
//# sourceMappingURL=builtin-aliases.d.ts.map