export interface UsageSession {
    title: string;
    model: string;
    providerID: string;
    cost: number;
    tokensInput: number;
    tokensOutput: number;
    tokensReasoning: number;
    tokensCacheRead: number;
    tokensCacheWrite: number;
    timeCreated: number;
    timeUpdated: number;
    durationMin: number;
    attribution: 'user' | 'agent';
    teamshare: boolean;
}
export interface UsageReport {
    day: string;
    dbPath: string;
    provider: string;
    totalCost: number;
    sessionCount: number;
    userCost: number;
    agentCost: number;
    teamshareCost: number;
    tokens: {
        input: number;
        output: number;
        reasoning: number;
        cacheRead: number;
        cacheWrite: number;
    };
    sessions: UsageSession[];
}
export interface UsageOptions {
    day?: string;
    agent?: string;
    /** Force a specific provider instead of auto-detecting. */
    provider?: 'opencode' | 'codex';
}
/**
 * Read the usage report directly from the harness database.
 * Auto-detects the provider (opencode > codex) or uses the explicit option.
 * Throws if no provider database is found.
 */
export declare function readUsageReport(opts?: UsageOptions): UsageReport;