import { type SessionSearchOptions } from './search.js';
export declare const SESSION_TOKEN_FIELDS: readonly ['input_tokens', 'cached_input_tokens', 'output_tokens', 'reasoning_output_tokens', 'total_tokens'];
export type SessionTokenField = typeof SESSION_TOKEN_FIELDS[number];
export type SessionTokenUsage = Record<SessionTokenField, number | null>;
export interface SessionUsageOptions extends Pick<SessionSearchOptions, 'cwd' | 'codexHomeDir' | 'codexHomeDirs' | 'since' | 'project' | 'session' | 'now'> {
    limit?: number;
    sort?: 'recent' | 'tokens';
}
export interface SessionUsageSummary {
    known: number | null;
    known_sessions: number;
    unknown_sessions: number;
}
export interface SessionUsageRow {
    session_id: string;
    started_at: string | null;
    last_activity_at: string | null;
    usage_at: string | null;
    cwd_basename: string | null;
    cwd_hash: string | null;
    archived: boolean;
    transcript_copies: number;
    usage: SessionTokenUsage;
}
export interface SessionUsageReport {
    schema_version: 1;
    scope: 'session-cumulative';
    generated_at: string;
    matched_sessions: number;
    sessions_with_usage: number;
    truncated: boolean;
    totals: Record<SessionTokenField, SessionUsageSummary>;
    diagnostics: {
        scanned_files: number;
        skipped_files: number;
        malformed_records: number;
        invalid_usage_fields: number;
        duplicate_transcripts: number;
    };
    sessions: SessionUsageRow[];
}
export declare function summarizeSessionUsage(rows: SessionUsageRow[]): Record<SessionTokenField, SessionUsageSummary>;
export declare function buildSessionUsageReport(options?: SessionUsageOptions): Promise<SessionUsageReport>;
//# sourceMappingURL=usage.d.ts.map