freegate 0.6.18 → 0.6.20

package/lib/doctor.js

@@ -0,0 +1,106 @@
+// lib/doctor.js — автономная диагностика Freegate.
+// Читает .env (ключи), валидирует их, смотрит модели из models-db.json и собирает
+// «что включить». Не требует запущенного сервера. Используется `freegate doctor`.
+const fs = require('fs');
+const path = require('path');
+const setup = require('./setup');
+const { ModelDB } = require('./modeldb');
+
+const ROOT = path.join(__dirname, '..');
+
+// Провайдер, с которого удобно начинать (быстрый старт).
+function easyStartKey() {
+  return { envVar: 'PROVIDER_OPENROUTER_APIKEY', name: 'OpenRouter', count: 15 };
+}
+
+// Сгруппировать провайдеры каталога по envVar (как в init).
+function groupByEnv(catalog) {
+  const groups = new Map();
+  for (const [name, p] of Object.entries(catalog || {})) {
+    if (!p.envVar) continue;
+    if (!groups.has(p.envVar)) groups.set(p.envVar, []);
+    groups.get(p.envVar).push(name);
+  }
+  return groups;
+}
+
+function loadCatalog() {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(ROOT, 'providers.json'), 'utf8'));
+  } catch { return {}; }
+}
+
+function loadModelDb() {
+  try {
+    const p = path.join(ROOT, 'models-db.json');
+    if (!fs.existsSync(p)) return {};
+    return JSON.parse(fs.readFileSync(p, 'utf8'));
+  } catch { return {}; }
+}
+
+function statusOf(status) {
+  return status === 'active' ? 'up' : status === 'user-disabled' ? 'disabled' : status || 'unknown';
+}
+
+// Собрать снимок состояния: ключи, каталог, модели.
+function snapshot({ catalog = loadCatalog(), modelDb = loadModelDb(), keysSource = null } = {}) {
+  const { keys, envPath } = keysSource || setup.readKeys();
+  const groups = groupByEnv(catalog);
+  const models = (modelDb.models && typeof modelDb.models === 'object') ? modelDb.models : {};
+
+  const keyState = {};
+  for (const [envVar, providers] of groups) {
+    const meta = setup.KEY_GROUPS[envVar];
+    keyState[envVar] = {
+      envVar,
+      name: meta ? (meta.name) : envVar,
+      url: meta ? meta.url : '',
+      key: (keys[envVar] || ''), // маскируем при выводе
+      providers,
+      count: providers.length,
+      hasKey: !!(keys[envVar] || '').trim(),
+    };
+  }
+
+  // Модели по статусу + источнику.
+  const byStatus = { active: 0, disabled: 0, unknown: 0 };
+  const bySource = {};
+  const dead = [];   // disabled/мёртвые
+  const working = []; // active
+  for (const [key, m] of Object.entries(models)) {
+    const st = statusOf(m.status); // up/disabled/unknown
+    const bucket = st === 'up' ? 'active' : st === 'disabled' ? 'disabled' : 'unknown';
+    byStatus[bucket] = (byStatus[bucket] || 0) + 1;
+    const src = m.source || 'unknown';
+    bySource[src] = (bySource[src] || 0) + 1;
+    if (st === 'up') working.push(key);
+    else if (st === 'disabled' || st === 'unknown') dead.push(key);
+  }
+
+  return { envPath, keyState, models, byStatus, bySource, working, dead, catalogCount: Object.keys(catalog).length };
+}
+
+// «Что включить»: по аналогии с дашбордом и модель-менеджером.
+// - disabledByUser: user-disabled, но free/локальные — «можно вернуть» (пользователь сам выключил).
+// - deadOrUntested: dead/untested — проверь/удали.
+// - paid: платные-подозрительные (маленький лимит): их держать выключенными.
+function recommend(models) {
+  const all = Object.entries(models).map(([key, m]) => ({ key, model: m.model || key, source: m.source || '', status: m.status || 'unknown' }));
+  const disabledByUser = [];
+  const dead = [];
+  const paid = [];
+  const local = [];
+  for (const m of all) {
+    const isLocal = /local|ollama|lmstudio/i.test(m.source);
+    const isPaid = /deepseek|glm-5|ox-alpha|minimax-m2/i.test(m.model);
+    if (m.status === 'active') continue; // уже работает
+    if (m.status === 'dead' || m.status === 'untested') { dead.push(m.key); continue; }
+    if (isLocal) { local.push(m.key); continue; }
+    if (isPaid) { paid.push(m.key); continue; }
+    if (m.status === 'user-disabled') { disabledByUser.push(m.key); continue; }
+    // иначе — unknown, не трогаем
+  }
+  return { disabledByUser, dead, paid, local };
+}
+
+module.exports = { snapshot, recommend, easyStartKey, groupByEnv };

package/lib/health.js

@@ -17,6 +17,51 @@ let recent = [];
 let rpm = [];
 let currentRpmMinute = 0;
 
+// Почасовое кольцо успеха (24 бина по UTC-часу). Для sparkline в дашборде.
+// Каждый бин: { hour: 'YYYY-MM-DDTHH', ok, total }. Пустые часы (ещё не наступили) — total:0.
+const HOURLY_MAX = 24;
+let hourly = [];
+let hourlyDay = ''; // текущий день контекста (dayKey), чтобы не путать часы между днями
+
+function dayKey() {
+  return new Date().toISOString().slice(0, 10);
+}
+
+function hourKey() {
+  return new Date().toISOString().slice(0, 13); // 'YYYY-MM-DDTHH'
+}
+
+function ensureHourly() {
+  const dk = dayKey();
+  if (hourlyDay !== dk || hourly.length === 0) {
+    hourlyDay = dk;
+    hourly = [];
+    // Заполняем прошедшие часы этого UTC-дня нулями + текущий.
+    const nowHour = new Date().getUTCHours();
+    for (let h = 0; h <= nowHour; h++) {
+      hourly.push({ hour: dk + 'T' + String(h).padStart(2, '0'), ok: 0, total: 0 });
+    }
+  }
+}
+
+function recordHourly(success) {
+  ensureHourly();
+  const hk = hourKey();
+  const last = hourly[hourly.length - 1];
+  if (last && last.hour !== hk) {
+    // Новый час — добавляем бин, держим максимум HOURLY_MAX.
+    hourly.push({ hour: hk, ok: 0, total: 0 });
+    if (hourly.length > HOURLY_MAX) hourly.shift();
+  }
+  const bin = hourly[hourly.length - 1];
+  if (bin) { bin.total++; if (success) bin.ok++; }
+}
+
+function getHourly() {
+  ensureHourly();
+  return hourly;
+}
+
 function loadState() {
   try {
     const data = JSON.parse(fs.readFileSync(STATE_PATH, 'utf8'));
@@ -129,6 +174,7 @@ function classifyErrorMs(statusCode, opts) {
 
 function recordRequest(providerKey, success, error = null) {
   recordRpm();
+  recordHourly(success);
   stats.totalRequests++;
   const today = new Date().toISOString().slice(0, 10);
   // Error counter is all-time by default; reset it once per UTC day (like reliability).
@@ -233,6 +279,7 @@ function warmBanditPriors(enabledKeys, bucketKeys) {
 
 // Auto-save every 30 seconds
 const _saveTimer = setInterval(saveState, 30000);
+if (_saveTimer.unref) _saveTimer.unref();
 
 function _stopTimers() { clearInterval(_saveTimer); }
 
@@ -242,6 +289,7 @@ module.exports = {
   getHealth, getStats, getCircuitBreakers,
   recordRecent, recordRpm, getRecent, getRpm,
   getDailyUsage, getReliability,
+  getHourly,
   recordSelection, getLastSelection,
   getBandit, recordBandit, warmBanditPriors,
   getContextStats: () => contextStats,

package/lib/modelscan.js

@@ -9,7 +9,7 @@
 // (только :free), groq, cerebras, gemini (free tier), nim (малый лимит, но
 // стабильно бесплатный), huggingface. Каталог расширяется вручную через
 // config.json/providers.json.
-const SOURCES = ['openrouter', 'huggingface', 'groq', 'gemini', 'cerebras', 'nim'];
+const SOURCES = ['openrouter', 'huggingface', 'groq', 'gemini', 'cerebras', 'nim', 'sambanova', 'siliconflow', 'deepinfra', 'hyperbolic', 'cohere'];
 
 // Endpoints списков моделей и chat-completions по источникам.
 const SOURCE_META = {
@@ -21,6 +21,11 @@ const SOURCE_META = {
   cerebras: { list: 'https://api.cerebras.ai/v1/models', chat: 'https://api.cerebras.ai/v1/chat/completions', envVar: 'PROVIDER_CEREBRAS_APIKEY', dailyLimit: 1000 },
   deepseek: { list: 'https://api.deepseek.com/models', chat: 'https://api.deepseek.com/chat/completions', envVar: 'PROVIDER_DEEPSEEK_APIKEY', dailyLimit: 1000 },
   nim: { list: 'https://integrate.api.nvidia.com/v1/models', chat: 'https://integrate.api.nvidia.com/v1/chat/completions', envVar: 'PROVIDER_NIM_APIKEY', dailyLimit: 40 },
+  sambanova: { list: 'https://api.sambanova.ai/v1/models', chat: 'https://api.sambanova.ai/v1/chat/completions', envVar: 'PROVIDER_SAMBANOVA_APIKEY', dailyLimit: 100000 },
+  siliconflow: { list: 'https://api.siliconflow.com/v1/models', chat: 'https://api.siliconflow.com/v1/chat/completions', envVar: 'PROVIDER_SILICONFLOW_APIKEY', dailyLimit: 100000 },
+  deepinfra: { list: 'https://api.deepinfra.com/v1/openai/models', chat: 'https://api.deepinfra.com/v1/openai/chat/completions', envVar: 'PROVIDER_DEEPINFRA_APIKEY', dailyLimit: 100000 },
+  hyperbolic: { list: 'https://api.hyperbolic.xyz/v1/models', chat: 'https://api.hyperbolic.xyz/v1/chat/completions', envVar: 'PROVIDER_HYPERBOLIC_APIKEY', dailyLimit: 100000 },
+  cohere: { list: 'https://api.cohere.com/compatibility/v1/models', chat: 'https://api.cohere.com/compatibility/v1/chat/completions', envVar: 'PROVIDER_COHERE_APIKEY', dailyLimit: 100000 },
 };
 
 // Мусор: эмбеддинги, реранки, аудио/речь/музыка, guardrail, картинки/видео,
@@ -101,7 +106,7 @@ const ADAPTERS = {
 };
 
 // Нативные OpenAI-совместимые списки: один паттерн на все источники.
-for (const name of ['groq', 'mistral', 'gemini', 'cerebras', 'deepseek', 'nim']) {
+for (const name of ['groq', 'mistral', 'gemini', 'cerebras', 'deepseek', 'nim', 'sambanova', 'siliconflow', 'deepinfra', 'hyperbolic', 'cohere']) {
   ADAPTERS[name] = async (ctx) => {
     const meta = SOURCE_META[name];
     const key = ctx.keys[name] || process.env[meta.envVar] || '';

package/lib/onboarding.js

@@ -0,0 +1,79 @@
+// lib/onboarding.js — готовые сниппеты подключения и профили моделей.
+// Чистые функции: не трогают диск, возвращают текст конфига. Для doctor/init.
+function snippetCursor(baseUrl, apiKey) {
+  return [
+    '// Cursor → Settings → Models',
+    '// Включи провайдер «OpenAI-compatible» и впиши:',
+    'Model:        openai/gpt-oss-120b   (или любая из каталога)',
+    'Base URL:     ' + baseUrl + '/v1',
+    'API Key:      ' + apiKey,
+    'Add model:    столько бесплатных моделей, сколько захочешь.',
+    '',
+    'Совет: открыть дашборд → ' + baseUrl + ' (пароль = API Key).',
+  ].join('\n');
+}
+
+function snippetOpencode(baseUrl, apiKey) {
+  return [
+    '// opencode — добавь провайдер в opencode.json',
+    '{',
+    '  "$schema": "https://opencode.ai/config.json",',
+    '  "provider": {',
+    '    "freegate": {',
+    '      "npm": "@ai-sdk/openai-compatible",',
+    '      "name": "Freegate",',
+    '      "options": {',
+    '        "baseURL": "' + baseUrl + '/v1",',
+    '        "apiKey": "' + apiKey + '"',
+    '      }',
+    '    }',
+    '  },',
+    '  "model": "freegate/openai/gpt-oss-120b"',
+    '}',
+    '',
+    'Затем: npx opencode (выбери модель freegate).',
+  ].join('\n');
+}
+
+function snippetCline(baseUrl, apiKey) {
+  return [
+    '// Cline (VS Code) → Settings → API Provider: OpenAI Compatible',
+    'Base URL: ' + baseUrl + '/v1',
+    'API Key: ' + apiKey,
+    'Model: openai/gpt-oss-120b',
+    '',
+    'Убедись, что в Cline включён "OpenAI Compatible" провайдер.',
+  ].join('\n');
+}
+
+// Профили: пресеты под разные роли (каких моделей больше в роутинге).
+function profiles() {
+  return [
+    {
+      id: 'chat',
+      name: 'Чат-ассистент',
+      hint: 'Общие вопросы, переписка. Категория chat.',
+      prefer: ['general', 'chat'],
+    },
+    {
+      id: 'coder',
+      name: 'Кодер',
+      hint: 'Код, рефакторинг, тесты. Категория coding.',
+      prefer: ['coding', 'reasoning'],
+    },
+    {
+      id: 'designer',
+      name: 'Дизайнер',
+      hint: 'UI/UX, фронтенд. Категория design.',
+      prefer: ['coding', 'design'],
+    },
+    {
+      id: 'researcher',
+      name: 'Исследователь',
+      hint: 'Поиск фактов, веб-поиск. Категория search.',
+      prefer: ['search', 'reasoning'],
+    },
+  ];
+}
+
+module.exports = { snippetCursor, snippetOpencode, snippetCline, profiles };

package/lib/setup.js

@@ -193,6 +193,135 @@ const KEY_GROUPS = {
       'Paste it into the field below',
     ],
   },
+  PROVIDER_SAMBANOVA_APIKEY: {
+    name: 'SambaNova',
+    name_en: 'SambaNova',
+    url: 'https://cloud.sambanova.ai/',
+    description: 'MiniMax-M2.7, DeepSeek-V3.2, gpt-oss-120b. Очень быстрый инференс, бесплатно.',
+    description_en: 'MiniMax-M2.7, DeepSeek-V3.2, gpt-oss-120b. Very fast inference, free.',
+    steps: [
+      'Зайди на cloud.sambanova.ai и зарегистрируйся',
+      'Перейди в Settings → API Keys',
+      'Создай ключ и скопируй',
+      'Вставь в поле ниже',
+    ],
+    steps_en: [
+      'Go to cloud.sambanova.ai and register',
+      'Go to Settings → API Keys',
+      'Create a key and copy it',
+      'Paste it into the field below',
+    ],
+  },
+  PROVIDER_SILICONFLOW_APIKEY: {
+    name: 'SiliconFlow',
+    name_en: 'SiliconFlow',
+    url: 'https://cloud.siliconflow.com/account/ak',
+    description: 'DeepSeek-R1, Qwen3-Coder, Kimi-K2.5, GLM-4.7. Крупный бесплатный каталог.',
+    description_en: 'DeepSeek-R1, Qwen3-Coder, Kimi-K2.5, GLM-4.7. Large free catalog.',
+    steps: [
+      'Зайди на cloud.siliconflow.com и зарегистрируйся',
+      'Перейди в API Keys',
+      'Создай ключ (sk-...)',
+      'Вставь в поле ниже',
+    ],
+    steps_en: [
+      'Go to cloud.siliconflow.com and register',
+      'Go to API Keys',
+      'Create a key (sk-...)',
+      'Paste it into the field below',
+    ],
+  },
+  PROVIDER_DEEPINFRA_APIKEY: {
+    name: 'DeepInfra',
+    name_en: 'DeepInfra',
+    url: 'https://deepinfra.com/dash/api_keys',
+    description: 'gpt-oss-120b/20b, Nemotron-Super-120B, Llama-4. Бесплатный инференс.',
+    description_en: 'gpt-oss-120b/20b, Nemotron-Super-120B, Llama-4. Free inference.',
+    steps: [
+      'Зайди на deepinfra.com и зарегистрируйся',
+      'Перейди в Dashboard → API Keys',
+      'Создай ключ и скопируй',
+      'Вставь в поле ниже',
+    ],
+    steps_en: [
+      'Go to deepinfra.com and register',
+      'Go to Dashboard → API Keys',
+      'Create a key and copy it',
+      'Paste it into the field below',
+    ],
+  },
+  PROVIDER_HYPERBOLIC_APIKEY: {
+    name: 'Hyperbolic',
+    name_en: 'Hyperbolic',
+    url: 'https://app.hyperbolic.xyz/',
+    description: 'DeepSeek-V3, Qwen-Coder, Llama-3.3-70B. Бесплатный старт с кредитом.',
+    description_en: 'DeepSeek-V3, Qwen-Coder, Llama-3.3-70B. Free start with credit.',
+    steps: [
+      'Зайди на app.hyperbolic.xyz и зарегистрируйся',
+      'Перейди в Settings → API Keys',
+      'Создай ключ и скопируй',
+      'Вставь в поле ниже',
+    ],
+    steps_en: [
+      'Go to app.hyperbolic.xyz and register',
+      'Go to Settings → API Keys',
+      'Create a key and copy it',
+      'Paste it into the field below',
+    ],
+  },
+  PROVIDER_COHERE_APIKEY: {
+    name: 'Cohere',
+    name_en: 'Cohere',
+    url: 'https://dashboard.cohere.com/',
+    description: 'Command A, Command R+. Бесплатный Trial-ключ.',
+    description_en: 'Command A, Command R+. Free trial key.',
+    steps: [
+      'Зайди на dashboard.cohere.com и зарегистрируйся',
+      'Перейди в API Keys',
+      'Создай Trial-ключ',
+      'Вставь в поле ниже',
+    ],
+    steps_en: [
+      'Go to dashboard.cohere.com and register',
+      'Go to API Keys',
+      'Create a trial key',
+      'Paste it into the field below',
+    ],
+  },
+  PROVIDER_LLM7_APIKEY: {
+    name: 'LLM7',
+    name_en: 'LLM7',
+    url: 'https://llm7.io/',
+    description: 'gpt-4o-mini, DeepSeek-R1, Qwen2.5-Coder. Бесплатный ключ при регистрации.',
+    description_en: 'gpt-4o-mini, DeepSeek-R1, Qwen2.5-Coder. Free key on signup.',
+    steps: [
+      'Зайди на llm7.io и зарегистрируйся',
+      'Получи бесплатный API-ключ',
+      'Вставь в поле ниже',
+    ],
+    steps_en: [
+      'Go to llm7.io and register',
+      'Get the free API key',
+      'Paste it into the field below',
+    ],
+  },
+  PROVIDER_NARA_APIKEY: {
+    name: 'Nara (bynara)',
+    name_en: 'Nara (bynara)',
+    url: 'https://nara.ai/',
+    description: 'Mistral Large/Medium, Tencent Hy3. Бесплатный ключ через их Telegram-канал.',
+    description_en: 'Mistral Large/Medium, Tencent Hy3. Free key via their Telegram channel.',
+    steps: [
+      'Зайди на nara.ai / вступи в их Telegram-канал',
+      'Получи бесплатный ключ',
+      'Вставь в поле ниже',
+    ],
+    steps_en: [
+      'Go to nara.ai / join their Telegram channel',
+      'Get the free key',
+      'Paste it into the field below',
+    ],
+  },
 };
 
 // --- .env file path resolution (mirrors lib/providers.js logic) ---
@@ -282,6 +411,13 @@ async function validateKey(envVar, apiKey) {
     PROVIDER_CEREBRAS_APIKEY: 'https://api.cerebras.ai/v1/models',
     PROVIDER_DEEPSEEK_APIKEY: 'https://api.deepseek.com/models',
     PROVIDER_HF_APIKEY: 'https://router.huggingface.co/v1/models',
+    PROVIDER_SAMBANOVA_APIKEY: 'https://api.sambanova.ai/v1/models',
+    PROVIDER_SILICONFLOW_APIKEY: 'https://api.siliconflow.com/v1/models',
+    PROVIDER_DEEPINFRA_APIKEY: 'https://api.deepinfra.com/v1/openai/models',
+    PROVIDER_HYPERBOLIC_APIKEY: 'https://api.hyperbolic.xyz/v1/models',
+    PROVIDER_COHERE_APIKEY: 'https://api.cohere.com/compatibility/v1/models',
+    PROVIDER_LLM7_APIKEY: 'https://api.llm7.io/v1/models',
+    PROVIDER_NARA_APIKEY: 'https://router.bynara.id/v1/models',
   };
 
   const url = testEndpoints[envVar];

package/lib/strategy.js

@@ -0,0 +1,57 @@
+// lib/strategy.js — дополнительные стратегии роутинга (по мотивам OmniRoute).
+// Базовый выбор в Freegate — weighted (скор/латентность + категория + лимиты).
+// Здесь — опциональные модификаторы, которые НЕ заменяют основной скоринг, а
+// подмешивают к нему равномерность использования (round-robin / least-used),
+// чтобы не «прилипать» к одному провайдеру и ровнее расходовать free-лимиты.
+//
+// Управление: config.routing.strategy = 'weighted' | 'weighted-roundrobin' | 'weighted-least'.
+// Всегда остаётся fallback на weighted (стратегия лишь меняет вес, не исключает).
+
+const STRATEGIES = ['weighted', 'weighted-roundrobin', 'weighted-least'];
+
+const ROUND_ROBIN_BOOST = 1.6;   // во сколько раз поднимаем «следующего по кругу»
+const LEAST_USED_BOOST = 1.5;    // поднимаем провайдеров с наименьшим использованием
+
+// Кольцевой счётчик round-robin по совокупности провайдеров.
+let rrCursor = 0;
+
+function normalizeStrategy(value) {
+  const s = String(value || 'weighted').toLowerCase();
+  return STRATEGIES.includes(s) ? s : 'weighted';
+}
+
+// Вернуть функцию-модификатор веса для конкретного провайдера.
+// ctx: { key, provider, usedTodayList } — usedTodayList: {key: count} за день.
+function makeWeightModifier(strategy, ctx = {}) {
+  const s = normalizeStrategy(strategy);
+  if (s === 'weighted') {
+    return () => 1; // ничего не меняем
+  }
+
+  const usedTodayList = ctx.usedTodayList || {};
+
+  if (s === 'weighted-roundrobin') {
+    // Поднимаем провайдера, который «следующий по кругу». Простейшая реализация:
+    // модуль хранит курсор; при выборе провайдера cursor == его позиции — буст.
+    const keys = ctx.keys || [];
+    const nextKey = keys.length > 0 ? keys[rrCursor % keys.length] : null;
+    rrCursor++;
+    return (key) => (key === nextKey ? ROUND_ROBIN_BOOST : 1);
+  }
+
+  if (s === 'weighted-least') {
+    // Поднимаем тех, кто использован меньше среднего.
+    const counts = Object.values(usedTodayList);
+    const avg = counts.length > 0 ? counts.reduce((a, b) => a + b, 0) / counts.length : 0;
+    return (key) => {
+      const used = usedTodayList[key] || 0;
+      return used < avg ? LEAST_USED_BOOST : 1;
+    };
+  }
+
+  return () => 1;
+}
+
+function resetRoundRobin() { rrCursor = 0; }
+
+module.exports = { STRATEGIES, normalizeStrategy, makeWeightModifier, resetRoundRobin, ROUND_ROBIN_BOOST, LEAST_USED_BOOST };

package/lib/vetting.js

@@ -0,0 +1,91 @@
+// lib/vetting.js — самопроверка ответа второй моделью.
+// После получения ответа от free-модели (не-stream) отправляем краткий чек
+// другой модели: выявить фактические/логические ошибки. Экономит free-лимиты:
+// включается только по конфигу и только когда ответ достаточно содержательный.
+const logger = require('./logger');
+
+const VETTING_DEFAULTS = {
+  enabled: false,        // выкл по умолчанию — жжёт 2-й лимит на каждый запрос
+  minAnswerLen: 120,     // мельче — нечего проверять
+  maxChecksPerMin: 4,    // троттлинг: не больше N проверок в минуту
+  complexityOnly: true,  // только сложные/кодинг-задачи
+};
+
+const SYSTEM = 'Ты — строгий проверяльщик. Перечитай ответ, который дал другой ИИ, и найди ФАКТИЧЕСКИЕ или ЛОГИЧЕСКИЕ ошибки. Отвечай ТОЛЬКО одним из: "OK" (если ошибок нет) или "Замечание: <кратко, 1 фраза>" (если есть реальная ошибка). Не выдумывай — проверяй только то, что очевидно неверно. Не хвали и не повторяй ответ.';
+
+// Проверить, стоит ли вообще запускать проверку.
+function shouldVet({ config = {}, complexity = 0, answerLen = 0, category = '' } = {}) {
+  const cfg = Object.assign({}, VETTING_DEFAULTS, config);
+  if (!cfg.enabled) return false;
+  if (answerLen < cfg.minAnswerLen) return false;
+  // complexityOnly: vetting только для coding/design/reasoning (сложных задач);
+  // поиск/чат не тратим лишний лимит.
+  if (cfg.complexityOnly) {
+    const complexCats = new Set(['coding', 'design', 'reasoning']);
+    if (complexCats.has(category)) return true;
+    if (complexity >= 0.5) return true;
+    return false;
+  }
+  return true;
+}
+
+// Разобрать ответ проверяльщика → { ok:boolean, note:string }
+function parseVerdict(text) {
+  const s = String(text || '').trim();
+  if (!s) return { ok: true, note: '' };
+  if (/^\s*ok\b/i.test(s)) return { ok: true, note: '' };
+  const m = s.match(/замечание\s*[:\-]?\s*(.*)/i);
+  if (m && m[1] && m[1].trim()) return { ok: false, note: m[1].trim().slice(0, 200) };
+  // Иначе считаем OK (неопределённый ответ не блокируем).
+  return { ok: true, note: '' };
+}
+
+// Троттлинг: кольцевой буфер времени последних проверок.
+let lastChecks = [];
+
+function allowCheck(now = Date.now(), maxPerMin = VETTING_DEFAULTS.maxChecksPerMin) {
+  if (!Array.isArray(lastChecks)) lastChecks = [];
+  const cutoff = now - 60000;
+  lastChecks = lastChecks.filter((t) => t > cutoff);
+  if (lastChecks.length >= maxPerMin) return false;
+  lastChecks.push(now);
+  return true;
+}
+
+function resetThrottle() { lastChecks = []; }
+
+// Запустить проверку: body = второй вызов к провайдеру (callProvider).
+// Вернёт { checked:boolean, ok:boolean, note:string }.
+async function vetAnswer({ answer, callProvider, picks = [], config = {}, now = Date.now() }) {
+  const cfg = Object.assign({}, VETTING_DEFAULTS, config);
+  if (!answer || typeof answer !== 'string') return { checked: false, ok: true, note: '' };
+  if (!picks || picks.length === 0) return { checked: false, ok: true, note: '' };
+  if (!allowCheck(now, cfg.maxChecksPerMin)) return { checked: false, ok: true, note: '' };
+
+  // Пробуем других провайдеров (не тот, что дал ответ), пока один не проверит.
+  for (const provider of picks) {
+    try {
+      const result = await callProvider(provider, {
+        model: provider.model,
+        messages: [
+          { role: 'system', content: SYSTEM },
+          { role: 'user', content: 'Проверь этот ответ на ошибки. Ответ:\n\n' + answer.slice(0, 4000) },
+        ],
+        temperature: 0,
+        max_tokens: 120,
+      }, 20000, 1);
+      const text = result && result.data && result.data.choices && result.data.choices[0] &&
+        result.data.choices[0].message && result.data.choices[0].message.content;
+      if (text && text.trim()) {
+        const verdict = parseVerdict(text);
+        return { checked: true, ok: verdict.ok, note: verdict.note, by: provider.key || provider.model };
+      }
+    } catch (err) {
+      // пробуем следующего
+      logger.debug('vetting failed', { provider: provider.key, error: err.message });
+    }
+  }
+  return { checked: false, ok: true, note: '' };
+}
+
+module.exports = { shouldVet, parseVerdict, vetAnswer, allowCheck, resetThrottle, VETTING_DEFAULTS, SYSTEM };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freegate",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "description": "Free multi-provider LLM gateway with automatic failover. One OpenAI-compatible endpoint routes to 25 free models (Groq, Mistral, Gemini, NIM, OpenRouter, ZAI, Cerebras, DeepSeek). Never pay for LLMs.",
   "license": "MIT",
   "bin": {