This folder demonstrates context compaction patterns introduced by ADR-0019.
basics.py— builds a local message list and applies each built-in strategy one at a time.advanced.py— composes multiple strategies withTokenBudgetComposedStrategy.agent_client_overrides.py— shows client defaults, agent-level overrides, and per-run compaction overrides.custom.py— defines a custom strategy implementing theCompactionStrategyprotocol.tiktoken_tokenizer.py— shows aTokenizerProtocolimplementation backed bytiktoken.compaction_provider.py— usesCompactionProviderwith an agent andInMemoryHistoryProvider.
Run samples with:
uv run samples/02-agents/compaction/basics.py
uv run samples/02-agents/compaction/advanced.py
uv run samples/02-agents/compaction/agent_client_overrides.py
uv run samples/02-agents/compaction/custom.py
uv run samples/02-agents/compaction/tiktoken_tokenizer.py
uv run samples/02-agents/compaction/compaction_provider.py # requires OPENAI_API_KEY