/**
 * Lightweight per-skill stats stored in `~/.qlogicagent/skill-stats.json`.
 * Covers learned, promoted, and registry-installed skills.
 */
export interface SkillUsageStats {
    /** Total number of times this skill has been invoked/applied. */
    invokeCount: number;
    /** Number of turns where the skill was active and contributed. */
    activeCount: number;
    /** Number of times the skill received positive feedback. */
    positiveCount: number;
    /** Number of times the skill received negative feedback. */
    negativeCount: number;
    /** ISO 8601 timestamp of last use. */
    lastUsedAt?: string;
    /** Derived success rate = (invokeCount - negativeCount) / invokeCount */
    successRate?: number;
}
export interface SkillStatsFile {
    [skillName: string]: SkillUsageStats;
}
/**
 * Record a skill invocation. Fire-and-forget — never throws.
 * @param agentHome - path to `~/.qlogicagent/`
 * @param skillName - the skill that was invoked
 * @param success - whether the invocation completed without error
 */
export declare function trackSkillInvocation(agentHome: string, skillName: string, success: boolean): void;
/**
 * Read stats for a skill. Returns undefined if no stats recorded.
 */
export declare function getSkillStats(agentHome: string, skillName: string): SkillUsageStats | undefined;
/**
 * Get all skill stats. Useful for UI display.
 */
export declare function getAllSkillStats(agentHome: string): SkillStatsFile;
/** Reset cache (for testing). */
export declare function resetStatsCache(): void;
