namespace ClaudeDo.Worker.Usage.Interfaces;

public interface ITranscriptUsageReader
{
    /// <summary>Cumulative raw token totals for one session's transcript file
    /// (located by <c>{sessionId}.jsonl</c> under the projects root), or null when
    /// no matching transcript file can be found or read.</summary>
    Task<SessionUsageTotals?> ReadSessionTotalsAsync(string sessionId, CancellationToken ct = default);
}
