/**
 * Cache hit/miss telemetry for SpecWeave prompt caching (0669 Wave 5 / AC-US3-06).
 *
 * Tracks per-skill cache hit rates. Data lives in memory (process lifetime).
 * Future: persist to .specweave/metrics/ or emit to analytics endpoint.
 */
interface SkillCacheMetrics {
    hits: number;
    misses: number;
    tokensFromCache: number;
}
/**
 * Record a cache hit for a skill invocation.
 * @param skillName  The skill's fully-qualified name (e.g. "sw/grill")
 * @param tokens     Number of tokens read from cache on this hit
 */
export declare function recordCacheHit(skillName: string, tokens?: number): void;
/**
 * Record a cache miss for a skill invocation (cold start or invalidated cache).
 */
export declare function recordCacheMiss(skillName: string): void;
/**
 * Get the cache hit rate for a skill as a number between 0 and 1.
 * Returns 0 if no data exists for the skill.
 */
export declare function getCacheHitRate(skillName: string): number;
/**
 * Get a snapshot of all metrics. Useful for `sw:analytics --cache-stats`.
 */
export declare function getAllMetrics(): Record<string, SkillCacheMetrics & {
    hitRate: number;
}>;
/**
 * Reset metrics for a skill. Primarily for testing.
 */
export declare function clearMetrics(skillName?: string): void;
export {};
//# sourceMappingURL=cache-metrics.d.ts.map