export declare function getCacheDir(): string;
export declare function getDownloadCacheDir(): string;
export declare function ensureCacheDir(sub?: string): Promise<string>;
export declare function cacheKeyFromIntegrity(integrity: string): string;
/**
 * Return path to cached extracted skill dir for this integrity, or null.
 */
export declare function getCachedSkill(integrity: string): Promise<string | null>;
/**
 * Store a materialized skill dir into content-addressable cache.
 * Returns the cache path. Idempotent.
 */
export declare function putCachedSkill(integrity: string, srcDir: string): Promise<string>;
/**
 * Cache a raw download (e.g. tarball) by a content or source key (sha1/shasum or hash of url).
 * key should be stable short hex.
 */
export declare function getCachedDownload(key: string): Promise<string | null>;
export declare function putCachedDownload(key: string, srcFile: string): Promise<string>;
/**
 * Optional cleanup (for doctor --gc or manual).
 */
export declare function clearCache(olderThanMs?: number): Promise<number>;
/**
 * Fast-path stat signature check against a previous signature.
 * Returns true if mtime/size/count match (no content drift likely).
 * Caller can still do full integrity if needed for security.
 */
export declare function matchesStatSignature(dir: string, prev: {
    mtime: number;
    size: number;
    count: number;
}): Promise<boolean>;
//# sourceMappingURL=cache.d.ts.map