headroom
Слой сжатия контекста для AI-агентов: сжимает выводы инструментов, логи, RAG-фрагменты, файлы и историю диалога.
Что это
Слой сжатия контекста для AI-агентов: сжимает выводы инструментов, логи, RAG-фрагменты, файлы и историю диалога.
Как подключить
Вставьте блок в конфиг клиента (Claude Desktop, Claude Code, Cursor, VS Code, Cline). Команда и package собраны из полей официального MCP Registry.
Что нового в версиях
Важные изменения: лицензирование, отказ от crewai, сжатие, метрики CO2, Unix-сокеты и исправления бэкендов.
- Ломает совместимостьЧтение HEADROOM_LICENSE и перевод отчётов об использовании в режим opt-in.
- Ломает совместимостьУдалён extra crewai для исключения chromadb из lock-файла.
- НовоеДобавлена диагностика сжатия сообщений и режим densify для live-agent.
- НовоеВ дашборд и API добавлена карточка CO2 Saved и унифицированы метрики экономии.
- НовоеПрокси теперь поддерживает Unix domain сокеты, заголовок x-headroom-keep-lasts и маршрутизацию Gemini через нативные трансформы.
- ИсправленоИсправлены ошибки в бэкендах: сохранение CCR, маппинг tool_choice, синхронизация токенов и обработка статусов 4xx.
Исправлена критическая ошибка в прокси, из-за которой запросы с большим контекстом бесконечно отклонялись.
- ИсправленоУстранена ошибка в прокси, из-за которой лимитер TPM навсегда блокировал запросы с большим контекстом.
Релиз v0.39.0: улучшена прозрачность сжатия, добавлено защита сообщений и поддержка контекста 1M в VS Code.
- НовоеСжатие CCR теперь описывает, какие данные были удалены, а не только объем экономии.
- НовоеДобавлен хук protect_messages для жесткого запрета сжатия отдельных сообщений.
- НовоеРасширена поддержка VS Code Claude: теперь доступен контекст объемом 1 млн токенов.
- НовоеУлучшена аналитика экономии: отслеживание стоимости кэша, новых запросов и общих расходов.
- ИсправленоИсправлена потеря изображений в запросах через LiteLLM и ошибки кэширования Google.
- ИсправленоУстранены ложные предупреждения сжатия и проблемы с блокировкой при загрузке бинарников.
Обновление v0.38.0: улучшена маршрутизация, сжатие и кэширование, добавлена поддержка OpenAI Responses и новые метрики в дашборде.
- НовоеBeacon schema v2: новые сигналы для маршрутизации и обучения, а также транспорт с gzip-сжатием.
- НовоеПрокси теперь принимает формат OpenAI Responses на этапе взаимодействия (turn).
- НовоеДашборд: новые карточки с экономией, отображение сбережений от маршрутизации и точная атрибуция затрат.
- НовоеМаршрутизатор: добавлено условие require_tools и улучшена обработка плотных машинных строк.
- ИсправленоИсправлено сжатие блоков cache_control, сохранение управляющих конструкций Bash и корректная обработка кэша.
Релиз v0.37.0: унификация сжатия, защита от SSRF, исправления маршрутизации и безопасности прокси.
- НовоеУнификация движка сжатия для прокси и сайдкар-режима, добавлен /v1/compress и ретрансляция /v1/usage.
- НовоеВнедрено саморегулируемое состояние сессии для реестра кэша сжатия.
- ИсправленоЗакрыта уязвимость SSRF в Vertex через валидацию региона и усилен контроль токенов в WebSocket.
- ИсправленоИсправлена маршрутизация Kimi Code, сохранено нативное распределение моделей Copilot Enterprise.
- ИсправленоУстранены ошибки сжатия, конфликты настроек и проблемы с очисткой кэша на Windows.
Исправлено определение авторизации ChatGPT и ложное срабатывание диагностики маршрутизации Claude.
- ИсправленоИсправлено определение авторизации ChatGPT через id_token claims, теперь корректно инициируется запрос openai_auth.
- ИсправленоИсправлена диагностика doctor: теперь корректно отображается маршрутизация Claude в рамках проекта вместо ложного отрицания.
Исправление безопасности, стабильности стриминга OpenAI и настройка бюджетов в Serena.
- ИсправленоУсилена безопасность: добавлена валидация upstreams, задаваемых пользователем, на всех путях разрешения.
- ИсправленоИсправлена работа стриминга OpenAI: устранено ошибочное дублирование указателей между ходами.
- ИсправленоПрокси теперь корректно сохраняет дополнительный инструмент carrier (additional_tools) в ответах.
- НовоеБюджет простоя предварительной индексации в Serena стал настраиваемым параметром.
- ИсправленоДля встроенных статических активов зафиксированы MIME-типы в панели управления.
Исправления в Copilot, Kompress и Proxy; обновление зависимостей ai, tiktoken-rs, tokenizers и TypeScript.
- ИсправленоCopilot: привязка токена minted к передаваемому ID интеграции.
- ИсправленоProxy: подсчёт выходных токенов по тексту потока, а не по размеру в сети.
- ИсправленоKompress: удалённый компрессор теперь принимает ccr_original.
- НовоеОбновление пакета ai с 6.x до 7.0.59 в SDK и документации.
- НовоеОбновление TypeScript до 7.0.2 в плагинах openclaw и opencode.
- НовоеОбновление tiktoken-rs до 0.12.0 и tokenizers до 0.23.1.
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.