import type { AnalyticsEntry } from '../analytics/analytics-types.js';
import { type SavingsClassification } from '../analytics/savings-classification.js';
import { type ProviderUsageSummary } from '../analytics/native-provider-usage.js';
interface EffectivePricing {
    available: boolean;
    effectiveInputUsdPerMillion: number | null;
    source: 'versioned-provider-model-catalog';
    verifiedAt: string;
    explanation: string;
}
export interface DashboardActionAnalytics {
    name: string;
    totalOperations: number;
    totalOriginalTokens: number;
    totalOptimizedTokens: number;
    totalTokensSaved: number;
    grossTokensSaved: number;
    expansionTokensReturned: number;
    unverifiedReportedTokensSaved: number;
    savingsPercentage: number | null;
    contextUsd: number | null;
    savedUsd: number | null;
    firstSeen: string;
    lastSeen: string;
    measuredSavingsOperations: number;
    pricedReturnedContextOperations: number;
    pricedSavingsOperations: number;
    verifiedExpansionOperations: number;
    unmeasuredSavingsOperations: number;
    observedReturnedContextOperations: number;
    unverifiedReportedOperations: number;
}
export interface DashboardAnalyticsReport {
    schemaVersion: 3;
    available: boolean;
    source: string;
    pricing: EffectivePricing;
    summary: {
        totalOperations: number;
        totalOriginalTokens: number;
        totalOptimizedTokens: number;
        measuredOptimizedTokens: number;
        totalTokensSaved: number;
        grossTokensSaved: number;
        expansionTokensReturned: number;
        unverifiedReportedTokensSaved: number;
        savingsPercentage: number | null;
        contextUsd: number | null;
        savedUsd: number | null;
        firstSeen: string | null;
        lastSeen: string | null;
        measuredSavingsOperations: number;
        pricedReturnedContextOperations: number;
        pricedSavingsOperations: number;
        verifiedExpansionOperations: number;
        unmeasuredSavingsOperations: number;
        actualReturnedContextOperations: number;
        legacyReportedContextOperations: number;
        observedReturnedContextOperations: number;
        unverifiedReportedOperations: number;
    };
    byAction: DashboardActionAnalytics[];
    byClient: Array<{
        name: string;
        attribution: 'recorded' | 'historical-unattributed';
        totalOperations: number;
        observedReturnedContextOperations: number;
        verifiedSavingsOperations: number;
        verifiedExpansionOperations: number;
        unverifiedReportedOperations: number;
        totalOptimizedTokens: number | null;
        totalTokensSaved: number | null;
        unverifiedReportedTokensSaved: number;
        contextUsd: number | null;
        savedUsd: number | null;
        pricedReturnedContextOperations: number;
        pricedSavingsOperations: number;
    }>;
    recent: Array<{
        name: string;
        originalTokens: number;
        optimizedTokens: number;
        tokensSaved: number;
        reportedTokensSaved: number;
        contextUsd: number | null;
        savedUsd: number | null;
        timestamp: string;
        savingsMeasured: boolean;
        classification: SavingsClassification;
        client: string | null;
        model: string | null;
    }>;
    measurement: {
        definition: string;
        tokenCountMethod: string;
        legacyPolicy: string;
        priceBasis: string;
    };
    providerUsage: ProviderUsageSummary;
}
/**
 * Summarize only provenance-qualified savings. Historical tool-reported rows
 * stay visible as an audit population, but never enter the verified headline.
 */
export declare function summarizeDashboardAnalytics(input: AnalyticsEntry[], options?: {
    limit?: number;
    providerUsage?: ProviderUsageSummary;
}): DashboardAnalyticsReport;
export declare function readDashboardAnalytics(limit?: number): Promise<DashboardAnalyticsReport>;
export declare function readDashboardProviderUsage(limit?: number): Promise<ProviderUsageSummary>;
export {};
//# sourceMappingURL=dashboard-analytics.d.ts.map