@iola_adm/iola-cli 0.2.0 → 0.2.2

package/README.md

@@ -131,7 +131,7 @@ CLI использует модель `iola-router:qwen3-1.7b-v4-q8` из GGUF-
 /model
 ```
 
-В интерактивном CLI команда `/model` переключает локальную модель IOLA, API-профили OpenAI/OpenRouter и Codex CLI. Для OpenRouter выбор устроен так: сначала выбирается разработчик моделей, затем CLI показывает до 30 самых свежих моделей для текстовой работы с датой релиза и размером контекста. В списке моделей `0` возвращает к выбору разработчика.
+В интерактивном CLI команда `/model` переключает локальные модели, российские AI-провайдеры YandexGPT/GigaChat, API-профили OpenAI/OpenRouter и Codex CLI. Российские провайдеры вызываются напрямую, без gateway/proxy. Для OpenRouter выбор устроен так: сначала выбирается разработчик моделей, затем CLI показывает до 30 самых свежих моделей для текстовой работы с датой релиза и размером контекста. В списке моделей `0` возвращает к выбору разработчика.
 
 В локальном выборе доступны:
 
@@ -141,6 +141,28 @@ CLI использует модель `iola-router:qwen3-1.7b-v4-q8` из GGUF-
 
 Если выбранная Ollama-модель еще не скачана, CLI предложит выполнить `ollama pull`.
 
+Российские AI:
+
+- Yandex AI Studio / YandexGPT: документация `https://yandex.cloud/ru/docs/foundation-models/`, аутентификация `https://yandex.cloud/ru/docs/ai-studio/api-ref/authentication`, тарифы `https://yandex.cloud/ru/docs/foundation-models/pricing`;
+- GigaChat: документация `https://developers.sber.ru/docs/ru/gigachat/overview`, получение токена `https://developers.sber.ru/docs/ru/gigachat/api/reference/rest/post-token`, тарифы `https://developers.sber.ru/docs/ru/gigachat/tariffs`.
+
+```bash
+iola ai key set yandexgpt
+iola ai setup yandexgpt --model yandexgpt-lite/latest
+
+iola ai key set gigachat
+iola ai setup gigachat --model GigaChat-2
+```
+
+У GigaChat для физических лиц есть Freemium-лимит на токены; для больших объемов используются платные пакеты. У YandexGPT тарификация идет через Yandex Cloud по токенам и квотам аккаунта, актуальные бесплатные гранты или лимиты нужно проверять в консоли Yandex Cloud.
+
+Зарубежные API-ключи:
+
+- OpenAI Platform: регистрация `https://platform.openai.com/`, ключи `https://platform.openai.com/api-keys`;
+- OpenRouter: регистрация `https://openrouter.ai/`, ключи `https://openrouter.ai/settings/keys`.
+
+Ключи сохраняются локально командой `iola ai key set openai` или `iola ai key set openrouter`. Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Перед настройкой платных API проверьте доступный способ оплаты в личном кабинете сервиса.
+
 Ollama остается опциональным runtime:
 
 ```bash
@@ -178,7 +200,7 @@ iola version --check
 - интеграция с публичным MCP-сервером Йошкар-Олы;
 - поиск и выгрузка открытых данных;
 - локальная SQLite-БД, история, сессии и FTS-поиск;
-- AI-профили для IOLA local, Ollama, OpenAI, OpenRouter и Codex CLI;
+- AI-профили для IOLA local, Ollama, YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - локальный tool-agent для модели IOLA с tools `search_data`, `search_entities`, `resolve_entity_field`, `get_card`, `export_report`, `file_read`, `browser_open`;
 - ленивые skills, toolsets, permissions, memory, hooks и готовые agents;
 - subagents, skill bundles, layered settings, usage/budget accounting и trajectory export;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",

package/src/cli.js

@@ -4,6 +4,7 @@ import { createServer } from "node:http";
 import { appendFile, copyFile, cp, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { randomUUID } from "node:crypto";
 import { emitKeypressEvents } from "node:readline";
 import readline from "node:readline/promises";
 import { Readable } from "node:stream";
@@ -164,6 +165,20 @@ const DEFAULT_AI_CONFIG = {
         baseUrl: "https://openrouter.ai/api/v1",
         networkMode: "gateway",
       },
+      yandexgpt: {
+        provider: "yandexgpt",
+        model: "yandexgpt-lite/latest",
+        baseUrl: "https://llm.api.cloud.yandex.net/foundationModels/v1",
+        networkMode: "direct",
+      },
+      gigachat: {
+        provider: "gigachat",
+        model: "GigaChat-2",
+        baseUrl: "https://gigachat.devices.sberbank.ru/api/v1",
+        authUrl: "https://ngw.devices.sberbank.ru:9443/api/v2/oauth",
+        scope: "GIGACHAT_API_PERS",
+        networkMode: "direct",
+      },
       codex: {
         provider: "codex",
         model: "gpt-5.5",
@@ -611,21 +626,25 @@ Usage:
   iola update
   iola ask TEXT [--profile NAME] [--model MODEL] [--tools] [--files] [--plan] [--trace] [--reasoning fast|verify|vote] [--output FILE] [--schema json|table] [--events] [--no-history] [--bare] [--quiet] [--no-color] [--fail-on-empty]
   iola data LAYER [--limit 10] [--search TEXT] [--where FIELD=VALUE] [--columns a,b,c] [--format table|json|csv]
-  iola ai ask TEXT [--provider iola|ollama|openai|openrouter] [--model MODEL]
+  iola ai ask TEXT [--provider iola|ollama|yandexgpt|gigachat|openai|openrouter] [--model MODEL]
   iola ai context TEXT [--json]
+  iola ai key set yandexgpt
+  iola ai key set gigachat
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
-  iola ai key delete openai|openrouter
+  iola ai key delete yandexgpt|gigachat|openai|openrouter
   iola ai profiles
   iola ai profile add NAME --provider PROVIDER --model MODEL
   iola ai profile use NAME
   iola ai profile delete NAME
-  iola ai models iola|ollama|openai|openrouter|codex [--search TEXT]
+  iola ai models iola|ollama|yandexgpt|gigachat|openai|openrouter|codex [--search TEXT]
   iola ai doctor [--json]
   iola ai setup
   iola ai setup iola [--yes] [--force]
   iola ai setup ollama [--yes] [--model MODEL]
+  iola ai setup yandexgpt [--model MODEL]
+  iola ai setup gigachat [--model MODEL]
   iola health [--json]
   iola layers [--json]
   iola schools [--limit 10] [--search TEXT] [--where FIELD=VALUE] [--columns a,b,c] [--format table|json|csv]
@@ -753,9 +772,14 @@ async function getAiReadiness() {
   const iola = await hasUsableIolaModel();
   const openai = Boolean(process.env.OPENAI_API_KEY || secrets.openai?.apiKey);
   const openrouter = Boolean(process.env.OPENROUTER_API_KEY || secrets.openrouter?.apiKey);
+  const yandexgpt = Boolean((process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY || secrets.yandexgpt?.apiKey)
+    && (process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID || secrets.yandexgpt?.folderId));
+  const gigachat = Boolean(process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY || secrets.gigachat?.apiKey);
   const providerReady = {
     iola,
     ollama,
+    yandexgpt,
+    gigachat,
     openai,
     openrouter,
     codex,
@@ -765,10 +789,12 @@ async function getAiReadiness() {
     activeProfile: activeProfileName,
     activeProvider: activeProfile.provider || "-",
     activeModel: activeProfile.model || "-",
-    anyReady: Boolean(iola || ollama || openai || openrouter || codex),
+    anyReady: Boolean(iola || ollama || yandexgpt || gigachat || openai || openrouter || codex),
     profiles: config.ai.profiles || {},
     iola,
     ollama,
+    yandexgpt,
+    gigachat,
     openai,
     openrouter,
     codex,
@@ -776,7 +802,7 @@ async function getAiReadiness() {
 }
 
 function getFallbackAiProfile(readiness) {
-  const priority = ["iola", "openai", "openrouter", "codex", "ollama"];
+  const priority = ["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"];
   for (const provider of priority) {
     if (!readiness[provider]) continue;
     const entry = Object.entries(readiness.profiles || {}).find(([, profile]) => profile.provider === provider);
@@ -1612,6 +1638,8 @@ function buildAgentStatusLine(state) {
   const kind = {
     iola: "IOLA local",
     ollama: "локальная",
+    yandexgpt: "YandexGPT",
+    gigachat: "GigaChat",
     openai: "API",
     openrouter: "API",
     codex: "Codex",
@@ -2051,6 +2079,8 @@ async function initCli(args = []) {
     console.log("Для настройки AI используйте:");
     console.log("  iola ai setup iola --yes");
     console.log("  iola ai setup ollama");
+    console.log("  iola ai key set yandexgpt");
+    console.log("  iola ai key set gigachat");
     console.log("  iola ai key set openai");
     console.log("  iola ai setup openai --model gpt-4.1-mini");
     return;
@@ -2073,21 +2103,25 @@ async function handleAi(args) {
   if (subcommand === "help") {
     await showBanner();
     console.log(`AI-команды:
-  iola ai ask TEXT [--provider iola|ollama|openai|openrouter] [--model MODEL]
+  iola ai ask TEXT [--provider iola|ollama|yandexgpt|gigachat|openai|openrouter] [--model MODEL]
   iola ai context TEXT [--json]
+  iola ai key set yandexgpt
+  iola ai key set gigachat
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
-  iola ai key delete openai|openrouter
+  iola ai key delete yandexgpt|gigachat|openai|openrouter
   iola ai profiles
-  iola ai profile add NAME --provider iola|ollama|openai|openrouter|codex --model MODEL
+  iola ai profile add NAME --provider iola|ollama|yandexgpt|gigachat|openai|openrouter|codex --model MODEL
   iola ai profile use NAME
   iola ai profile delete NAME
-  iola ai models iola|ollama|openai|openrouter|codex [--search TEXT]
+  iola ai models iola|ollama|yandexgpt|gigachat|openai|openrouter|codex [--search TEXT]
   iola ai doctor [--json]
   iola ai setup
   iola ai setup iola [--yes] [--force]
   iola ai setup ollama [--yes] [--model MODEL]
+  iola ai setup yandexgpt [--model MODEL]
+  iola ai setup gigachat [--model MODEL]
   iola ai setup openai [--model MODEL]
   iola ai setup openrouter [--model MODEL]
 
@@ -4187,9 +4221,14 @@ async function aiSetup(args) {
     return;
   }
 
-  if (provider === "openai" || provider === "openrouter") {
+  if (provider === "openai" || provider === "openrouter" || provider === "yandexgpt" || provider === "gigachat") {
     const options = parseOptions(args.slice(1));
-    const model = options.model || (provider === "openai" ? "gpt-4.1-mini" : "openai/gpt-4.1-mini");
+    const model = options.model || {
+      openai: "gpt-4.1-mini",
+      openrouter: "openai/gpt-4.1-mini",
+      yandexgpt: "yandexgpt-lite/latest",
+      gigachat: "GigaChat-2",
+    }[provider];
     const profileName = options.name || provider;
     const profile = buildProfileFromOptions(provider, { ...options, model });
     const config = await loadConfig();
@@ -4208,7 +4247,13 @@ async function aiSetup(args) {
     });
     console.log(`AI-профиль ${profileName} сохранен и выбран в ${CONFIG_FILE}`);
     console.log(`Ключ сохраните командой: iola ai key set ${provider}`);
-    console.log(`Также можно использовать переменную окружения ${provider === "openai" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY"}.`);
+    const envHint = {
+      openai: "OPENAI_API_KEY",
+      openrouter: "OPENROUTER_API_KEY",
+      yandexgpt: "YANDEXGPT_API_KEY и YANDEXGPT_FOLDER_ID",
+      gigachat: "GIGACHAT_AUTH_KEY",
+    }[provider];
+    console.log(`Также можно использовать переменную окружения ${envHint}.`);
     return;
   }
 
@@ -4259,10 +4304,12 @@ async function handleAiKey(args) {
   }
 
   throw new Error(`Unknown key command. Use:
+  iola ai key set yandexgpt
+  iola ai key set gigachat
   iola ai key set openai
   iola ai key set openrouter
   iola ai key status
-  iola ai key delete openai|openrouter`);
+  iola ai key delete yandexgpt|gigachat|openai|openrouter`);
 }
 
 async function handleAiProfile(args) {
@@ -4304,8 +4351,8 @@ async function aiModels(args) {
   const [provider] = args;
   const options = parseOptions(args.slice(1));
 
-  if (!["iola", "ollama", "openai", "openrouter", "codex"].includes(provider)) {
-    throw new Error("Провайдер обязателен: iola ai models iola|ollama|openai|openrouter|codex");
+  if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(provider)) {
+    throw new Error("Провайдер обязателен: iola ai models iola|ollama|yandexgpt|gigachat|openai|openrouter|codex");
   }
 
   const models = await listAiModels(provider);
@@ -4412,6 +4459,23 @@ async function listAiModels(provider) {
       .sort((left, right) => left.id.localeCompare(right.id));
   }
 
+  if (provider === "yandexgpt") {
+    return [
+      { id: "yandexgpt-lite/latest", provider: "yandexgpt", note: "быстрая и недорогая модель" },
+      { id: "yandexgpt/latest", provider: "yandexgpt", note: "YandexGPT Pro, latest" },
+      { id: "yandexgpt/rc", provider: "yandexgpt", note: "YandexGPT Pro, release candidate" },
+    ];
+  }
+
+  if (provider === "gigachat") {
+    return [
+      { id: "GigaChat-2", provider: "gigachat", note: "основная модель" },
+      { id: "GigaChat-2-Pro", provider: "gigachat", note: "повышенное качество" },
+      { id: "GigaChat-2-Max", provider: "gigachat", note: "максимальное качество" },
+      { id: "GigaChat", provider: "gigachat", note: "legacy/fallback" },
+    ];
+  }
+
   const version = await getCommandVersion("codex", ["--version"]);
   return [
     { id: "gpt-5.5", provider: "codex", note: version },
@@ -4562,7 +4626,7 @@ async function printAiProfiles() {
     baseUrl: profile.baseUrl || "-",
     mode: profile.provider === "codex"
       ? `sandbox=${profile.sandbox || "read-only"}, approval=${profile.approval || "never"}`
-      : (profile.provider === "openai" || profile.provider === "openrouter" ? `network=${getAiNetworkMode(profile)}` : "-"),
+      : (profile.provider === "openai" || profile.provider === "openrouter" || profile.provider === "yandexgpt" || profile.provider === "gigachat" ? `network=${getAiNetworkMode(profile)}` : "-"),
   }));
 
   printTable(rows, [
@@ -4595,8 +4659,8 @@ async function addAiProfile(name, args) {
   const options = parseOptions(args);
   const provider = options.provider;
 
-  if (!["iola", "ollama", "openai", "openrouter", "codex"].includes(provider)) {
-    throw new Error("Провайдер должен быть iola, ollama, openai, openrouter или codex.");
+  if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(provider)) {
+    throw new Error("Провайдер должен быть iola, ollama, yandexgpt, gigachat, openai, openrouter или codex.");
   }
 
   const profile = buildProfileFromOptions(provider, options);
@@ -4676,6 +4740,7 @@ async function deleteAiProfile(name) {
 
 function buildProfileFromOptions(provider, options) {
   const defaults = DEFAULT_AI_CONFIG.ai.profiles[provider === "ollama" || provider === "iola" ? "local" : provider];
+  if (!defaults) throw new Error(`Неизвестный AI-провайдер: ${provider}`);
   const profile = {
     ...defaults,
     provider,
@@ -4724,13 +4789,15 @@ async function useAiProvider(args) {
 
   const provider = providerOrProfile;
 
-  if (provider !== "iola" && provider !== "ollama" && provider !== "openai" && provider !== "openrouter" && provider !== "codex") {
-    throw new Error("Провайдер должен быть iola, ollama, openai, openrouter, codex или именем AI-профиля.");
+  if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(provider)) {
+    throw new Error("Провайдер должен быть iola, ollama, yandexgpt, gigachat, openai, openrouter, codex или именем AI-профиля.");
   }
 
   const defaultModel = {
     iola: IOLA_LOCAL_MODEL,
     ollama: config.ai.provider === "ollama" ? config.ai.model : IOLA_LOCAL_OLLAMA_MODEL,
+    yandexgpt: config.ai.provider === "yandexgpt" ? config.ai.model : "yandexgpt-lite/latest",
+    gigachat: config.ai.provider === "gigachat" ? config.ai.model : "GigaChat-2",
     openai: config.ai.provider === "openai" ? config.ai.model : "gpt-4.1-mini",
     openrouter: config.ai.provider === "openrouter" ? config.ai.model : "openai/gpt-4.1-mini",
     codex: config.ai.provider === "codex" ? config.ai.model : "gpt-5.5",
@@ -4775,6 +4842,7 @@ function normalizeModelMenuTarget(value = "") {
   const normalized = String(value || "").trim().toLocaleLowerCase("ru-RU");
   if (!normalized) return "";
   if (["local", "локальная", "локально", "iola", "иола", "ollama"].includes(normalized)) return "local";
+  if (["ru", "rus", "russian", "российские", "российская", "россия", "яндекс", "yandex", "yandexgpt", "gigachat", "гигачат"].includes(normalized)) return normalized === "yandexgpt" || normalized === "яндекс" || normalized === "yandex" ? "yandexgpt" : normalized === "gigachat" || normalized === "гигачат" ? "gigachat" : "russian";
   if (["api", "апи"].includes(normalized)) return "api";
   if (normalized === "openai") return "openai";
   if (normalized === "openrouter" || normalized === "router") return "openrouter";
@@ -4784,13 +4852,14 @@ function normalizeModelMenuTarget(value = "") {
 
 async function chooseModelTarget() {
   console.log("Выберите AI-подключение:");
-  console.log("  1. Локальная модель IOLA");
-  console.log("  2. API (OpenAI/OpenRouter)");
-  console.log("  3. Codex CLI");
+  console.log("  1. Локальные модели");
+  console.log("  2. Российские AI (YandexGPT/GigaChat)");
+  console.log("  3. API (OpenAI/OpenRouter)");
+  console.log("  4. Codex CLI");
   console.log("  0. Отмена");
 
   const answer = await askText("Номер: ");
-  return { 1: "local", 2: "api", 3: "codex" }[answer.trim()] || "";
+  return { 1: "local", 2: "russian", 3: "api", 4: "codex" }[answer.trim()] || "";
 }
 
 async function openModelTargetMenu(target) {
@@ -4812,6 +4881,20 @@ async function openModelTargetMenu(target) {
     return;
   }
 
+  if (target === "yandexgpt" || target === "gigachat") {
+    const model = await chooseAiModel(target);
+    if (model) await switchModelTarget(target, model);
+    return;
+  }
+
+  if (target === "russian") {
+    const provider = await chooseRussianProvider();
+    if (!provider) return;
+    const model = await chooseAiModel(provider);
+    if (model) await switchModelTarget(provider, model);
+    return;
+  }
+
   const provider = await chooseApiProvider();
   if (!provider) return;
   const model = await chooseAiModel(provider);
@@ -4837,6 +4920,25 @@ async function chooseApiProvider() {
   return choices[answer - 1]?.id || "";
 }
 
+async function chooseRussianProvider() {
+  const config = await loadConfig();
+  const russianProfiles = Object.entries(config.ai.profiles || {})
+    .filter(([, profile]) => profile.provider === "yandexgpt" || profile.provider === "gigachat")
+    .map(([name, profile]) => ({ id: profile.provider, label: `${name}: ${profile.provider} (${profile.model || "-"})` }));
+  const choices = [
+    ...russianProfiles,
+    { id: "yandexgpt", label: "YandexGPT API" },
+    { id: "gigachat", label: "GigaChat API" },
+  ].filter((item, index, array) => array.findIndex((candidate) => candidate.id === item.id) === index);
+
+  console.log("Выберите российское AI-подключение:");
+  choices.forEach((item, index) => console.log(`  ${index + 1}. ${item.label}`));
+  console.log("  0. Отмена");
+
+  const answer = Number(await askText("Номер: "));
+  return choices[answer - 1]?.id || "";
+}
+
 async function getDefaultApiProviderForModelSwitch() {
   const config = await loadConfig();
   const activeProfile = config.ai.profiles?.[getActiveProfileName(config)];
@@ -4881,7 +4983,7 @@ async function chooseAiModel(provider) {
     return chooseOpenRouterModel();
   }
 
-  if (provider === "openai") {
+  if (provider === "openai" || provider === "yandexgpt" || provider === "gigachat") {
     const ready = await ensureApiKeyForModelSelection(provider);
     if (!ready) return "";
   }
@@ -4986,9 +5088,14 @@ async function chooseOpenRouterModel() {
 }
 
 async function ensureApiKeyForModelSelection(provider) {
-  if (provider !== "openai" && provider !== "openrouter") return true;
-  if (await getApiKey(provider)) return true;
-  const label = provider === "openai" ? "OpenAI" : "OpenRouter";
+  if (!["openai", "openrouter", "yandexgpt", "gigachat"].includes(provider)) return true;
+  if (await getApiKey(provider) && (provider !== "yandexgpt" || await getYandexFolderId())) return true;
+  const label = {
+    openai: "OpenAI",
+    openrouter: "OpenRouter",
+    yandexgpt: "YandexGPT",
+    gigachat: "GigaChat",
+  }[provider];
   console.log(`${label} API key не найден. Введите ключ, чтобы получить список моделей.`);
   try {
     await setAiKey(provider);
@@ -5114,7 +5221,12 @@ async function setAiKey(provider) {
     throw new Error("Для сохранения ключа запустите команду в интерактивном терминале.");
   }
 
-  const envName = provider === "openai" ? "OPENAI_API_KEY" : "OPENROUTER_API_KEY";
+  const envName = {
+    openai: "OPENAI_API_KEY",
+    openrouter: "OPENROUTER_API_KEY",
+    yandexgpt: "YANDEXGPT_API_KEY",
+    gigachat: "GIGACHAT_AUTH_KEY",
+  }[provider];
   const key = (await askText(`Введите ${envName}: `)).trim();
 
   if (!key) {
@@ -5122,23 +5234,44 @@ async function setAiKey(provider) {
   }
 
   const secrets = await loadSecrets();
-  secrets[provider] = { apiKey: key };
+  if (provider === "yandexgpt") {
+    const folderId = (await askText("Введите YANDEXGPT_FOLDER_ID / ID каталога Yandex Cloud: ")).trim();
+    if (!folderId) throw new Error("Folder ID пустой, сохранение отменено.");
+    secrets[provider] = { apiKey: key, folderId };
+  } else if (provider === "gigachat") {
+    const scope = (await askText("Scope [GIGACHAT_API_PERS]: ")).trim() || "GIGACHAT_API_PERS";
+    secrets[provider] = { apiKey: key, scope };
+  } else {
+    secrets[provider] = { apiKey: key };
+  }
   await saveSecrets(secrets);
   console.log(`Ключ ${provider} сохранен локально: ${SECRETS_FILE}`);
 }
 
 async function printAiKeyStatus() {
   const secrets = await loadSecrets();
-  const rows = ["openai", "openrouter"].map((provider) => ({
-    provider,
-    env: provider === "openai" ? (process.env.OPENAI_API_KEY ? "yes" : "no") : (process.env.OPENROUTER_API_KEY ? "yes" : "no"),
-    local: secrets[provider]?.apiKey ? "yes" : "no",
-  }));
+  const rows = ["yandexgpt", "gigachat", "openai", "openrouter"].map((provider) => {
+    const env = {
+      openai: process.env.OPENAI_API_KEY,
+      openrouter: process.env.OPENROUTER_API_KEY,
+      yandexgpt: process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY,
+      gigachat: process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY,
+    }[provider];
+    return {
+      provider,
+      env: env ? "yes" : "no",
+      local: secrets[provider]?.apiKey ? "yes" : "no",
+      extra: provider === "yandexgpt"
+        ? ((process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID || secrets.yandexgpt?.folderId) ? "folder ok" : "folder missing")
+        : (provider === "gigachat" && secrets.gigachat?.scope ? `scope ${secrets.gigachat.scope}` : ""),
+    };
+  });
 
   printTable(rows, [
     ["provider", "Провайдер"],
     ["env", "Env"],
     ["local", "Локально"],
+    ["extra", "Дополнительно"],
   ]);
 }
 
@@ -6393,26 +6526,30 @@ function toCsv(rows) {
 }
 
 function assertKeyProvider(provider) {
-  if (provider !== "openai" && provider !== "openrouter") {
-    throw new Error("Провайдер должен быть openai или openrouter.");
+  if (!["openai", "openrouter", "yandexgpt", "gigachat"].includes(provider)) {
+    throw new Error("Провайдер должен быть yandexgpt, gigachat, openai или openrouter.");
   }
 }
 
 async function chooseAiProvider() {
   console.log("Выберите режим AI:");
   console.log("1. Локальная модель IOLA");
-  console.log("2. OpenAI API");
-  console.log("3. OpenRouter API");
-  console.log("4. Codex/MCP");
-  console.log("5. Ollama");
+  console.log("2. Ollama");
+  console.log("3. YandexGPT API");
+  console.log("4. GigaChat API");
+  console.log("5. OpenAI API");
+  console.log("6. OpenRouter API");
+  console.log("7. Codex/MCP");
 
   const answer = (await askText("Введите номер [1]: ")).trim() || "1";
   return {
     1: "iola",
-    2: "openai",
-    3: "openrouter",
-    4: "codex",
-    5: "ollama",
+    2: "ollama",
+    3: "yandexgpt",
+    4: "gigachat",
+    5: "openai",
+    6: "openrouter",
+    7: "codex",
   }[answer] || "iola";
 }
 
@@ -6558,7 +6695,7 @@ async function aiAsk(args, context = {}) {
   const historyEnabled = !options.bare && !options["no-history"] && isFeatureEnabled("sqlite-history");
   const sessionId = historyEnabled && isFeatureEnabled("sessions") ? ensureSessionForAsk(options, providerConfig, question) : null;
   const history = context.history || (sessionId ? getSessionAiHistory(sessionId) : []);
-  const directAnswer = buildDirectDataAnswer(question, dataContext);
+  const directAnswer = await buildDirectDataAnswer(question, dataContext);
   if (directAnswer) {
     if (historyEnabled) {
       recordAskHistory({ question, answer: directAnswer, providerConfig, dataContext, error: "", sessionId });
@@ -6621,10 +6758,12 @@ async function aiAsk(args, context = {}) {
   return answer;
 }
 
-function buildDirectDataAnswer(question, dataContext) {
+async function buildDirectDataAnswer(question, dataContext) {
   const normalized = question.toLocaleLowerCase("ru-RU");
   const requestedFields = detectDirectDataFields(normalized);
   if (requestedFields.length === 0) return "";
+  const educationAnswer = await buildDeterministicEducationAnswer(question, requestedFields);
+  if (educationAnswer) return educationAnswer;
   const rows = [
     ...dataContext.schools.map((item) => ({ layer: "schools", layerName: "школы", ...item })),
     ...dataContext.kindergartens.map((item) => ({ layer: "kindergartens", layerName: "детские сады", ...item })),
@@ -6654,6 +6793,140 @@ function detectDirectDataFields(normalizedQuestion) {
   return [...new Set(fields)];
 }
 
+async function buildDeterministicEducationAnswer(question, requestedFields) {
+  const normalized = String(question || "").toLocaleLowerCase("ru-RU");
+  const layer = /(сад|детсад|детск\w*\s+сад|садик)/iu.test(normalized)
+    ? "kindergartens"
+    : /(школ|сош|лице|гимнази)/iu.test(normalized)
+      ? "schools"
+      : "";
+  if (!layer) return "";
+
+  const requests = extractEducationFactRequests(question, requestedFields, layer);
+  if (requests.length === 0) return "";
+
+  const items = normalizeItems(await fetchAllApiItems(`${await getApiBaseUrl()}/${DATASETS[layer].endpoint}`))
+    .map((item) => ({ layer, layerName: layer === "schools" ? "школы" : "детские сады", ...selectPublicSummary(item) }));
+  const answers = [];
+
+  for (const request of requests) {
+    const answer = resolveEducationFactRequest(request, items, layer);
+    if (answer) answers.push(answer);
+  }
+
+  return answers.filter(Boolean).join("\n");
+}
+
+function extractEducationFactRequests(question, requestedFields, layer) {
+  const normalized = String(question || "").toLocaleLowerCase("ru-RU");
+  const segments = splitEducationQuestionSegments(question);
+  const requests = [];
+
+  for (const segment of segments) {
+    const segmentFields = detectDirectDataFields(segment.toLocaleLowerCase("ru-RU"));
+    const fields = segmentFields.length > 0 ? segmentFields : (segments.length === 1 ? requestedFields : []);
+    if (fields.length === 0) continue;
+    const place = detectEducationPlace(segment) || detectEducationPlace(question);
+    const number = extractEntityNumberFromQuestion(segment, layer)
+      || (segments.length === 1 ? extractEntityNumberFromQuestion(question, layer) : "");
+    const hasEntitySignal = Boolean(number || place || /(школ|сош|лице|гимнази|сад|детсад|детск\w*\s+сад|садик)/iu.test(segment));
+    if (!hasEntitySignal) continue;
+    requests.push({ segment, fields, number, place });
+  }
+
+  if (requests.length === 0 && requestedFields.length > 0 && /(школ|сош|лице|гимнази|сад|детсад|детск\w*\s+сад|садик)/iu.test(normalized)) {
+    requests.push({
+      segment: question,
+      fields: requestedFields,
+      number: extractEntityNumberFromQuestion(question, layer),
+      place: detectEducationPlace(question),
+    });
+  }
+
+  return requests;
+}
+
+function splitEducationQuestionSegments(question) {
+  const text = String(question || "").trim();
+  if (!text) return [];
+  return text
+    .split(/\s+(?:и|а также|,|;)\s+(?=(?:кто|какой|какая|адрес|телефон|инн|сайт|почт|email|директ|руковод|завед|где))/iu)
+    .map((part) => part.trim())
+    .filter(Boolean);
+}
+
+function detectEducationPlace(text) {
+  const normalized = normalizeEntityText(text || "");
+  if (/(козьмодемьянск|козьмодемьянск[аеуом]?|козьмодемьянск\w*)/iu.test(normalized)) {
+    return { id: "kozmodemyansk", label: "Козьмодемьянск", locative: "Козьмодемьянске", supported: false, aliases: ["козьмодемьянск", "козмодемьянск"] };
+  }
+  if (/(семеновк|семёновк)/iu.test(normalized)) {
+    return { id: "semenovka", label: "Семёновка", locative: "Семёновке", supported: true, aliases: ["семеновк", "семёновк"] };
+  }
+  if (/(йошкар|йошкар-ола|йошкар ола)/iu.test(normalized)) {
+    return { id: "yoshkar_ola", label: "Йошкар-Ола", locative: "Йошкар-Оле", supported: true, aliases: ["йошкар", "йошкар-ола", "йошкар ола"] };
+  }
+  return null;
+}
+
+function resolveEducationFactRequest(request, items, layer) {
+  const entityLabel = layer === "schools" ? "школу" : "детский сад";
+  if (request.place && !request.place.supported) {
+    return `В текущих открытых данных iola-cli есть данные городского округа Йошкар-Ола. Данных по ${request.place.locative || request.place.label} в этом слое нет, поэтому ответить по этому объекту не могу.`;
+  }
+
+  let candidates = items;
+  if (request.place) {
+    candidates = candidates.filter((item) => itemMatchesPlace(item, request.place));
+  }
+
+  if (request.number) {
+    const exactByNumber = candidates.filter((item) => itemNameHasNumber(item, request.number));
+    if (exactByNumber.length === 0) {
+      if (request.place && candidates.length > 0) {
+        return [
+          `Точную ${entityLabel} № ${request.number} в ${request.place.locative || request.place.label} в открытом слое не нашел.`,
+          `В ${request.place.locative || request.place.label} есть:`,
+          ...candidates.slice(0, 5).map((item) => `- ${getDirectDataItemName(item)}${item.address ? `; адрес: ${item.address}` : ""}${item.inn ? `; ИНН ${item.inn}` : ""}`),
+        ].join("\n");
+      }
+      return `В открытом слое не нашел ${entityLabel} № ${request.number}.`;
+    }
+    candidates = exactByNumber;
+  }
+
+  if (candidates.length === 0) {
+    const placeText = request.place ? ` в ${request.place.locative || request.place.label}` : "";
+    return `В открытом слое не нашел ${entityLabel}${placeText}.`;
+  }
+
+  if (candidates.length > 1 && !request.number) {
+    return [
+      `Нашел несколько подходящих записей${request.place ? ` для ${request.place.locative || request.place.label}` : ""}:`,
+      ...candidates.slice(0, 5).flatMap((item) => [
+        `- ${getDirectDataItemName(item)}`,
+        ...request.fields.map((field) => `  ${formatDirectDataField(field, item)}`).filter(Boolean),
+        `  Источник: слой ${item.layer}, ИНН ${item.inn || "-"}.`,
+      ]),
+    ].join("\n");
+  }
+
+  const item = candidates[0];
+  const lines = request.fields.map((field) => formatDirectDataField(field, item)).filter(Boolean);
+  if (lines.length === 0) return "";
+  return [
+    ...lines,
+    `Источник: слой ${item.layer}, ${getDirectDataItemName(item)}, ИНН ${item.inn || "-"}.`,
+  ].join("\n");
+}
+
+function itemMatchesPlace(item, place) {
+  if (!place) return true;
+  const text = normalizeEntityText(`${item.name || ""} ${item.address || ""} ${item.legal_address || ""} ${item.fns_full_name || ""} ${item.fns_short_name || ""}`);
+  if (place.id === "yoshkar_ola") return /йошкар|йошкар-ола|йошкар ола/u.test(text) && !/семеновк/u.test(text);
+  return place.aliases.some((alias) => text.includes(normalizeEntityText(alias)));
+}
+
 function pickDirectDataItem(question, dataContext, rows) {
   const patterns = dataContext.query?.patterns || extractStructuredPatterns(question);
   const targetLayers = patterns.targetLayers || [];
@@ -8000,6 +8273,14 @@ async function callAiProvider(config, messages) {
     return callOpenAiCompatible(config, messages, await getApiKey("openrouter"), "OpenRouter");
   }
 
+  if (config.provider === "yandexgpt") {
+    return callYandexGpt(config, messages);
+  }
+
+  if (config.provider === "gigachat") {
+    return callGigaChat(config, messages);
+  }
+
   if (config.provider === "codex") {
     return callCodex(config, messages);
   }
@@ -8477,6 +8758,96 @@ async function callAiRelayModels(config, apiKey, providerName) {
   return response.json();
 }
 
+async function callYandexGpt(config, messages) {
+  const apiKey = await getApiKey("yandexgpt");
+  const folderId = await getYandexFolderId();
+  if (!apiKey || !folderId) {
+    throw new Error("YandexGPT API key или folder ID не найден. Выполните iola ai key set yandexgpt или задайте YANDEXGPT_API_KEY и YANDEXGPT_FOLDER_ID.");
+  }
+
+  const model = config.model || "yandexgpt-lite/latest";
+  const modelUri = model.startsWith("gpt://") ? model : `gpt://${folderId}/${model}`;
+  const response = await fetch(`${String(config.baseUrl || "https://llm.api.cloud.yandex.net/foundationModels/v1").replace(/\/+$/, "")}/completion`, {
+    method: "POST",
+    headers: {
+      authorization: `Api-Key ${apiKey}`,
+      "content-type": "application/json",
+    },
+    body: JSON.stringify({
+      modelUri,
+      completionOptions: {
+        stream: false,
+        temperature: Number(config.temperature ?? 0.2),
+        maxTokens: String(config.maxTokens || 2000),
+      },
+      messages: messages.map((message) => ({
+        role: message.role === "assistant" ? "assistant" : message.role === "system" ? "system" : "user",
+        text: message.content,
+      })),
+    }),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`YandexGPT request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, apiKey)}`);
+  }
+
+  const payload = await response.json();
+  return payload.result?.alternatives?.[0]?.message?.text || "";
+}
+
+async function callGigaChat(config, messages) {
+  const authKey = await getApiKey("gigachat");
+  if (!authKey) {
+    throw new Error("GigaChat authorization key не найден. Выполните iola ai key set gigachat или задайте GIGACHAT_AUTH_KEY.");
+  }
+
+  const token = await getGigaChatAccessToken(config, authKey);
+  const response = await fetch(`${String(config.baseUrl || "https://gigachat.devices.sberbank.ru/api/v1").replace(/\/+$/, "")}/chat/completions`, {
+    method: "POST",
+    headers: {
+      authorization: `Bearer ${token}`,
+      "content-type": "application/json",
+    },
+    body: JSON.stringify({
+      model: config.model || "GigaChat-2",
+      messages,
+      temperature: Number(config.temperature ?? 0.2),
+    }),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`GigaChat request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, token)}`);
+  }
+
+  const payload = await response.json();
+  return payload.choices?.[0]?.message?.content || "";
+}
+
+async function getGigaChatAccessToken(config, authKey) {
+  const secrets = await loadSecrets();
+  const scope = process.env.GIGACHAT_SCOPE || secrets.gigachat?.scope || config.scope || "GIGACHAT_API_PERS";
+  const response = await fetch(config.authUrl || "https://ngw.devices.sberbank.ru:9443/api/v2/oauth", {
+    method: "POST",
+    headers: {
+      authorization: `Basic ${authKey}`,
+      "content-type": "application/x-www-form-urlencoded",
+      RqUID: randomUUID(),
+    },
+    body: new URLSearchParams({ scope }).toString(),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`GigaChat token request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, authKey)}`);
+  }
+
+  const payload = await response.json();
+  if (!payload.access_token) throw new Error("GigaChat не вернул access_token.");
+  return payload.access_token;
+}
+
 function getAiNetworkMode(config = {}) {
   return validateAiNetworkMode(AI_NETWORK_MODE || config.networkMode || "gateway");
 }
@@ -8507,10 +8878,26 @@ async function getApiKey(provider) {
     return process.env.OPENROUTER_API_KEY;
   }
 
+  if (provider === "yandexgpt" && (process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY)) {
+    return process.env.YANDEXGPT_API_KEY || process.env.YANDEX_CLOUD_API_KEY;
+  }
+
+  if (provider === "gigachat" && (process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY)) {
+    return process.env.GIGACHAT_AUTH_KEY || process.env.GIGACHAT_API_KEY;
+  }
+
   const secrets = await loadSecrets();
   return secrets[provider]?.apiKey || "";
 }
 
+async function getYandexFolderId() {
+  if (process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID) {
+    return process.env.YANDEXGPT_FOLDER_ID || process.env.YANDEX_CLOUD_FOLDER_ID;
+  }
+  const secrets = await loadSecrets();
+  return secrets.yandexgpt?.folderId || "";
+}
+
 async function listLayers(args) {
   const options = parseOptions(args);
   const info = await fetchJson(`${await getMcpBaseUrl()}/mcp-version`);
@@ -8768,6 +9155,20 @@ async function onboard(args = []) {
       await chooseAndSaveApiModel("openrouter");
     }
   }
+  if (components.includes("yandexgpt")) {
+    await aiSetup(["yandexgpt"]);
+    if (process.stdin.isTTY) {
+      await setAiKey("yandexgpt");
+      await chooseAndSaveApiModel("yandexgpt");
+    }
+  }
+  if (components.includes("gigachat")) {
+    await aiSetup(["gigachat"]);
+    if (process.stdin.isTTY) {
+      await setAiKey("gigachat");
+      await chooseAndSaveApiModel("gigachat");
+    }
+  }
   if (components.includes("codex")) {
     await installCodexIfMissing();
     await aiSetup(["codex"]);
@@ -8806,14 +9207,16 @@ async function chooseOnboardComponents(status = null) {
       1: "workspace",
       2: "policy",
       3: "iola",
-      4: "openai",
-      5: "openrouter",
-      6: "codex",
-      7: "codex-mcp",
-      8: "archive",
-      9: "index",
-      10: "browser",
-      11: "ollama",
+      4: "yandexgpt",
+      5: "gigachat",
+      6: "openai",
+      7: "openrouter",
+      8: "codex",
+      9: "codex-mcp",
+      10: "archive",
+      11: "index",
+      12: "browser",
+      13: "ollama",
     };
     return [...selected].map((item) => map[item] || item).filter(Boolean);
   } finally {
@@ -8841,6 +9244,8 @@ async function getOnboardComponentStatus() {
     policy: policyReady,
     iola: Boolean(readiness.iola),
     ollama: Boolean(ollamaVersion && readiness.ollama),
+    yandexgpt: Boolean(readiness.yandexgpt),
+    gigachat: Boolean(readiness.gigachat),
     openai: Boolean(readiness.openai),
     openrouter: Boolean(readiness.openrouter),
     codex: Boolean(codexVersion !== "не найден" && readiness.codex),
@@ -8856,14 +9261,16 @@ function onboardComponentRows(status) {
     ["1", "workspace", "workspace и контекст", "рабочая папка, IOLA.md и .iola/context.md"],
     ["2", "policy", "policy analyst", "разрешения и профиль аналитика"],
     ["3", "iola", "IOLA локальная модель", "локальная модель найдена"],
-    ["4", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
-    ["5", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
-    ["6", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
-    ["7", "codex-mcp", "MCP для Codex", "можно переустановить/обновить"],
-    ["8", "archive", "7-Zip / архивы", "архиватор найден"],
-    ["9", "index", "Индекс локальных документов", "настраивается под выбранную папку"],
-    ["10", "browser", "Browser runtime", "Playwright/Chromium установлен"],
-    ["11", "ollama", "Ollama", "опциональный локальный runtime"],
+    ["4", "yandexgpt", "YandexGPT API", "ключ и folder ID сохранены или есть в env"],
+    ["5", "gigachat", "GigaChat API", "authorization key сохранен или есть в env"],
+    ["6", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
+    ["7", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
+    ["8", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
+    ["9", "codex-mcp", "MCP для Codex", "можно переустановить/обновить"],
+    ["10", "archive", "7-Zip / архивы", "архиватор найден"],
+    ["11", "index", "Индекс локальных документов", "настраивается под выбранную папку"],
+    ["12", "browser", "Browser runtime", "Playwright/Chromium установлен"],
+    ["13", "ollama", "Ollama", "опциональный локальный runtime"],
   ];
   return rows.map(([number, key, title, hint]) => ({ number, key, title, hint, status: status[key] ? "готово" : "не настроено" }));
 }
@@ -8873,12 +9280,12 @@ function defaultOnboardSelection(status) {
   if (!status.workspace) defaults.push("1");
   if (!status.policy) defaults.push("2");
   if (!status.iola) defaults.push("3");
-  if (!status.archive) defaults.push("8");
+  if (!status.archive) defaults.push("10");
   return defaults.length ? defaults : ["1", "2"];
 }
 
 function defaultOnboardComponents(status) {
-  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "openai", 5: "openrouter", 6: "codex", 7: "codex-mcp", 8: "archive", 9: "index", 10: "browser", 11: "ollama" };
+  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "yandexgpt", 5: "gigachat", 6: "openai", 7: "openrouter", 8: "codex", 9: "codex-mcp", 10: "archive", 11: "index", 12: "browser", 13: "ollama" };
   return defaultOnboardSelection(status).map((item) => map[item]).filter(Boolean);
 }
 
@@ -10854,6 +11261,9 @@ function sanitizeConfig(config) {
     if (profile?.provider === "openai" || profile?.provider === "openrouter") {
       profile.networkMode = profile.networkMode || "gateway";
     }
+    if (profile?.provider === "yandexgpt" || profile?.provider === "gigachat") {
+      profile.networkMode = profile.networkMode || "direct";
+    }
   }
   return next;
 }
@@ -10866,7 +11276,7 @@ function validateConfig(config) {
   if (!config.ai?.profiles || typeof config.ai.profiles !== "object") errors.push("ai.profiles обязателен");
   if (config.ai?.activeProfile && !config.ai.profiles?.[config.ai.activeProfile]) errors.push(`ai.activeProfile не найден в profiles: ${config.ai.activeProfile}`);
   for (const [name, profile] of Object.entries(config.ai?.profiles || {})) {
-    if (!["iola", "ollama", "openai", "openrouter", "codex"].includes(profile.provider)) errors.push(`ai.profiles.${name}.provider неизвестен`);
+    if (!["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"].includes(profile.provider)) errors.push(`ai.profiles.${name}.provider неизвестен`);
     if (profile.provider !== "codex" && profile.provider !== "iola" && !profile.baseUrl) errors.push(`ai.profiles.${name}.baseUrl обязателен`);
     if (profile.networkMode && !["direct", "gateway", "auto"].includes(profile.networkMode)) errors.push(`ai.profiles.${name}.networkMode должен быть direct, gateway или auto`);
   }
@@ -10885,7 +11295,7 @@ function configSchema() {
     required: ["api", "ai"],
     properties: {
       api: { required: ["baseUrl", "mcpBaseUrl"] },
-      ai: { required: ["activeProfile", "profiles"], providers: ["iola", "ollama", "openai", "openrouter", "codex"] },
+      ai: { required: ["activeProfile", "profiles"], providers: ["iola", "ollama", "yandexgpt", "gigachat", "openai", "openrouter", "codex"] },
       permissions: { localTools: ALL_LOCAL_TOOLS, runtime: ["readFiles", "writeFiles", "editFiles", "deleteFiles", "sync", "externalApi", "externalAi", "codex"] },
       toolsets: { available: Object.keys(TOOLSETS) },
       files: { modes: ["locked", "read-only", "workspace-write", "full-access"], approvals: ["never", "on-write", "on-danger", "always"] },

package/test/smoke-test.js

@@ -84,4 +84,18 @@ if (deletePlan.willKeep.includes("npm package files")) {
   throw new Error("delete dry-run should not keep npm package files");
 }
 
+const multiSchoolAnswer = await runCli(["ask", "Кто директор школы № 2 и адрес школы № 7?", "--profile", "yandexgpt", "--no-history"]);
+assertIncludes(multiSchoolAnswer, "Адамова Наталья Васильевна", "multi school answer");
+assertIncludes(multiSchoolAnswer, "улица Первомайская, дом 89", "multi school answer");
+assertNotIncludes(multiSchoolAnswer, "улица Осипенко, дом 46\nИсточник: слой schools, МБОУ \"Средняя общеобразовательная школа № 7", "multi school answer");
+
+const externalTownAnswer = await runCli(["ask", "Адрес школы № 1 Козьмодемьянска", "--profile", "yandexgpt", "--no-history"]);
+assertIncludes(externalTownAnswer, "Данных по Козьмодемьянске", "external town answer");
+assertNotIncludes(externalTownAnswer, "улица Петрова, дом 15", "external town answer");
+
+const semenovkaAnswer = await runCli(["ask", "Адрес школы № 1 Семеновки", "--profile", "yandexgpt", "--no-history"]);
+assertIncludes(semenovkaAnswer, "Точную школу № 1 в Семёновке", "semenovka answer");
+assertIncludes(semenovkaAnswer, "село Семёновка", "semenovka answer");
+assertNotIncludes(semenovkaAnswer, "улица Петрова, дом 15", "semenovka answer");
+
 console.log("smoke tests passed");

package/wiki/AI-/320/277/321/200/320/276/321/204/320/270/320/273/320/270.md

@@ -18,22 +18,181 @@ iola ask "найди школы на Петрова"
 
 Если выбранная Ollama-модель еще не установлена, CLI предложит скачать ее через `ollama pull`. При выборе сторонней Ollama-модели профиль `local` сохраняется как `provider: ollama`; при выборе штатной модели IOLA профиль `local` возвращается к `provider: iola`.
 
+## Российские AI
+
+Российские провайдеры вынесены в отдельный блок `/model` и вызываются напрямую, без gateway/proxy:
+
+```text
+/model
+2. Российские AI (YandexGPT/GigaChat)
+```
+
+### YandexGPT
+
+Для CLI нужны две вещи: API key и ID каталога Yandex Cloud.
+
+Пошаговая настройка:
+
+1. Откройте консоль Yandex Cloud: `https://console.yandex.cloud/`.
+2. Войдите в аккаунт Яндекса.
+3. Если Yandex Cloud попросит создать облако, создайте облако. Название может быть любым, например `iola-cli`.
+4. Откройте каталог внутри облака. Если каталога нет, создайте каталог. Название может быть любым, например `default`.
+5. На верхней панели страницы каталога найдите название каталога и его идентификатор. В нашем примере рядом с `default` был показан ID вида `b1g8...`.
+6. Нажмите кнопку `Копировать` рядом с идентификатором каталога. Это значение будет `YANDEXGPT_FOLDER_ID`.
+7. В левом меню или через поиск сервисов откройте `Identity and Access Management`.
+8. Внутри `Identity and Access Management` откройте раздел `Сервисные аккаунты`.
+9. Нажмите `Создать сервисный аккаунт`.
+10. В поле `Имя` введите понятное имя, например `iola-cli`.
+11. В поле `Описание` можно написать `API-доступ iola-cli к YandexGPT`.
+12. В блоке `Роли в каталоге` нажмите `Добавить роль`.
+13. В поле поиска роли введите `ai.languageModels.user`.
+14. В найденной группе `ai.languageModels` выберите роль `user`. В форме должна появиться роль `ai.languageModels.user`.
+15. Нажмите `Создать`.
+16. После создания откройте созданный сервисный аккаунт `iola-cli`.
+17. На странице сервисного аккаунта нажмите кнопку `Создать новый ключ`.
+18. В выпадающем меню выберите `Создать API-ключ`. Не выбирайте `Создать статический ключ доступа` и не выбирайте `Создать авторизованный ключ`.
+19. В поле `Описание` напишите, например, `iola-cli YandexGPT API key`.
+20. В поле `Область действия` выберите `yc.ai.foundationModels.execute`. Если список пустой, начните вводить это значение в поле фильтра и выберите найденный вариант.
+21. Поле `Срок действия` можно оставить пустым или выбрать дату окончания действия ключа по вашей политике безопасности.
+22. Нажмите `Создать`.
+23. Yandex Cloud покажет `Идентификатор ключа` и `Ваш секретный ключ`. Секретный ключ показывается только один раз.
+24. Скопируйте `Ваш секретный ключ` и сохраните его локально. Это значение будет `YANDEXGPT_API_KEY`.
+25. Сохраните ключ в CLI:
+
+```bash
+iola ai key set yandexgpt
+```
+
+CLI попросит ввести:
+
+- `YANDEXGPT_API_KEY` - API-ключ сервисного аккаунта;
+- `YANDEXGPT_FOLDER_ID` - ID каталога Yandex Cloud.
+
+Важно: `Идентификатор ключа` - это не API-ключ для CLI. Для CLI нужен именно `Ваш секретный ключ`. Если закрыть окно создания ключа, секретный ключ больше нельзя посмотреть. В этом случае удалите старый API-ключ и создайте новый.
+
+После сохранения ключа выберите профиль и модель:
+
+```bash
+iola ai setup yandexgpt --model yandexgpt-lite/latest
+```
+
+Через интерактивное меню:
+
+```text
+/model
+2. Российские AI (YandexGPT/GigaChat)
+1. YandexGPT API
+```
+
+Доступные модели в CLI:
+
+- `yandexgpt-lite/latest` - быстрый и более дешевый вариант;
+- `yandexgpt/latest` - YandexGPT Pro latest;
+- `yandexgpt/rc` - release candidate.
+
+CLI также понимает env-переменные `YANDEXGPT_API_KEY` или `YANDEX_CLOUD_API_KEY`, а для каталога - `YANDEXGPT_FOLDER_ID` или `YANDEX_CLOUD_FOLDER_ID`.
+
+### GigaChat
+
+Для CLI нужен authorization key. Это не одноразовый OAuth access token: CLI сам получает OAuth-токен перед запросом, используя сохраненный authorization key.
+
+Пошаговая настройка:
+
+1. Перейдите на портал разработчиков Сбера: `https://developers.sber.ru/`.
+2. Войдите в аккаунт.
+3. Откройте раздел GigaChat.
+4. Если нужно, подключите доступ к GigaChat API для физического лица или организации.
+5. Откройте кабинет/проект, в котором доступны учетные данные GigaChat API.
+6. Найдите authorization key для REST API. В документации GigaChat он используется в OAuth-запросе в заголовке `Authorization: Basic ...`.
+7. Скопируйте authorization key и сохраните его локально в CLI:
+
+```bash
+iola ai key set gigachat
+```
+
+CLI попросит ввести:
+
+- `GIGACHAT_AUTH_KEY` - authorization key;
+- `scope` - по умолчанию `GIGACHAT_API_PERS` для персонального доступа.
+
+После сохранения ключа выберите профиль и модель:
+
+```bash
+iola ai setup gigachat --model GigaChat-2
+```
+
+Через интерактивное меню:
+
+```text
+/model
+2. Российские AI (YandexGPT/GigaChat)
+2. GigaChat API
+```
+
+Доступные модели в CLI:
+
+- `GigaChat-2` - основная модель;
+- `GigaChat-2-Pro` - повышенное качество;
+- `GigaChat-2-Max` - максимальное качество;
+- `GigaChat` - legacy/fallback.
+
+CLI также понимает env-переменные `GIGACHAT_AUTH_KEY` или `GIGACHAT_API_KEY`. По умолчанию используется scope `GIGACHAT_API_PERS`; при необходимости его можно задать через `GIGACHAT_SCOPE`.
+
+По тарифам: у GigaChat для физических лиц есть Freemium-лимит на токены; для больших объемов используются платные пакеты. У YandexGPT тарификация идет через Yandex Cloud по токенам и квотам аккаунта, поэтому актуальные бесплатные гранты или лимиты нужно проверять в консоли Yandex Cloud.
+
+Официальная документация:
+
+- Yandex Foundation Models: `https://yandex.cloud/ru/docs/foundation-models/`;
+- Yandex AI Studio authentication: `https://yandex.cloud/ru/docs/ai-studio/api-ref/authentication`;
+- Yandex Foundation Models pricing: `https://yandex.cloud/ru/docs/foundation-models/pricing`;
+- GigaChat overview: `https://developers.sber.ru/docs/ru/gigachat/overview`;
+- GigaChat OAuth token: `https://developers.sber.ru/docs/ru/gigachat/api/reference/rest/post-token`;
+- GigaChat tariffs: `https://developers.sber.ru/docs/ru/gigachat/tariffs`.
+
 ## OpenAI
 
+Получение ключа OpenAI Platform:
+
+1. Зарегистрируйтесь или войдите в OpenAI Platform: `https://platform.openai.com/`.
+2. Откройте страницу API-ключей: `https://platform.openai.com/api-keys`.
+3. Выберите нужный project или создайте новый project.
+4. Нажмите `Create new secret key`.
+5. Скопируйте ключ сразу после создания. Повторно посмотреть полный ключ обычно нельзя.
+6. В CLI сохраните ключ:
+
 ```bash
 iola ai key set openai
 iola ai setup openai --model gpt-4.1-mini
 iola ask "найди школу 29" --profile openai
 ```
 
+Важно: OpenAI API Platform и ChatGPT Plus/Pro - разные продукты. Подписка ChatGPT не заменяет API-биллинг. Для работы API обычно нужно отдельно настроить billing в OpenAI Platform.
+
 ## OpenRouter
 
+Получение ключа OpenRouter:
+
+1. Зарегистрируйтесь или войдите в OpenRouter: `https://openrouter.ai/`.
+2. Откройте страницу ключей: `https://openrouter.ai/settings/keys`.
+3. Нажмите создание нового API key.
+4. Задайте имя ключа и при необходимости лимит расходов.
+5. Скопируйте ключ сразу после создания. Храните его как секрет.
+6. В CLI сохраните ключ:
+
 ```bash
 iola ai key set openrouter
 iola ai setup openrouter --model openai/gpt-4.1-mini
 iola ai models openrouter --search qwen
 ```
 
+OpenRouter удобен тем, что через один ключ можно выбирать модели разных разработчиков: OpenAI, Anthropic, Google, Qwen / Alibaba, DeepSeek, Meta / Llama, Mistral AI и других.
+
+## Оплата
+
+Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Перед настройкой платных API заранее проверьте доступный способ оплаты и пополнения баланса в личном кабинете выбранного сервиса.
+
+Ключи YandexGPT, GigaChat, OpenAI и OpenRouter сохраняются локально на устройстве пользователя в `~/.iola/secrets.json`. CLI не публикует ключи в репозиторий и не записывает их в документацию.
+
 В интерактивном CLI модели удобнее выбирать через slash-команду:
 
 ```text
@@ -64,4 +223,4 @@ iola ai profile use local
 iola ai profile use openrouter
 ```
 
-В интерактивном агенте можно использовать `/model`, чтобы выбрать подключение и модель без ручного ввода id модели.
+В интерактивном агенте можно использовать `/model`, чтобы выбрать подключение и модель без ручного ввода id модели. Порядок меню: локальные модели, российские AI, зарубежные API, Codex CLI.

package/wiki/Home.md

@@ -10,7 +10,7 @@
 - проверка качества данных;
 - выгрузка CSV/JSON;
 - работа с локальной моделью Ollama;
-- работа с OpenAI, OpenRouter и Codex CLI;
+- работа с YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - подключение публичного MCP-сервера.
 
 Быстрый старт:

package/wiki//320/234/320/260/321/201/321/202/320/265/321/200-/320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270.md

@@ -30,33 +30,45 @@ iola master
 
 После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.
 
-### 4. OpenAI API
+### 4. YandexGPT API
+
+Настраивает профиль YandexGPT и сохраняет API key плюс folder ID локально у пользователя.
+
+Российский провайдер вызывается напрямую, без gateway/proxy.
+
+### 5. GigaChat API
+
+Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.
+
+Российский провайдер вызывается напрямую, без gateway/proxy.
+
+### 6. OpenAI API
 
 Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать модель из доступного списка.
 
-### 5. OpenRouter API
+### 7. OpenRouter API
 
 Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.
 
-### 6. Codex CLI
+### 8. Codex CLI
 
 Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
 
-### 7. MCP для Codex
+### 9. MCP для Codex
 
 Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.
 
-### 8. 7-Zip / архивы
+### 10. 7-Zip / архивы
 
 Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
 
 Нужен для чтения, распаковки, сборки и индексирования архивов.
 
-### 9. Индекс локальных документов
+### 11. Индекс локальных документов
 
 Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
 
@@ -64,10 +76,14 @@ iola master
 iola index folder ./docs
 ```
 
-### 10. Browser runtime
+### 12. Browser runtime
 
 Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.
 
+### 13. Ollama
+
+Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.
+
 Если runtime уже установлен, пункт показывается как `готово`.
 
 ## Повторный запуск

package/wiki//320/240/320/265/321/210/320/265/320/275/320/270/320/265-/320/277/321/200/320/276/320/261/320/273/320/265/320/274.md

@@ -24,14 +24,27 @@ ollama serve
 iola ai doctor
 ```
 
-## OpenAI/OpenRouter key не найден
+## YandexGPT/GigaChat/OpenAI/OpenRouter key не найден
 
 ```bash
 iola ai key status
+iola ai key set yandexgpt
+iola ai key set gigachat
 iola ai key set openai
 iola ai key set openrouter
 ```
 
+Где получить ключ:
+
+- YandexGPT: `https://yandex.cloud/ru/docs/ai-studio/api-ref/authentication`
+- GigaChat: `https://developers.sber.ru/docs/ru/gigachat/overview`
+- OpenAI Platform: `https://platform.openai.com/api-keys`
+- OpenRouter: `https://openrouter.ai/settings/keys`
+
+Для YandexGPT нужен не только API key, но и folder ID каталога Yandex Cloud. Для GigaChat нужен authorization key; CLI сам получает OAuth-токен перед запросом.
+
+Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Если API-запросы не проходят после сохранения ключа, проверьте не только ключ, но и billing/баланс в личном кабинете сервиса.
+
 ## Нет локальных данных
 
 ```bash