Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Python agentaianthropicclaude-codecompressioncontext-engineeringcontext-windowcursorfastapilangchainllmmcpopenaiprompt-engineeringproxypythonragtoken-optimizationtokenstypescript
"""Version-gate tests for thinking_compactor.bills_prior_thinking.
The gate decides whether a model re-bills prior-turn thinking (so compaction
pays) or strips it server-side (so compacting would turn free thinking into
billed text). It parses the version out of the model id, and must not mistake
the ``YYYYMMDD`` release-date suffix for the minor version.
"""
from __future__ import annotations
import pytest
from headroom.transforms.thinking_compactor import bills_prior_thinking
@pytest.mark.parametrize(
("model", "expected"),
[
# Major-only ids with a date suffix: the date must NOT be read as the
# minor version. Claude 4.0 strips prior thinking server-side -> False.
("claude-sonnet-4-20250514", False),
("claude-opus-4-20250514", False),
("claude-opus-4", False),
# Explicit minor below the 4.6 threshold -> strips -> False.
("claude-sonnet-4-5-20250929", False),
("claude-haiku-4-5-20251001", False),
("claude-opus-4-1-20250805", False),
("claude-opus-4-5-20250101", False),
# 4.6+ and the 5 family re-bill prior thinking -> True.
("claude-opus-4-6", True),
("claude-sonnet-4-6", True),
("claude-opus-4-8", True),
("claude-sonnet-5", True),
("claude-sonnet-5-20260101", True),
("claude-haiku-5-5", True),
# Legacy 3.x naming (with date) stays below threshold.
("claude-3-5-sonnet-20241022", False),
("claude-3-opus-20240229", False),
# No version at all -> conservative False.
("some-unversioned-model", False),
],
)
def test_bills_prior_thinking_version_gate(model: str, expected: bool) -> None:
assert bills_prior_thinking(model) is expected
def test_date_suffix_is_not_read_as_minor_version() -> None:
"""Regression for the specific inversion: a major-only id whose 8-digit date
suffix was parsed as the minor version, flipping a strip-model to 'bills'."""
# Same major (4), only the date suffix differs from an explicit-minor id.
assert bills_prior_thinking("claude-sonnet-4-20250514") is False
# Sanity: the real 4.6 id still bills.
assert bills_prior_thinking("claude-sonnet-4-6-20260101") is True
def test_compact_thinking_to_text_leaves_null_thinking_block_alone() -> None:
"""``"thinking": null`` must not raise (docstring: "Never raises")."""
from headroom.transforms.thinking_compactor import compact_thinking_to_text
class _K:
def compress(self, text, **kwargs):
return type("R", (), {"compressed": text[:10]})()
null_block = {"type": "thinking", "thinking": None, "signature": "s"}
msgs = [
{"role": "user", "content": "q"},
{"role": "assistant", "content": [null_block, {"type": "text", "text": "a"}]},
{"role": "user", "content": "q2"},
{"role": "assistant", "content": [{"type": "text", "text": "b"}]},
]
out, stats = compact_thinking_to_text(msgs, kompress=_K())
assert out[1]["content"][0] == null_block
assert stats["blocks"] == 0