Skip to content

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.

4.9 KB
Raw Blame
"""Org-scale sizing knobs: shared-process stores must be tunable and safe.

One Headroom process shared by many users (gateway sidecar/pool) stresses
stores that were sized for a single user's workload:

* the per-session compression-cache entry cap
  (``HEADROOM_COMPRESSION_CACHE_MAX_ENTRIES``),
* the process-wide frozen-verdicts store
  (``HEADROOM_FROZEN_VERDICTS_MAX``), and
* the session registry under churn (active sessions must survive a flood
  of transient ones — the LRU property at scale).

Registry TTL/LRU mechanics live in ``test_compression_cache_registry.py``.
"""

from __future__ import annotations

import json
import os
import subprocess
import sys
import textwrap

import pytest

pytest.importorskip("fastapi")


def _make_proxy():
    from headroom.proxy.server import ProxyConfig, create_app

    config = ProxyConfig(
        optimize=False,
        cache_enabled=False,
        rate_limit_enabled=False,
        cost_tracking_enabled=False,
        log_requests=False,
        ccr_inject_tool=False,
        ccr_handle_responses=False,
        ccr_context_tracking=False,
        image_optimize=False,
    )
    app = create_app(config)
    return app.state.proxy


@pytest.mark.parametrize("raw", ["nan", "inf", "-inf"])
def test_nonfinite_cache_ttl_still_reclaims_idle_sessions(raw, tmp_path) -> None:
    program = textwrap.dedent(
        """
        import json
        import time
        from headroom.proxy.server import ProxyConfig, create_app

        proxy = create_app(ProxyConfig(
            optimize=False, cache_enabled=False, rate_limit_enabled=False,
            cost_tracking_enabled=False, log_requests=False,
            ccr_inject_tool=False, ccr_handle_responses=False,
            ccr_context_tracking=False, image_optimize=False,
        )).state.proxy
        proxy._get_compression_cache("stale")
        proxy._get_compression_cache("fresh")
        now = time.time()
        proxy._compression_cache_last_seen["stale"] = now - 1_000_000
        proxy._compression_caches_last_cleanup = (
            now - proxy._COMPRESSION_CACHE_CLEANUP_INTERVAL_SECONDS - 1
        )
        proxy._get_compression_cache("trigger")
        print(json.dumps({
            "stale": "stale" in proxy._compression_caches,
            "fresh": "fresh" in proxy._compression_caches,
        }))
        """
    )
    result = subprocess.run(
        [sys.executable, "-c", program],
        env={
            **os.environ,
            "HEADROOM_COMPRESSION_CACHE_TTL_SECONDS": raw,
            "HEADROOM_WORKSPACE_DIR": str(tmp_path),
        },
        capture_output=True,
        text=True,
        check=True,
        timeout=120,
    )
    assert json.loads(result.stdout) == {"stale": False, "fresh": True}


# --------------------------------------------------------------------------- #
# Frozen-verdicts store: process-wide, so it must be sizeable per deployment.  #
# --------------------------------------------------------------------------- #


def test_frozen_verdicts_eviction_honors_configured_cap(monkeypatch) -> None:
    from headroom.transforms.content_router import ContentRouter, ContentRouterConfig

    monkeypatch.setenv("HEADROOM_FROZEN_VERDICTS_MAX", "256")
    router = ContentRouter(ContentRouterConfig())
    for key in range(300):
        router._record_frozen_verdict(key, True)
    assert len(router._frozen_verdicts) == 256
    # FIFO: the oldest keys were evicted, the newest survive.
    assert 0 not in router._frozen_verdicts
    assert 299 in router._frozen_verdicts


# --------------------------------------------------------------------------- #
# Session registry under org-scale churn: active sessions always survive a     #
# flood of transient ones (the property that keeps busts away at capacity).    #
# --------------------------------------------------------------------------- #


def test_active_sessions_survive_transient_flood(monkeypatch) -> None:
    import headroom.proxy.server as server_mod

    monkeypatch.setattr(server_mod, "MAX_COMPRESSION_CACHE_SESSIONS", 100)
    proxy = _make_proxy()

    active = [f"active-{i}" for i in range(40)]
    active_caches = {sid: proxy._get_compression_cache(sid) for sid in active}

    # 400 transient sessions arrive interleaved with active-session traffic —
    # 4x the cap, forcing repeated capacity evictions along the way.
    for i in range(400):
        proxy._get_compression_cache(f"transient-{i}")
        if i % 5 == 0:  # active sessions keep making requests
            for sid in active:
                proxy._get_compression_cache(sid)

    # Every active session survived with its instance (and therefore its
    # byte-replay state) intact; evictions only ever hit transient sessions.
    for sid in active:
        assert proxy._get_compression_cache(sid) is active_caches[sid], (
            f"active session {sid} lost its cache to transient churn"
        )
    assert len(proxy._compression_caches) <= 100 + len(active)