Module session_budget 

Session-level cumulative context budget (#1307).

Tracks total fresh tokens delivered across the session and applies progressive compression tiers as usage grows:

Tier	Cumulative usage	Default strategy
Green	0–50%	No intervention
Yellow	50–75%	Prefer compressed modes (signatures)
Orange	75–90%	Force map/signatures on all reads
Red	90–100%	Reference-only, expand on demand

Enums

PressureTier

Session budget pressure tiers.

Functions

cumulative_tokens

Current cumulative fresh token count.

current_tier

Current pressure tier based on cumulative usage vs session limit.

record_delivery

Record n fresh tokens delivered in this session.

reset

Reset session budget (for testing or session restart).