import { MemoryEngine } from './memory';
export interface LifetimeTokenReport {
    totalSessions: number;
    totalEvents: number;
    totalFilesProcessed: number;
    totalTokensOptimized: number;
    totalTokensSaved: number;
    totalTokensForwarded: number;
    overallCompressionRatio: number;
    totalUsdSaved: number;
}
export interface SessionSummaryReport {
    sessionId: string;
    timestamp: number;
    events: number;
    tokensOptimized: number;
    tokensSaved: number;
    tokensForwarded: number;
    compressionRatio: number;
    fileCount: number;
    usdValueSaved: number;
}
export declare class TokenAnalyticsEngine {
    private db;
    constructor(memoryEngine: MemoryEngine);
    /**
     * Compute lifetime optimization aggregates.
     */
    getLifetimeReport(): LifetimeTokenReport;
    /**
     * Get rolled-up reporting for recent sessions.
     */
    getSessionHistory(limit?: number): SessionSummaryReport[];
    /**
     * Optional: Clear ledger
     */
    clearLedger(): void;
}
