/**
 * Marketplace Local Cache
 *
 * Manages the ~/.aiwg/marketplace-cache/ directory that stores fetched plugins.
 *
 * Layout: ~/.aiwg/marketplace-cache/<source>/<packageId>/<version>/
 *
 * @implements #787
 */
import type { MarketplaceSourceId, PackageBundle, PackageMetadata } from './types.js';
/**
 * Resolve the cache root. Supports AIWG_CACHE_DIR override for testing.
 */
export declare function getCacheRoot(): string;
/**
 * Resolve the path for a specific package version
 */
export declare function getPackagePath(source: MarketplaceSourceId, packageId: string, version: string): string;
/**
 * Check whether a package version is cached
 */
export declare function isCached(source: MarketplaceSourceId, packageId: string, version: string): boolean;
/**
 * Write a package bundle to the cache
 */
export declare function cachePackage(bundle: PackageBundle): string;
/**
 * List all cached packages.
 */
export interface CachedPackageEntry {
    source: MarketplaceSourceId;
    packageId: string;
    version: string;
    cachedAt: Date;
    metadata: PackageMetadata;
}
export declare function listCachedPackages(): CachedPackageEntry[];
/**
 * Remove a specific cached package (all versions or a specific one)
 */
export declare function uncachePackage(source: MarketplaceSourceId, packageId: string, version?: string): boolean;
//# sourceMappingURL=cache.d.ts.map