Class ProgressTracker

src/tasks/progress.py:84–102

Mutable accumulator that watches assistant messages stream by. Token semantics (chapter §"Progress Tracking", line for line): * ``latest_input_tokens`` — kept as the latest value because the API returns input cumulatively per call. Includes ``cache_creation_input_tokens`` and ``

@dataclass
class ProgressTracker:
    """Mutable accumulator that watches assistant messages stream by.

    Token semantics (chapter §"Progress Tracking", line for line):
    * ``latest_input_tokens`` — kept as the latest value because the API
      returns input cumulatively per call. Includes ``cache_creation_input_tokens``
      and ``cache_read_input_tokens`` (TS does the same: Anthropic's
      response shape splits them out and the chapter sums them into the
      "latest" value).
    * ``cumulative_output_tokens`` — summed because output is per-turn.

    ``recent_activities`` is bounded at ``MAX_RECENT_ACTIVITIES``;
    ``update_progress_from_message`` drops the oldest entry on overflow.
    """

    tool_use_count: int = 0
    latest_input_tokens: int = 0
    cumulative_output_tokens: int = 0
    recent_activities: list[ToolActivity] = field(default_factory=list)


def total_tokens_from_tracker(tracker: ProgressTracker) -> int: