freegate 0.6.18 → 0.6.21

package/.env.example

@@ -1,7 +1,19 @@
-# Copy to .env and fill in your keys. Only keys marked free:true are required.
+# Copy to .env and fill in your keys. Only free:true providers are required.
+# Бесплатные провайдеры free-model (несколько ключей = больше пул + надёжность):
 PROVIDER_GROQ_APIKEY=
 PROVIDER_MISTRAL_APIKEY=
 PROVIDER_GEMINI_APIKEY=
 PROVIDER_NIM_APIKEY=
 PROVIDER_ZAI_APIKEY=
 PROVIDER_OPENROUTER_APIKEY=
+PROVIDER_CEREBRAS_APIKEY=
+PROVIDER_DEEPSEEK_APIKEY=
+PROVIDER_HF_APIKEY=
+# Розширений пул (бесплатные free-тиры, добавить по желанию):
+PROVIDER_SAMBANOVA_APIKEY=
+PROVIDER_SILICONFLOW_APIKEY=
+PROVIDER_DEEPINFRA_APIKEY=
+PROVIDER_HYPERBOLIC_APIKEY=
+PROVIDER_COHERE_APIKEY=
+PROVIDER_LLM7_APIKEY=
+PROVIDER_NARA_APIKEY=

package/README.md

@@ -14,7 +14,7 @@
 ## Why pay for LLMs when free ones exist?
 
 Your AI agent, bot, or script talks to a **single OpenAI-compatible endpoint**.
-Behind it, Freegate automatically routes requests across **34 free models**
+Behind it, Freegate automatically routes requests across **50+ free models**
 from Groq, Mistral, Gemini, NVIDIA NIM, OpenRouter, ZAI, Cerebras, DeepSeek
 and local models. If one provider goes down, gets overloaded, or burns its
 daily limit — the request **instantly falls through to the next one**. You
@@ -29,27 +29,31 @@ is only yours — nobody else can connect to it, and you can't to theirs. Provid
 keys live in your local `.env`, history in local files. **No third-party server
 sees your keys or conversations.**
 
-![Freegate Dashboard](assets/dashboard.gif)
+![Freegate Dashboard](assets/dashboard-en.gif)
 
 ## Features
 
 | | |
 |---|---|
-| 🔀 **Auto-failover** | 34 providers in one chain. Provider down? The next one answers. |
+| 🔀 **Auto-failover** | 50+ providers in one chain. Provider down? The next one answers. |
 | 🤖 **Self-managing models** | Auto-discovers new free models, tests them, adds working ones, disables dead ones — built-in scheduler, always-fresh model base. |
 | 🗂️ **Model database** | Structured passport per model (score, latency, context window, history) + sorting: best models get routing priority. |
 | 🏷️ **Model categories** | reasoning / coding / general / vision / local — the right model for the right job. |
 | 🖼️ **Two-stage vision** | Screenshot → vision model reads it → coding model answers the fix. |
 | 💰 **Free** | Free models only. The dashboard shows each provider's remaining limit. |
 | ⚡ **Smart routing** | Picks the fastest, most stable provider for every request. |
+| 🎯 **Routing strategies** | `weighted` (default), `weighted-roundrobin`, `weighted-least` — burn limits more evenly. |
 | 🛡️ **Reliability** | Circuit breaker, request queue, auto-disable of dead providers, watchdog. |
 | 📊 **Dashboard** | Status, speed, limits, history, tokens, RPM chart, savings ($). RU/EN. **4 themes** (PolyCopy/Warm/Cosmic/Paper) — switcher in the header. |
 | 💾 **Disk cache** | Repeat prompts don't consume limits at all. |
 | 🎓 **Methodologist** | Agent answers like an engineer: plan→test→code (coding), stepwise (reasoning), like a frontend designer (design). Prompts customizable in `config.json`. |
 | 🌐 **Web search** | For question/answer it fetches current facts from the web (DuckDuckGo, keyless) — answers accurately instead of hallucinating. |
+| 🧪 **Self-check** | Optional: complex answers are vetted by a second model (vetting) and flagged on error. Enable: `config.vetting.enabled`. |
+| ✂️ **Prompt compression** | Optional: strips politeness/fillers (Caveman-style) to save tokens. `config.compress.enabled`. |
+| 📈 **Sparkline 24h** | Hourly success in the dashboard + history filters (search by model/provider, OK/Errors). |
 | 🔌 **Compatible** | Any OpenAI client: opencode, Cursor, your scripts. |
 
-![Freegate Models base](assets/dashboard-models.png)
+![Freegate Models base](assets/dashboard-models-en.png)
 
 ## Quick start — 30 seconds
 
@@ -220,6 +224,7 @@ put it in `config.json` → `providers` (same format as `providers.json`).
 ```bash
 npx freegate init              # create config
 npx freegate init -i           # interactive wizard (keys, password)
+npx freegate doctor            # diagnostics: keys, models, "what to check"
 npx freegate start             # start proxy
 npx freegate status            # diagnostics: providers, limits, errors
 npx freegate test              # verify it works

package/README.ru.md

@@ -13,9 +13,10 @@
 ## Зачем платить за LLM, когда есть бесплатные?
 
 Твой AI-агент, бот или скрипт использует **один OpenAI-совместимый endpoint**.
-За ним Freegate автоматически распределяет запросы между **34 бесплатными
+За ним Freegate автоматически распределяет запросы между **50+ бесплатными
 моделями** — Groq, Mistral, Gemini, NVIDIA NIM, OpenRouter, ZAI, Cerebras,
-DeepSeek и локальные модели. Если один провайдер упал, перегружен или сжёг
+DeepSeek, SambaNova, SiliconFlow, DeepInfra, Hyperbolic, Cohere, LLM7, Nara
+и локальные модели. Если один провайдер упал, перегружен или сжёг
 дневной лимит — запрос **мгновенно уходит на следующий**. Ты никогда не
 видишь «rate limit», и никогда не платишь.
 
@@ -34,18 +35,22 @@ Freegate крутится **на твоей машине** (`http://localhost:40
 
 | | |
 |---|---|
-| 🔀 **Автопереключение** | 34 провайдера в одной цепочке. Провайдер упал? Следующий уже отвечает. |
+| 🔀 **Автопереключение** | 50+ провайдеров в одной цепочке. Провайдер упал? Следующий уже отвечает. |
 | 🤖 **Автоуправление моделями** | Сам находит новые бесплатные модели, тестирует, добавляет рабочие, отключает мёртвые — встроенный планировщик, всегда актуальная база. |
 | 🗂️ **База моделей** | Структурированный паспорт каждой модели (скор, латентность, окно, история) + сортировка: лучшие модели получают приоритет в роутинге. |
 | 🏷️ **Категории моделей** | reasoning / coding / general / vision / local — правильная модель для каждой задачи. |
 | 🖼️ **Vision-конвейер** | Скриншот → vision-модель читает → кодинг-модель отвечает на вопрос. |
 | 💰 **Бесплатно** | Только free-модели. Дашборд показывает остаток лимита каждого провайдера. |
 | ⚡ **Умный выбор** | Прокси сам находит самый быстрый и стабильный провайдер для каждого запроса. |
+| 🎯 **Стратегии роутинга** | `weighted` (по умолчанию), `weighted-roundrobin`, `weighted-least` — ровнее расходуют лимиты. |
 | 🛡️ **Надёжность** | Circuit breaker, очередь запросов, автоотключение мёртвых провайдеров, watchdog. |
 | 📊 **Дашборд** | Статус, скорость, лимиты, история, токены, RPM-график, экономия ($). RU/EN. **4 темы** (PolyCopy/Тёплый/Космос/Бумага) — переключатель в шапке. |
 | 💾 **Кэш на диске** | Повторные промпты не тратят лимиты вообще. |
 | 🎓 **Методолог** | Агент отвечает как инженер: план→тест→код (coding), пошагово (reasoning), **как фронтенд-дизайнер** (design). Промпты настраиваются в `config.json`. |
 | 🌐 **Веб-поиск** | Для вопросов-поиска Freegate находит актуальные факты в интернете (DuckDuckGo, без ключа) — отвечает по существу, а не галлюцинирует. |
+| 🧪 **Самопроверка** | Опционально: сложные ответы проверяет второй моделью (vetting) и помечает ошибки. Вкл: `config.vetting.enabled`. |
+| ✂️ **Сжатие промптов** | Опционально: убирает вежливость/заполнители (Caveman-стиль), экономя токены. `config.compress.enabled`. |
+| 📈 **Sparkline 24ч** | Успех по часам в дашборде + фильтры истории (поиск по модели/провайдеру, OK/Ошибки). |
 | 🔌 **Совместимость** | Любой OpenAI-клиент: opencode, Cursor, ChatGPT-аналоги, твои скрипты. |
 
 ![База моделей Freegate](assets/dashboard-models.png)
@@ -241,6 +246,7 @@ PROVIDER_ZAI_APIKEY=...        # ZAI
 ```bash
 npx freegate init              # создать конфиг
 npx freegate init -i           # интерактивный мастер (ключи, пароль)
+npx freegate doctor            # диагностика: ключи, модели, «что проверить»
 npx freegate start             # запустить прокси
 npx freegate status            # диагностика: провайдеры, лимиты, ошибки
 npx freegate test              # проверить, что работает

package/bin/freegate.js

@@ -125,6 +125,78 @@ if (cmd === 'init') {
     console.log('\nГотово! Заполни .env ключами, затем: npx freegate start');
     console.log('Совет: npx freegate init -i — интерактивный мастер с вопросами.');
   }
+} else if (cmd === 'doctor') {
+  const doctor = require(path.join(ROOT, 'lib', 'doctor'));
+  const setup = require(path.join(ROOT, 'lib', 'setup'));
+
+  console.log('\n🩺 Freegate doctor');
+  console.log('────────────────────');
+
+  const snap = doctor.snapshot();
+
+  // 1. Ключи — что задано.
+  const keyGroups = Object.values(snap.keyState);
+  const withKey = keyGroups.filter((k) => k.hasKey);
+  const noKey = keyGroups.filter((k) => !k.hasKey);
+  console.log(`Провайдеров в каталоге: ${snap.catalogCount}, групп провайдеров: ${keyGroups.length}`);
+  console.log(`Ключей задано: ${withKey.length}/${keyGroups.length}`);
+  if (withKey.length) {
+    console.log('\n✅ Ключи установлены:');
+    for (const k of withKey) {
+      const masked = k.key.slice(0, 4) + '…' + (k.key.length > 8 ? k.key.slice(-4) : '');
+      console.log(`   ${k.name.padEnd(18)} (${k.count.toString().padStart(2)} мод.)  ${masked}`);
+    }
+  }
+  if (noKey.length) {
+    console.log('\n⬜ Ключи не заданы (модели недоступны):');
+    for (const k of noKey) console.log(`   ${k.name.padEnd(18)} (${k.count.toString().padStart(2)} мод.)`);
+  }
+
+  // 2. Модели — живое.
+  const models = Object.keys(snap.models).length;
+  console.log(`\nМоделей в базе: ${models}`);
+  console.log(`   активных: ${snap.byStatus.active} · отключено: ${snap.byStatus.disabled} · неизвестно: ${snap.byStatus.unknown}`);
+  if (snap.byStatus.active === 0 && models === 0) {
+    console.log('   ⚠️ База пуста — запусти сервер, чтобы автопоиск нашёл модели.');
+  }
+
+  // 3. Рекомендации «что включить».
+  const rec = doctor.recommend(snap.models);
+  if (rec.disabledByUser.length || rec.paid.length || rec.local.length || rec.dead.length) {
+    console.log('\n🔮 Что проверить:');
+    if (rec.disabledByUser.length) console.log('   ✅ Выключенные free (можно вернуть): ' + rec.disabledByUser.join(', '));
+    if (rec.paid.length) console.log('   🟠 Платные/малый лимит (держать выключенными): ' + rec.paid.join(', '));
+    if (rec.local.length) console.log('   🏠 Локальные (слабый Mac): ' + rec.local.join(', '));
+    if (rec.dead.length) console.log('   ⚠️ Мёртвые/непроверенные (чистить): ' + rec.dead.join(', '));
+  }
+
+  // 4. Быстрый старт.
+  const easy = doctor.easyStartKey();
+  const easyHas = snap.keyState[easy.envVar] && snap.keyState[easy.envVar].hasKey;
+  if (!easyHas) {
+    console.log(`\n💡 Быстрый старт: добавь ключ ${easy.name} — сразу ${easy.count}+ бесплатных моделей.`);
+    console.log('   `npx freegate init -i` или дашборд → Настройки.');
+  } else {
+    console.log(`\n💡 Всё настроено. Запуск: npx freegate start · дашборд: http://localhost:4000`);
+  }
+
+  // Опциональная валидация ключей (медленная — по флагу).
+  if (process.argv.includes('--validate')) {
+    console.log('\n⏳ Проверяю ключи (может занять ~10с)...');
+    let n = 0;
+    (async () => {
+      for (const k of keyGroups) {
+        if (!k.hasKey) continue;
+        const r = await setup.validateKey(k.envVar, k.key);
+        n++;
+        if (r.valid) console.log(`   ✅ ${k.name}`);
+        else console.log(`   ❌ ${k.name}: ${r.error || 'неверный'}`);
+      }
+      process.exit(0);
+    })();
+  } else if (cmd === 'doctor') {
+    // (validate-ветка уже вышла через process.exit выше — здесь просто тишина)
+  }
 } else if (cmd === 'start') {
   // Spawn from the user's cwd (not package dir) so server.js picks up their
   // config.json / .env created by `init`.
@@ -200,6 +272,41 @@ WantedBy=default.target
   console.log('  ?theme=cosmic   — открыть дашборд в теме вручную');
   console.log('  Кнопка «Тема» в шапке дашборда — переключать по кругу');
   console.log('  Памятка: `--theme` не нужен, тема хранится в localStorage браузера.');
+} else if (cmd === 'connect') {
+  const onboarding = require(path.join(ROOT, 'lib', 'onboarding'));
+  const setup = require(path.join(ROOT, 'lib', 'setup'));
+  const { keys } = setup.readKeys();
+  let AUTH = keys.AUTH || process.env.AUTH || '';
+  if (!AUTH) {
+    try { AUTH = (JSON.parse(fs.readFileSync(path.join(process.cwd(), 'config.json'), 'utf8')).auth) || ''; } catch {}
+  }
+  const port = process.env.PORT || '4000';
+  const baseUrl = `http://localhost:${port}`;
+  const apiKey = AUTH || 'твой_пароль';
+
+  console.log('\n🔌 Подключить Freegate к клиенту');
+  console.log('────────────────────────────────');
+  console.log(`Base URL: ${baseUrl}/v1`);
+
+  // Определяем, какой профиль выбрать: смотрим, какие модели уже активны.
+  const doctor = require(path.join(ROOT, 'lib', 'doctor'));
+  const snap = doctor.snapshot();
+  const rec = doctor.recommend(snap.models);
+  const activeCount = snap.byStatus.active || 0;
+
+  console.log('\nВыбери профиль (подсказка по активным моделям):');
+  for (const p of onboarding.profiles()) {
+    console.log(`   ${p.id.padEnd(11)} ${p.name} — ${p.hint}`);
+  }
+  console.log('\nПрофиль не влияет на прокси — это подсказка, какую модель выбрать в клиенте.');
+
+  console.log('\n─── Cursor ───');
+  console.log(onboarding.snippetCursor(baseUrl, apiKey));
+  console.log('\n─── opencode ───');
+  console.log(onboarding.snippetOpencode(baseUrl, apiKey));
+  console.log('\n─── Cline (VS Code) ───');
+  console.log(onboarding.snippetCline(baseUrl, apiKey));
+  console.log('\nСовет: модели с категорией coding → coder, design → designer и т.д.');
 } else if (cmd === 'test') {
   const http = require('http');
   const base = `http://127.0.0.1:${process.env.PORT || 4000}`;

package/config.example.json

@@ -22,6 +22,19 @@
     "timeout": 8000,
     "queryMinChars": 6
   },
+  "vetting": {
+    "enabled": false,
+    "minAnswerLen": 120,
+    "maxChecksPerMin": 4,
+    "complexityOnly": true
+  },
+  "routing": {
+    "strategy": "weighted"
+  },
+  "compress": {
+    "enabled": false,
+    "minLen": 60
+  },
   "providers": {
     "or-nemotron-550b": {
       "endpoint": "https://openrouter.ai/api/v1/chat/completions",
@@ -31,6 +44,26 @@
       "keyHint": "openrouter.ai → Keys",
       "envVar": "PROVIDER_OPENROUTER_APIKEY",
       "free": true
+    },
+    "sambanova-gpt-oss-120b": {
+      "endpoint": "https://api.sambanova.ai/v1/chat/completions",
+      "model": "gpt-oss-120b",
+      "priority": 12,
+      "dailyLimit": 100000,
+      "keyHint": "cloud.sambanova.ai → API Keys",
+      "envVar": "PROVIDER_SAMBANOVA_APIKEY",
+      "free": true,
+      "category": "general"
+    },
+    "siliconflow-deepseek-r1": {
+      "endpoint": "https://api.siliconflow.com/v1/chat/completions",
+      "model": "deepseek-ai/DeepSeek-R1",
+      "priority": 12,
+      "dailyLimit": 100000,
+      "keyHint": "cloud.siliconflow.com → API Keys",
+      "envVar": "PROVIDER_SILICONFLOW_APIKEY",
+      "free": true,
+      "category": "reasoning"
     }
   }
 }

package/lib/cache.js

@@ -45,7 +45,7 @@ class LRUCache {
         const now = Date.now();
         for (const e of data.entries) {
 if (now - e.created > this.ttl) continue;
-      this.cache.set(e.key, { value: e.value, created: e.created, uses: e.uses || 0, model: e.model, temperature: e.temperature, grams: e.grams || null });
+      this.cache.set(e.key, { value: e.value, created: e.created, uses: e.uses || 0, model: e.model, temperature: e.temperature, grams: e.grams || null, providerKey: e.providerKey || null });
         }
         // Restore hit/miss counters so hitRate survives restarts
         if (typeof data.hits === 'number') this.hits = data.hits;
@@ -63,7 +63,7 @@ if (now - e.created > this.ttl) continue;
         try {
           const size = Buffer.byteLength(JSON.stringify(entry.value));
           if (size > MAX_ENTRY_BYTES) continue;
-          entries.push({ key, value: entry.value, created: entry.created, uses: entry.uses || 0, model: entry.model, temperature: entry.temperature, grams: entry.grams || null });
+          entries.push({ key, value: entry.value, created: entry.created, uses: entry.uses || 0, model: entry.model, temperature: entry.temperature, grams: entry.grams || null, providerKey: entry.providerKey || null });
         } catch {}
       }
       // Keep only the most recent 300 on disk to bound file size
@@ -141,7 +141,7 @@ if (now - e.created > this.ttl) continue;
     return { value: entry.value, similarity: Math.round(bestSim * 1000) / 1000 };
   }
 
-  set(model, messages, temperature, value) {
+  set(model, messages, temperature, value, providerKey) {
     const key = this._key(model, messages, temperature);
 
     // Delete if exists (to update order)
@@ -167,10 +167,24 @@ if (now - e.created > this.ttl) continue;
       grams = new Set(trigrams(norm));
     }
 
-    this.cache.set(key, { value, created: Date.now(), uses: 0, model, temperature, grams: grams ? [...grams] : null });
+    this.cache.set(key, { value, created: Date.now(), uses: 0, model, temperature, grams: grams ? [...grams] : null, providerKey: providerKey || null });
+  }
+
+  // Вернуть провайдер-источник кэш-записи (для диагностики: кэш-хит может
+  // скрывать реальный источник ответа). null → записи нет/без провайдера.
+  getProvider(model, messages, temperature) {
+    const key = this._key(model, messages, temperature);
+    const entry = this.cache.get(key);
+    return entry ? (entry.providerKey || null) : null;
   }
 
   stats() {
+    // Распределение кэш-записей по провайдерам-источникам (для дашборда).
+    const byProvider = {};
+    for (const entry of this.cache.values()) {
+      const pk = entry.providerKey || 'unknown';
+      byProvider[pk] = (byProvider[pk] || 0) + 1;
+    }
     return {
       hits: this.hits,
       misses: this.misses,
@@ -180,6 +194,7 @@ if (now - e.created > this.ttl) continue;
       hitRate: this.hits + this.misses > 0
         ? Math.round((this.hits / (this.hits + this.misses)) * 100)
         : 0,
+      byProvider,
     };
   }
 

package/lib/compress.js

@@ -0,0 +1,85 @@
+// lib/compress.js — лёгкое сжатие промпта (по мотивам OmniRoute Caveman).
+// Удаляет вежливость/хеджирование/заполнители из ПОСЛЕДНЕГО user-сообщения,
+// экономя токены free-лимитов. Только для plain-text сообщений; код/контент-
+// массивы/инструменты не трогаем. Опционально: config.compress.enabled.
+const logger = require('./logger');
+
+const COMPRESS_DEFAULTS = { enabled: false, minLen: 60 };
+
+// Пары «регэксп → замена». Намеренно бережно: не ломаем смысл, только пустые
+// фразы. Артикли EN убираем только когда после них буква (не ломать код/URL).
+const RULES = [
+  // English pleasantries / polite framing / hedging / fillers
+  [/^(?:sure|certainly|of course|happy to|absolutely)\s*[,!.]?\s+/i, ''],
+  [/^(?:thanks|thank you|thanks in advance|i really appreciate)\s*[,!.]?\s+/i, ''],
+  [/^(?:please|kindly|could you please|would you please|can you please)\s+/i, ''],
+  [/^(?:i want you to|i need you to|i'd like you to)\s+/i, ''],
+  [/^(?:i am trying to|i am working on|i have been)\s+/i, ''],
+  [/\b(?:it seems like|it appears that|i think that|i believe that|probably|possibly|maybe it)\s+/gi, ''],
+  [/\b(?:basically|essentially|actually|literally|simply|currently|just)\s+/gi, ''],
+  [/\b(?:i want to|i need to|i'd like to|i'm looking for)\s+/gi, ''],
+  [/^(?:hi there|hello|hey|good morning|good afternoon)\s*[,!.]?\s+/i, ''],
+  [/\b(?:a bit|a little|somewhat|kind of|sort of)\s+/gi, ''],
+  // English hedgy / filler requests
+  [/\b(?:i was wondering|would it be possible|if possible|when you get a chance|at your convenience)\s*,?\s+/gi, ''],
+  // English articles (only plain prose, not URLs/code)
+  [/\b(?:an|a|the)\s+(?=[a-z])/gi, ''],
+  // Russian fillers and polite framing
+  [/^(?:пожалуйста|будьте добры|если можно|не могли бы вы)\s*[,!.]?\s+/i, ''],
+  [/^(?:привет|здравствуйте|добрый день|добрый вечер)\s*[,!.]?\s+/i, ''],
+  [/\b(?:просто|кстати|вообще|скажем|по сути|по-хорошему|честно говоря)\s+/gi, ''],
+  [/\b(?:как бы|вроде бы|в принципе|наверное|возможно|пожалуй)\s+/gi, ''],
+  [/^(?:я хочу|мне нужно|я бы хотел|я пытаюсь|я работаю)\s+/i, ''],
+  [/\b(?:спасибо|заранее спасибо|очень благодарен)\s*[,!.]?\s+/gi, ''],
+];
+
+// Не сжимаем, если сообщение похоже на код.
+function looksLikeCode(text) {
+  return /[{}\[\]]|=>|\bdef\b|\bfunction\b|\bconst\b|\bimport\b|\bfrom\b\s+["']|<\/?[a-z][^>]*>/i.test(text);
+}
+
+// Убрать «шапку» polite-prose из текста.
+function compressText(text) {
+  if (!text || typeof text !== 'string') return text;
+  let out = text;
+  for (const [re, rep] of RULES) {
+    out = out.replace(re, rep);
+  }
+  // подчистить возможные двойные пробелы после сокращений
+  out = out.replace(/[ \t]{2,}/g, ' ').trim();
+  return out;
+}
+
+function shouldCompress(cfg, text) {
+  if (!cfg || cfg.enabled === false) return false;
+  if (!text || typeof text !== 'string') return false;
+  if (text.trim().length < (cfg.minLen || COMPRESS_DEFAULTS.minLen)) return false;
+  if (looksLikeCode(text)) return false;
+  return true;
+}
+
+// Сжать последний user-message (только plain string content).
+function compressMessages(messages, options = {}) {
+  const cfg = Object.assign({}, COMPRESS_DEFAULTS, options);
+  if (!messages || !Array.isArray(messages) || messages.length === 0) return messages;
+  if (cfg.enabled === false) return messages;
+
+  let mutated = false;
+  const copy = messages.slice();
+  for (let i = copy.length - 1; i >= 0; i--) {
+    const m = copy[i];
+    if (!m || m.role !== 'user') continue;
+    if (typeof m.content !== 'string') continue; // не трогаем массивы/инструменты
+    if (!shouldCompress(cfg, m.content)) continue;
+    const compressed = compressText(m.content);
+    if (compressed !== m.content && compressed.length > 0) {
+      copy[i] = { ...m, content: compressed };
+      mutated = true;
+      break; // только последнее user-сообщение
+    }
+  }
+  if (mutated) logger.info('prompt compressed', { freed: 0 });
+  return mutated ? copy : messages;
+}
+
+module.exports = { compressText, compressMessages, shouldCompress, looksLikeCode, RULES, COMPRESS_DEFAULTS };