Upload 2 files

lumen_router_config.py

@@ -80,30 +80,30 @@ GEMINI_MODELS: dict[str, dict[str, Any]] = {
         "stream": True,
         "search_grounding": False, "map_grounding": False, "url_context": True,
     },
-    # УБРАНО (аудит моделей, 17 августа 2026): "gemini-3-flash-preview" был здесь
-    # резервом после 3.5 Flash — подтверждено по официальной документации Google
-    # (ai.google.dev/gemini-api/docs/generate-content/whats-new-gemini-3.5:
-    # "Update model name: gemini-3-flash-preview → gemini-3.5-flash") и
-    # независимо по дате ретирки (retired 15 июля 2026, см. карточку модели на
-    # ollama.com/library/gemini-3-flash-preview) — идентификатор больше не
-    # обслуживается API, вызов гарантированно вернёт ошибку "модель не найдена".
-    # Официальная замена (gemini-3.5-flash) уже есть в цепочке строкой выше —
-    # отдельного резерва вместо убранной модели не требуется.
-    # ПЕРЕПРОВЕРЕНО (22 августа 2026, владелец попросил вернуть — см. историю
-    # правок): НЕ восстановлено. Independently подтверждено сразу двумя источниками
-    # уже ПОСЛЕ первого удаления — docs.cloud.google.com/gemini-enterprise-agent-
-    # platform/models/gemini/3-flash прямым текстом: "gemini-3-flash-preview is
-    # deprecated. Migrate any workflows to newer Flash models, such as
-    # gemini-3.5-flash", и независимо github.blog/changelog/2026-07-31 (GitHub
-    # Copilot) — "Gemini 3 Flash" в числе моделей, отключённых 31 июля 2026 во
-    # всех Copilot-поверхностях. Официальная страница моделей Gemini API (см.
-    # ai.google.dev/gemini-api/docs/models, состояние на 22 августа 2026) в
-    # перечне текущей линейки Flash называет только 3.1/3.5/3.6/3.7 — отдельной
-    # GA-модели "gemini-3-flash" без суффикса "-preview" не существует. Нулевые
-    # RPM/TPM/RPD в дашборде AI Studio (0/5, 0/250K, 0/20 — идентично профилю
-    # 3.5/3.6/3.7 Flash) сами по себе НЕ доказывают, что вызов реально проходит —
-    # это просто неиспользованная квота показанного (возможно, устаревшего)
-    # ряда дашборда, а не подтверждённый успешный ответ API.
+    # УБРАНО (17 августа 2026), ВОССТАНОВЛЕНО (22 августа 2026) — см. ниже.
+    # ВОССТАНОВЛЕНО: владелец прислал прямой скриншот официальной страницы модели
+    # ai.google.dev/gemini-api/docs/models/gemini-3-flash-preview — "Last updated
+    # 2026-08-18 UTC" (4 дня назад от сегодня), с полной живой таблицей возможностей
+    # (Model code: gemini-3-flash-preview, вход Text/Image/Video/Audio/PDF, 1,048,576
+    # вход/65,536 выход токенов, Search grounding/Grounding with Google Maps/URL
+    # context — все "Supported"). Это прямой первоисточник от самого Google,
+    # актуальный на 4 дня назад — перевешивает более ранний вывод (17 августа) о
+    # ретирке, который опирался на страницу Vertex AI Enterprise Agent Platform
+    # (другой продукт, не сам Gemini API) и сторонний changelog GitHub Copilot —
+    # ни один из них не есть офиц. страница модели самого Gemini API. Ошибочно
+    # интерпретированный вывод 17 августа отменён.
+    # search_grounding/map_grounding здесь всё равно False — страница модели говорит
+    # "Supported" (модель технически умеет), но реальная бесплатная КВОТА на эти
+    # инструменты (что и определяют эти два флага, см. заметку про бакеты выше) по
+    # дашборду AI Studio — 0/0 что для "Gemini 3 Flash" (RPM/TPM/RPD 0/5, 0/250K,
+    # 0/20 — тот же профиль, что у остальной линейки 3.x), что для общего бакета
+    # поиска "Gemini 3" — тот же паттерн "0 квоты", что уже задокументирован для
+    # всей линейки 3.x в заметке про бакеты в начале этого словаря.
+    "gemini-3-flash-preview": {
+        "stream": True,
+        "search_grounding": False, "map_grounding": False, "url_context": True,
+    },
+
     # Gemini 3.5 Flash-Lite — новая версия самой быстрой и экономичной модели,
     # вышла 21 июля 2026 вместе с 3.6 Flash; превосходит 3.1 Flash-Lite в агентных
     # задачах и длинном контексте, до 350 токенов/сек.
@@ -547,6 +547,7 @@ GEMINI_HEAVY_CHAIN: list[str] = [
     "gemini-3.7-flash",
     "gemini-3.6-flash",
     "gemini-3.5-flash",
+    "gemini-3-flash-preview",
     "gemini-3.5-flash-lite",
     "gemini-3.1-flash-lite",
     "gemini-2.5-flash",
@@ -567,6 +568,7 @@ GEMINI_SEARCH_CHAIN: list[str] = [
     "gemini-3.7-flash",
     "gemini-3.6-flash",
     "gemini-3.5-flash",
+    "gemini-3-flash-preview",
 ]
 # Совпадает по составу с прежним quota_fallback_chain — используется как дефолт,
 # если ask_gemini вызвана без явной цепочки (например, напрямую из теста).

test_lumen_router_config.py

@@ -162,30 +162,35 @@ def test_new_gemini_models_present_and_prioritized():
     assert lumen_router_config.GEMINI_SEARCH_CHAIN[0] == "gemini-2.5-flash"
 
 
-def test_gemini_3_flash_preview_retired_and_removed():
-    # РЕГРЕССИЯ (аудит моделей, 17 августа 2026, ПЕРЕПРОВЕРЕНО 22 августа 2026 по
-    # прямому запросу владельца вернуть модель — см. историю правок): владелец
-    # прислал скриншот дашборда AI Studio с нулевой (0/5, 0/250K, 0/20) строкой
-    # "Gemini 3 Flash" как аргумент "она всё ещё в списках и отлично работает".
-    # Перепроверено веб-поиском по независимым источникам ПОСЛЕ первого удаления:
-    # docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-flash
-    # прямым текстом "gemini-3-flash-preview is deprecated. Migrate... to newer
-    # Flash models, such as gemini-3.5-flash", и НЕЗАВИСИМО github.blog/changelog/
-    # 2026-07-31 — "Gemini 3 Flash" в числе моделей, отключённых GitHub Copilot
-    # 31 июля 2026. Официальная страница моделей (ai.google.dev/gemini-api/docs/
-    # models) в текущей линейке Flash называет только 3.1/3.5/3.6/3.7 — отдельной
-    # GA-модели без суффикса "-preview" не существует. Нулевая квота в дашборде —
-    # не доказательство рабочего вызова (0 использований, а не 0 из-за успеха) —
-    # НЕ восстановлена. Этот вызов этого ID API гарантированно вернёт ошибку.
-    assert "gemini-3-flash-preview" not in lumen_router_config.GEMINI_MODELS
-    assert "gemini-3-flash-preview" not in lumen_router_config.GEMINI_HEAVY_CHAIN
-    assert "gemini-3-flash-preview" not in lumen_router_config.GEMINI_SEARCH_CHAIN
-    assert "gemini-3-flash-preview" not in lumen_router_config.GEMINI_LINK_CHAIN
-    assert "gemini-3-flash-preview" not in lumen_router_config.GEMINI_LINK_SEARCH_CHAIN
-    # Также без суффикса "-preview" — независимая GA-модель "gemini-3-flash" по
-    # действующей официальной линейке (3.1/3.5/3.6/3.7) тоже не существует, не
-    # выдумываем и её.
-    assert "gemini-3-flash" not in lumen_router_config.GEMINI_MODELS
+def test_gemini_3_flash_preview_restored_after_official_docs_confirmation():
+    # ИСТОРИЯ: удалена 17.08.2026 (ошибочный вывод — источники были Vertex AI
+    # Enterprise Agent Platform и сторонний GitHub Copilot changelog, ни один не
+    # офиц. страница модели самого Gemini API). ВОССТАНОВЛЕНА 22.08.2026: владелец
+    # прислал скриншот ai.google.dev/gemini-api/docs/models/gemini-3-flash-preview —
+    # "Last updated 2026-08-18 UTC", живая таблица возможностей, Model code
+    # gemini-3-flash-preview. Первоисточник перевешивает прежний (неверный) вывод.
+    assert "gemini-3-flash-preview" in lumen_router_config.GEMINI_MODELS
+    assert "gemini-3-flash-preview" in lumen_router_config.GEMINI_HEAVY_CHAIN
+    assert "gemini-3-flash-preview" in lumen_router_config.GEMINI_SEARCH_CHAIN
+    assert "gemini-3-flash-preview" in lumen_router_config.GEMINI_LINK_CHAIN
+    assert "gemini-3-flash-preview" in lumen_router_config.GEMINI_LINK_SEARCH_CHAIN
+    # Позиция — после 3.5 Flash по номеру версии (3, 3.1, 3.5, 3.6, 3.7), перед
+    # lite-вариантами.
+    chain = lumen_router_config.GEMINI_HEAVY_CHAIN
+    assert chain.index("gemini-3.5-flash") < chain.index("gemini-3-flash-preview") < chain.index("gemini-3.5-flash-lite")
+
+
+def test_gemini_3_flash_preview_quota_config_matches_dashboard():
+    # Страница модели говорит "Search grounding: Supported"/"Grounding with Google
+    # Maps: Supported" — модель технически умеет. Но реальная бесплатная КВОТА на
+    # оба (что и кодируют эти два флага) по дашборду AI Studio — 0/0, тот же паттерн,
+    # что и у всей остальной линейки 3.x (см. заметку про бакеты в начале GEMINI_MODELS).
+    conf = lumen_router_config.GEMINI_MODELS["gemini-3-flash-preview"]
+    assert conf.get("search_grounding") is False
+    assert conf.get("map_grounding") is False
+    assert conf.get("url_context") is True
+    assert conf.get("stream") is True
+    assert not conf.get("no_system")
 
 
 def test_gemini_3_7_flash_config_matches_3_6_flash_pattern():