/**
 * Minimal UHT (Universal Hex Taxonomy) API client.
 *
 * Talks to the UHT Substrate factory API for entity classification and comparison.
 * Token resolution: UHT_TOKEN env → UHT_API_KEY env → ~/.config/uht-substrate/config.json
 */
/** Decode an 8-char hex code into trait names by reading the 32-bit field. */
export declare function decodeHexTraits(hexCode: string): string[];
export interface UhtClassification {
    entity: string;
    hex_code: string;
    traits: Array<{
        name: string;
        justification: string;
    }>;
}
export interface UhtEntityRecord {
    uuid: string;
    name: string;
    hex_code: string;
    description: string | null;
    source: string;
}
export interface UhtComparison {
    candidate: string;
    hex_code: string;
    jaccard_similarity: number;
    hamming_distance: number;
    shared_traits: Array<{
        name: string;
    }>;
    traits_entity_only: Array<{
        name: string;
    }>;
    traits_candidate_only: Array<{
        name: string;
    }>;
}
export interface UhtBatchResult {
    entity: string;
    hex_code: string;
    comparisons: UhtComparison[];
    best_match: string;
    best_jaccard: number;
}
export declare class UhtClient {
    private baseUrl;
    private token;
    constructor();
    get isConfigured(): boolean;
    private request;
    classify(entity: string): Promise<UhtClassification>;
    batchCompare(entity: string, candidates: string[]): Promise<UhtBatchResult>;
    /** Look up an entity by name in a Substrate namespace. Returns null if not found.
     *  Only returns exact name matches (case-insensitive) — no fuzzy fallback. */
    lookupEntity(name: string, namespace: string): Promise<UhtEntityRecord | null>;
}