/**
 * kosha-discovery — Model alias resolution system.
 *
 * Provides short, memorable names that resolve to canonical model IDs.
 * Built-in aliases are kept in sync with the latest model releases.
 * @module
 */
/**
 * Curated default aliases mapping short names to canonical model IDs.
 *
 * These are production-ready and cover the most commonly referenced
 * models across major providers. Updated September 2026.
 *
 * Convention: a bare family name (`opus`, `sonnet`, `gemini-pro`) always
 * tracks the newest generally-available model in that family; a suffixed
 * form (`opus-4.8`, `sonnet-4`) pins a generation and is kept for
 * backward compatibility when the bare alias moves on.
 */
export declare const DEFAULT_ALIASES: Readonly<Record<string, string>>;
/**
 * Resolves short alias names to canonical model IDs.
 *
 * Built-in aliases from {@link DEFAULT_ALIASES} are merged with optional
 * user-provided overrides, where user overrides take precedence.
 */
export declare class AliasResolver {
    /** Internal map holding the merged alias -> canonical ID mappings. */
    private aliases;
    /**
     * @param customAliases - Optional user overrides; these are merged on top
     *                        of the built-in {@link DEFAULT_ALIASES} map.
     */
    constructor(customAliases?: Record<string, string>);
    /**
     * Resolve an alias to its canonical model ID.
     * Returns the input unchanged if no matching alias is found.
     */
    resolve(nameOrAlias: string): string;
    /**
     * Find all aliases that point to the given canonical model ID.
     */
    reverseAliases(modelId: string): string[];
    /**
     * Add or overwrite an alias mapping.
     */
    addAlias(alias: string, modelId: string): void;
    /**
     * Remove an alias mapping.
     */
    removeAlias(alias: string): void;
    /**
     * Return a snapshot of the full alias map (defaults + custom).
     */
    all(): Record<string, string>;
}
//# sourceMappingURL=aliases.d.ts.map