export type TelemetrySource = "direct-session" | "live-model-metadata" | "public-price" | "unknown";
export interface RawTelemetryInput {
    direct?: Partial<{
        inputTokens: number;
        outputTokens: number;
        cacheReadTokens: number;
        cacheWriteTokens: number;
        costUsd: number;
    }>;
    modelMetadata?: Partial<{
        inputTokens: number;
        outputTokens: number;
        cacheReadTokens: number;
        cacheWriteTokens: number;
    }>;
    publicPricing?: {
        url: string;
        fetchedAt: string;
        estimatedCostUsd: number;
    };
}
export interface KnownValue {
    value: number | null;
    known: boolean;
}
export interface PublicModelTokenRates {
    inputUsdPerMillion: number;
    outputUsdPerMillion: number;
    cacheReadUsdPerMillion?: number;
    cacheWriteUsdPerMillion?: number;
    reasoningUsdPerMillion?: number;
}
export interface PublicPricingSnapshot {
    source?: string;
    apiUrl?: string;
    url: string;
    retrievedAt: string;
    currency: "USD";
    completeness?: string;
    models: Record<string, PublicModelTokenRates>;
    unresolvedTieredModels?: string[];
}
export declare function normalizeTelemetry(input: RawTelemetryInput): {
    provenance: {
        source: TelemetrySource;
        url?: string;
        fetchedAt?: string;
    };
    tokens: {
        input: KnownValue;
        output: KnownValue;
        cacheRead: KnownValue;
        cacheWrite: KnownValue;
    };
    costUsd: KnownValue;
};
export declare function estimatePublicTokenCost(input: {
    modelId: string;
    usage: Partial<{
        inputTokens: number;
        outputTokens: number;
        cacheReadTokens: number;
        cacheWriteTokens: number;
        reasoningTokens: number;
    }>;
    snapshot: PublicPricingSnapshot;
}): KnownValue;