ClaudeWrapper.History.SessionSummary (ClaudeWrapper v0.10.0)

Summary of one session .jsonl file.

See ClaudeWrapper.History for how these are produced.

Two fields deserve a note:

total_tokens counts throughput -- fresh input, output, and cache creation -- and excludes cache-read tokens. Cache reads re-count context already tallied when it was first cached, so including them inflates a long session 10-100x and makes the figure track conversation length rather than work done. The raw per-turn usage is still available via ClaudeWrapper.History.read_session/2.
total_cost_usd is almost always nil: Claude Code does not persist per-message cost in its transcripts, only token usage.

Summary

Types

t()

Types

t()

@type t() :: %ClaudeWrapper.History.SessionSummary{
  first_timestamp: String.t() | nil,
  first_user_preview: String.t() | nil,
  last_timestamp: String.t() | nil,
  message_count: non_neg_integer(),
  project_slug: String.t(),
  session_id: String.t(),
  size_bytes: non_neg_integer(),
  title: String.t() | nil,
  total_cost_usd: float() | nil,
  total_tokens: non_neg_integer() | nil
}