import { type CacheTargetStructure } from './cache-target-structure.js';
/**
 * Represents a target that has already been cached locally.
 *
 * This is the persisted view of a cached entry and should be safe
 * to serialize into the cache catalog.
 */
export interface CachedItemStructure {
    /**
     * The original cache target definition.
     */
    readonly target: CacheTargetStructure;
    /**
     * Absolute path to the cached file on disk.
     *
     * Examples:
     * - "/Users/me/.solo/cache/images/ghcr.io__repo__image__0.23.2.tar"
     * - "/Users/me/.solo/cache/charts/solo-deployment__0.62.0.tgz"
     */
    readonly localPath: string;
    /**
     * ISO-8601 timestamp recording when the item was cached.
     */
    readonly cachedAt: string;
}