export type StaticUiCacheStats = {
    hits: number;
    misses: number;
    entries: number;
    notModified: number;
};
export declare function getStaticUiCacheStats(): StaticUiCacheStats;
export declare function clearStaticUiCacheForTests(): void;
export declare function resolveStaticUiRootForTests(): string;
/** Warm commonly requested UI files into memory at gateway startup. */
export declare function prewarmStaticUiCache(relativePaths?: readonly string[]): {
    loaded: number;
    missing: number;
};
/** Serve a static file from the gateway console build output directory. */
export declare function serveStaticFile(relativePath: string, request?: Request): Response | null;
/** Exposed for tests: verify cache invalidation when source file changes. */
export declare function invalidateStaticUiCacheEntry(relativePath: string): void;
