import { type MediaPurposePolicy, type SiteConfig, type SiteDefaults } from "@aotter/mantle-spec";
import type { SiteConfigRepository, UpdateEditableSiteConfigArgs } from "@aotter/mantle-runtime";
export type McpCatalogSiteConfig = Pick<SiteConfig, "origin" | "brand" | "description" | "icons" | "media">;
export interface McpCatalogKvBinding {
    readonly namespace: KVNamespace;
    /** Stable deployment-owned scope. Never derive this from a request. */
    readonly scope: string;
}
export interface McpCatalogSiteConfigReader {
    /** Resolve caller-independent catalog data after the transport auth gate. */
    loadCatalogSite(runtime: object): Promise<McpCatalogSiteConfig>;
}
/**
 * Cloudflare-owned write-through decorator for MCP catalog configuration.
 * The delegate remains canonical: ordinary repository reads always hit D1,
 * while only the caller-independent MCP projection is stored in KV.
 */
export declare class KvSiteConfigRepository implements SiteConfigRepository, McpCatalogSiteConfigReader {
    private readonly canonical;
    private readonly binding;
    readonly key: string;
    private readonly inFlight;
    private generation;
    private lastKnownSnapshot;
    private operationTail;
    private putFailureCount;
    private putBackoffUntil;
    private readonly diagnosticCounts;
    constructor(canonical: SiteConfigRepository, binding: McpCatalogKvBinding);
    load(): Promise<SiteConfig>;
    readLocales(): Promise<readonly string[]>;
    readMediaPurposes(): Promise<readonly MediaPurposePolicy[]>;
    seed(defaults: SiteDefaults | undefined): Promise<void>;
    updateEditable(values: UpdateEditableSiteConfigArgs): Promise<void>;
    loadCatalogSite(runtime: object): Promise<McpCatalogSiteConfig>;
    private readCatalogSite;
    private repairCatalogSite;
    private publishAfterCommittedWrite;
    private loadCanonicalSnapshot;
    private putSnapshot;
    private exclusive;
    private diagnostic;
}
//# sourceMappingURL=KvSiteConfigRepository.d.ts.map