import type { StableId } from "../config/types.js";
import { NineRouterError } from "./errors.js";
import type { CatalogCacheLoadResult, CatalogCacheV1, CatalogErrorSummary } from "./types.js";
export declare class CatalogCacheStore {
    readonly root: string;
    constructor(root: string);
    load(): Promise<CatalogCacheLoadResult>;
    save(cache: CatalogCacheV1): Promise<void>;
    recordFailure(current: CatalogCacheV1 | undefined, gatewayId: StableId, error: NineRouterError, at: string): Promise<CatalogCacheV1>;
}
export declare function toSummary(error: NineRouterError, at: string): CatalogErrorSummary;
export declare function validateCache(value: unknown): CatalogCacheV1;