@retensy/mcp 0.11.0 → 0.12.1

package/skills/build-bot-funnel/reference/validation.md

@@ -1,6 +1,6 @@
 # Правила валидатора (GraphValidator) — чтобы граф публиковался
 
-Источник истины: `retensyBackend/.../service/bot/GraphValidator.java`. При `publish` бэкенд возвращает `errors: [{ nodeId, code, message }]`. Ниже — что проверяется и как не нарваться.
+Источник истины: `retensyBackend/.../service/bot/GraphValidator.java`. При `publish` и при PUT **активного** графа бэкенд отвечает `HTTP 422` с `errors: [{ nodeId, code, message }]` — MCP показывает их все построчно (`code@nodeId: message`). Черновик PUT сохраняет без проверок. Ниже — что проверяется и как не нарваться.
 
 ## Коды ошибок и условия
 
@@ -41,8 +41,28 @@
 - `FORMULA`: `expression` непустой (`FORMULA_NO_EXPRESSION`); `saveTo` ∈ var-формат (`FORMULA_BAD_SAVE_TO`).
 - `SCHEDULE`: `isoDate` = валидная `YYYY-MM-DD` (`SCHEDULE_BAD_DATE`); `time` = `HH:mm` (`SCHEDULE_BAD_TIME`).
 - `ACTIONS`: непустой `actions[]` (`ACTIONS_EMPTY`); каждый `kind` — из допустимого списка (`ACTION_UNKNOWN_KIND`, список — в schema.md); per-kind: `tag` (`ACTION_BAD_TAG`), `set_field.key` (`ACTION_BAD_KEY`), `url` у `external_request`/`subscriber_webhook` (`ACTION_BAD_URL`).
-- `AI_REPLY`: `userPromptTemplate` непустой (`AI_NO_PROMPT`); `temperature` ∈ [0.0, 2.0] (`AI_BAD_TEMPERATURE`); нужен `sendToUser:true` ИЛИ `saveTo` (`AI_NO_OUTPUT`).
+- `ACTIONS` с действием `issue_invoice` (счёт на кассу владельца):
+  - `connectionId` обязателен (`YK_NO_CONNECTION`) — подключение с `provider=YOOKASSA` из `list_integrations`;
+  - `amount` обязателен (`YK_NO_AMOUNT`), число > 0 или шаблон `{{var.x}}` (`YK_BAD_AMOUNT`);
+  - `description` обязателен (`YK_NO_DESC`);
+  - `timeoutMinutes` ∈ [1, 1440] (`YK_BAD_TIMEOUT`);
+  - **счёт должен быть ПОСЛЕДНИМ действием в блоке** (`INVOICE_NOT_LAST`) и только один (`INVOICE_DUPLICATE`).
+    Причина: при наличии ветки `paid` блок встаёт на паузу до вебхука кассы, а возобновиться
+    с середины списка движок не умеет — действия после счёта молча не выполнились бы.
+- `AI_REPLY` (`mode` не задан или `"simple"`): `userPromptTemplate` непустой (`AI_NO_PROMPT`); `temperature` ∈ [0.0, 2.0] (`AI_BAD_TEMPERATURE`); нужен `sendToUser:true` ИЛИ `saveTo` (`AI_NO_OUTPUT`).
+- `AI_REPLY` (`mode: "agent"`) — отдельный набор проверок, старые (`AI_NO_PROMPT` и т.п.) не применяются:
+  - `strict` (по умолчанию `true`) без `knowledgeBaseId` → `AGENT_NO_KNOWLEDGE_BASE` (в строгом режиме без базы агент ответит «не знаю» на всё).
+  - `actions[]`: битая запись (пустой `id` ИЛИ `title`) пропускается целиком, как и в рантайме — на неё не ругаемся. Повтор `id` → `AGENT_DUPLICATE_ACTION_ID`. Нет ребра `action_<id>` → `AGENT_ACTION_NOT_CONNECTED`.
+  - `systemPrompt` длиннее **30 000** символов → ошибка `AGENT_PROMPT_TOO_LONG` (публикация не пройдёт). Длиннее **10 000** — только предупреждение (мягкая норма: длинная инструкция дороже и хуже держится моделью в середине; жёсткого кода для неё у бэкенда нет — в вебе это красит счётчик символов в инспекторе).
+  - `extract[]`: `variable` обязателен и матчит `[a-z_][a-z0-9_]{0,63}` (тот же `VAR_RE`), `description` непустой, имя `ai_summary` зарезервировано под сводку агента, повтор имени внутри `extract[]` — тоже ошибка. Любая из этих проблем → `AGENT_BAD_EXTRACT`.
+  - Ветка `unknown` не подключена (и узел достижим от триггера) → `AGENT_UNKNOWN_NOT_CONNECTED`, приходит уровнем `warnings` (не блокирует публикацию — специально мягкий уровень, спека §10): диалог агента упрётся в тупик там, где нужен человек.
 - `PAYMENT_LINK`: `paymentUrl` обязателен (`PAY_NO_URL`), http(s):// или `{{var.x}}` (`PAY_BAD_SCHEME`).
+- `YOOKASSA_PAYMENT`: **устаревший узел, в новых сценариях не ставить** — счёт собирается действием
+  `issue_invoice` внутри `ACTIONS`. Если узел всё же есть: `connectionId` (`YK_NO_CONNECTION`),
+  `amount` (`YK_NO_AMOUNT`/`YK_BAD_AMOUNT`), `description` (`YK_NO_DESC`).
+- `TRIGGER_PAYMENT`: обязательных полей нет. Фильтры `minAmount`/`descriptionContains`
+  необязательны, но **без них сценарий стартует на КАЖДУЮ оплату в кассе**, включая продажи
+  мимо бота. Валидатор это не блокирует (бэкенд тоже) — следи сам.
 - Метки: `[a-z0-9_-]{1,64}`. Переменные: `[a-z_][a-z0-9_]{0,63}`.
 
 ## Рёбра
@@ -53,11 +73,12 @@
 
 ## Жизненный цикл
 - Статусы графа: `DRAFT` / `PUBLISHED`. Публикация заменяет активную опубликованную версию.
+- Правка активного (`PUBLISHED`) графа применяется к боту сразу и проверяется как публикация (плюс платные блоки и лимит блоков тарифа): ошибки → 422, граф не сохранён. `DRAFT` — черновик: PUT сохраняет его без проверок, на бота он не влияет. `publish_graph` черновика копирует его в отдельный `PUBLISHED`-граф (`publishedGraphId`), черновик остаётся `DRAFT` — живые правки делай по `publishedGraphId` (в `list_graphs` у него `isActive: true`).
 - Перед публикацией полезно прогнать `dry_run` (kind `command`/`callback`/`text`) — поймать рантайм-проблемы стартовой ветки.
 
 ## Платформенные правила — Instagram
 
-Источник: `GraphValidator.platformErrors()` (Java). Коды — жёсткие ошибки, **блокируют публикацию** (`publish_graph` вернёт `errors[]`).
+Источник: `GraphValidator.platformErrors()` (Java). Коды — жёсткие ошибки, **блокируют публикацию** (`publish_graph` вернёт ошибку `HTTP 422` со всеми `code@nodeId`).
 
 ### `IG_NODE_UNSUPPORTED` — неподдерживаемый тип узла
 
@@ -98,7 +119,7 @@ Instagram доставляет сообщения только в течение
 ---
 
 ## Локальная проверка
-`node validate.mjs <import.json>` повторяет ключевые проверки: пустые сообщения с учётом `cardsToLegacy`, висячие рёбра, дубли id, достижимость от триггеров, длину текста, HTML-безопасность (эвристика по тегам), режим «Вопрос» (`awaitReply`→`saveTo`/`regex`), конфиг `DELAY`/`SCHEDULE`/`FORMULA`/`ACTIONS`/`AI_REPLY`/`PAYMENT_LINK`/триггеров, условия `CONDITION` (вкл. `LINK_CLICKED` со ссылкой на отслеживаемый шаг). Гонять перед каждой заливкой.
+`node validate.mjs <import.json>` повторяет ключевые проверки: пустые сообщения с учётом `cardsToLegacy`, висячие рёбра, дубли id, достижимость от триггеров, длину текста, HTML-безопасность (эвристика по тегам), режим «Вопрос» (`awaitReply`→`saveTo`/`regex`), конфиг `DELAY`/`SCHEDULE`/`FORMULA`/`ACTIONS`/`AI_REPLY`(оба режима, включая `AGENT_*`)/`PAYMENT_LINK`/триггеров, условия `CONDITION` (вкл. `LINK_CLICKED` со ссылкой на отслеживаемый шаг). Гонять перед каждой заливкой.
 
 Для IG-ботов передавать `--platform=INSTAGRAM`:
 ```bash

package/skills/build-bot-funnel/validate.mjs

@@ -32,6 +32,15 @@ const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
 const VAR_RE = /^[a-z_][a-z0-9_]{0,63}$/;
 const TAG_RE = /^[a-z0-9_-]{1,64}$/;
 
+// Зеркало boolConfig/Boolean.parseBoolean бэкенда: булево — как есть; иначе строка "true"
+// (без учёта регистра) → true, ЛЮБАЯ другая строка (включая "false") → false, null/undefined → def.
+// Задача 12, фикс-раунд 1, MINOR: `v !== false` расходился с бэком на строке "false".
+function boolConfig(v, def) {
+  if (typeof v === "boolean") return v;
+  if (v == null) return def;
+  return String(v).toLowerCase() === "true";
+}
+
 // kind -> допустимые op (для подсказок; бэкенд блокирует только TAG/VARIABLE)
 const COND_OPS = {
   TAG: ["HAS", "NOT_HAS"],
@@ -53,7 +62,7 @@ const ACTION_KINDS = new Set([
   "add_tag", "remove_tag", "set_field", "stop_bot", "delete_step_message",
   "subscribe", "unsubscribe", "autoflow_add", "autoflow_remove",
   "subscriber_webhook", "external_request", "notify",
-  "subscriber_email", "agent_chat", "cancel_payment_subscription",
+  "subscriber_email", "agent_chat", "cancel_payment_subscription", "issue_invoice",
   "getcourse_send", "getcourse_order", "amocrm_send", "amocrm_update",
   "yametrika_event", "gsheets_send", "gsheets_get", "gsheets_update",
   "gsheets_write_cell", "gsheets_read_cell",
@@ -175,6 +184,31 @@ for (const n of nodes) {
     case "TRIGGER_TEXT":
       if (c.matchMode && c.matchMode !== "ANY" && blank(c.value)) errors.push(`${who}: для matchMode≠ANY нужен value.`);
       break;
+    case "TRIGGER_TG_EVENT": {
+      // Рантайм размечает только эти апдейты (FlowExecutor.buildContext) — на остальных
+      // триггер молчит, а выглядит настроенным.
+      const LIVE = new Set(["message", "edited_message", "callback_query", "channel_post",
+        "edited_channel_post", "chat_member", "chat_join_request", "my_chat_member",
+        "message_reaction", "message_reaction_count", "chat_boost", "removed_chat_boost",
+        "poll", "poll_answer", "inline_query", "chosen_inline_result", "shipping_query",
+        "pre_checkout_query"]);
+      const DEAD = new Set(["business_connection", "business_message", "edited_business_message",
+        "deleted_business_messages", "chat_shared", "users_shared", "write_access_allowed",
+        "purchased_paid_media"]);
+      const ev = String(c.event || "");
+      if (blank(ev)) errors.push(`TG_EVENT_NO_EVENT: ${who} — нужен event (напр. chat_member, message_reaction).`);
+      else if (DEAD.has(ev)) errors.push(`TG_EVENT_UNSUPPORTED: ${who} — событие «${ev}» рантайм не разбирает, триггер не сработает.`);
+      else if (!LIVE.has(ev)) warns.push(`${who}: событие «${ev}» не из списка поддержанных — проверь, что рантайм его размечает.`);
+      // Фильтр по тексту есть только у событий с текстом сообщения.
+      const TEXTY = new Set(["message", "edited_message", "channel_post", "edited_channel_post"]);
+      const f = c.filter && typeof c.filter === "object" ? c.filter : {};
+      if (!blank(f.text) && !TEXTY.has(ev)) warns.push(`${who}: фильтр по тексту у события «${ev}» игнорируется — текста в апдейте нет.`);
+      if (!blank(f.status) && ev !== "chat_member" && ev !== "my_chat_member") warns.push(`${who}: фильтр по статусу работает только у chat_member/my_chat_member.`);
+      break;
+    }
+    case "TRIGGER_COMMENT":
+      errors.push(`TRIGGER_COMMENT_DEAD: ${who} — этот тип триггера не сработает никогда (рантайм не выставляет event=comment). Для Instagram используй TRIGGER_IG_COMMENT.`);
+      break;
     case "ASK_QUESTION":
       if (blank(c.promptText)) errors.push(`${who}: нужен promptText.`);
       if (c.saveTo && !VAR_RE.test(c.saveTo)) errors.push(`${who}: saveTo «${c.saveTo}» не матчит [a-z_][a-z0-9_]{0,63}.`);
@@ -191,6 +225,27 @@ for (const n of nodes) {
     case "BRANCH":
       if (!Array.isArray(c.cases) || c.cases.length === 0) errors.push(`${who}: нужен хотя бы один case.`);
       break;
+    case "SWITCH": {
+      // Зеркало GraphValidator.validateSwitch(): развилка по значению (спека §5.3).
+      if (blank(c.expression)) errors.push(`SWITCH_NO_EXPRESSION: ${who} — нужно expression (обычно {{var.x}}).`);
+      if (!Array.isArray(c.cases) || c.cases.length === 0) {
+        errors.push(`SWITCH_NO_CASES: ${who} — нужен хотя бы один case {id, value}.`);
+        break;
+      }
+      const seenValues = new Set();
+      for (const cs of c.cases) {
+        const value = String((cs && cs.value) ?? "").trim();
+        if (!value) errors.push(`SWITCH_EMPTY_VALUE: ${who} — у случая «${cs && cs.id}» пустое value.`);
+        // Рантайм сравнивает без учёта регистра → второй такой случай недостижим.
+        else if (seenValues.has(value.toLowerCase())) errors.push(`SWITCH_DUPLICATE_VALUE: ${who} — значение «${value}» повторяется.`);
+        else seenValues.add(value.toLowerCase());
+      }
+      break;
+    }
+    case "STOP_AND_ERROR":
+      // message необязателен (рантайм подставит свой текст), но безымянная ошибка в журнале бесполезна.
+      if (blank(c.message)) warns.push(`${who}: STOP_AND_ERROR без message — в журнале будет обезличенное «Сценарий остановлен с ошибкой».`);
+      break;
     case "CONDITION": {
       if (c.match !== "ALL" && c.match !== "ANY") errors.push(`CONDITION_BAD_MATCH: ${who} — match ∈ {ALL,ANY}.`);
       if (!Array.isArray(c.conditions) || c.conditions.length === 0) {
@@ -235,6 +290,17 @@ for (const n of nodes) {
     }
     case "ACTIONS": {
       if (!Array.isArray(c.actions) || c.actions.length === 0) { errors.push(`ACTIONS_EMPTY: ${who} — нужен непустой actions[].`); break; }
+      // Счёт ставит блок на паузу до вебхука кассы, а возобновиться с середины списка движок
+      // не умеет — значит действия после счёта молча не выполнятся. Зеркало GraphValidator.
+      {
+        const invIdx = c.actions.map((a, i) => (a && a.kind === "issue_invoice" ? i : -1)).filter((i) => i >= 0);
+        if (invIdx.length > 1) {
+          errors.push(`INVOICE_DUPLICATE: ${who} — в блоке больше одного счёта, непонятно какой ждать.`);
+        }
+        if (invIdx.length === 1 && invIdx[0] !== c.actions.length - 1) {
+          errors.push(`INVOICE_NOT_LAST: ${who} — счёт должен быть последним действием в блоке: после него блок ждёт оплату.`);
+        }
+      }
       c.actions.forEach((a, i) => {
         if (!a || typeof a !== "object") { errors.push(`${who}: действие #${i + 1} — не объект.`); return; }
         if (!ACTION_KINDS.has(a.kind)) { errors.push(`ACTION_UNKNOWN_KIND: ${who} — неизвестный kind «${a.kind}» (#${i + 1}).`); return; }
@@ -244,15 +310,106 @@ for (const n of nodes) {
           errors.push(`ACTION_BAD_KEY: ${who} — set_field.key ∈ [a-z_][a-z0-9_]{0,63}.`);
         if (["subscriber_webhook", "external_request"].includes(a.kind) && !isHttp(a.url))
           errors.push(`ACTION_BAD_URL: ${who} — ${a.kind}.url должен быть http(s)://.`);
+        if (a.kind === "issue_invoice") {
+          if (blank(a.connectionId)) errors.push(`YK_NO_CONNECTION: ${who} — нужен connectionId подключения ЮKassa (list_integrations).`);
+          const amount = String(a.amount == null ? "" : a.amount);
+          if (blank(amount)) errors.push(`YK_NO_AMOUNT: ${who} — нужна amount.`);
+          else if (!amount.includes("{{")) {
+            const n = Number(amount.trim().replace(",", "."));
+            if (!Number.isFinite(n)) errors.push(`YK_BAD_AMOUNT: ${who} — amount должна быть числом.`);
+            else if (n <= 0) errors.push(`YK_BAD_AMOUNT: ${who} — amount должна быть > 0.`);
+          }
+          if (blank(a.description)) errors.push(`YK_NO_DESC: ${who} — нужно description (за что платят).`);
+          if (a.timeoutMinutes != null) {
+            const t = Number(a.timeoutMinutes);
+            if (!Number.isFinite(t) || t < 1 || t > 1440) errors.push(`YK_BAD_TIMEOUT: ${who} — timeoutMinutes ∈ [1, 1440].`);
+          }
+        }
+        if (a.kind === "external_request") {
+          // Имя переменной бэкенд не чистит: кривое имя запишется, а {{var.<имя>}} его не найдёт.
+          for (const field of ["saveStatusTo", "saveBodyTo"]) {
+            if (!blank(a[field]) && !VAR_RE.test(String(a[field])))
+              errors.push(`ACTION_BAD_SAVE_TO: ${who} — ${field} «${a[field]}» ∈ [a-z_][a-z0-9_]{0,63}.`);
+          }
+          (Array.isArray(a.extract) ? a.extract : []).forEach((ex, j) => {
+            if (blank(ex?.path) || blank(ex?.saveTo))
+              errors.push(`ACTION_BAD_EXTRACT: ${who} — извлечение #${j + 1} требует path и saveTo.`);
+            else if (!VAR_RE.test(String(ex.saveTo)))
+              errors.push(`ACTION_BAD_SAVE_TO: ${who} — extract[${j}].saveTo ∈ [a-z_][a-z0-9_]{0,63}.`);
+          });
+          if (a.timeoutMs != null && (Number(a.timeoutMs) < 500 || Number(a.timeoutMs) > 30000))
+            warns.push(`${who}: timeoutMs ${a.timeoutMs} будет прижат к диапазону 500…30000 мс.`);
+        }
         if (a.kind === "gsheets_send" && (!a.googleEmail || !a.spreadsheetId || !Array.isArray(a.cells) || a.cells.length === 0))
           errors.push(`ACTION_GSHEETS_INCOMPLETE: ${who} — gsheets_send требует googleEmail + spreadsheetId + непустой cells[] (Google-аккаунт подключается в вебе /bots, не через MCP).`);
       });
       break;
     }
     case "AI_REPLY": {
-      if (blank(c.userPromptTemplate)) errors.push(`AI_NO_PROMPT: ${who} — нужен userPromptTemplate.`);
-      if (typeof c.temperature === "number" && (c.temperature < 0 || c.temperature > 2)) errors.push(`AI_BAD_TEMPERATURE: ${who} — temperature ∈ [0.0, 2.0].`);
-      if (c.sendToUser !== true && blank(c.saveTo)) errors.push(`AI_NO_OUTPUT: ${who} — нужен sendToUser:true или saveTo.`);
+      if (String(c.mode) === "agent") {
+        // Режим агента — отдельный набор ключей конфига, старые проверки (userPromptTemplate
+        // и т.п.) к нему не относятся. Зеркало GraphValidator.validateAiAgent (Задача 12,
+        // CARRY): обязано ловить то же самое, что и бэкенд, и не быть строже него.
+        const outgoing = edges.filter((e) => e.sourceNodeId === n.id);
+        const strict = boolConfig(c.strict, true);
+        if (strict && blank(c.knowledgeBaseId)) {
+          errors.push(`AGENT_NO_KNOWLEDGE_BASE: ${who} — в строгом режиме без базы знаний агент ответит «не знаю» на всё.`);
+        }
+        if (Array.isArray(c.actions)) {
+          const seenIds = new Set();
+          for (const a of c.actions) {
+            if (!a) continue;
+            const id = a.id == null ? null : String(a.id);
+            const title = a.title == null ? null : String(a.title);
+            // Битую запись (пустой id ИЛИ title) рантайм пропускает целиком — ругаться на
+            // её ребро/дубль было бы ложной ошибкой (зеркало FlowExecutor.agentActions).
+            if (blank(id) || blank(title)) continue;
+            if (seenIds.has(id)) {
+              errors.push(`AGENT_DUPLICATE_ACTION_ID: ${who} — действие с id '${id}' повторяется — выбор модели станет недетерминированным.`);
+              continue;
+            }
+            seenIds.add(id);
+            if (!outgoing.some((e) => e.sourceHandle === `action_${id}`)) {
+              errors.push(`AGENT_ACTION_NOT_CONNECTED: ${who} — действие '${id}' не подключено к ветке — модель может его выбрать, а идти будет некуда.`);
+            }
+          }
+        }
+        const prompt = String(c.systemPrompt || "");
+        if (prompt.length > 30000) {
+          errors.push(`AGENT_PROMPT_TOO_LONG: ${who} — инструкция агента длиннее 30 000 символов.`);
+        } else if (prompt.length > 10000) {
+          // Мягкий порог — только warn: у MCP-сборщика нет инспектора, где владелец увидел бы
+          // это предупреждение живьём (веб-редактор красит счётчик символов сам).
+          warns.push(`${who}: инструкция агента длиннее 10 000 символов — модель хуже держит середину, и каждый ответ дороже.`);
+        }
+        if (Array.isArray(c.extract)) {
+          const seenVars = new Set();
+          for (const f of c.extract) {
+            // Зеркало GraphValidator:1070 (!(o instanceof Map) → continue): элемент не объектом
+            // (строка, число, массив) рантайм молча пропускает — публикация проходит; ругаться
+            // на него было бы строже бэка (M4, фикс-раунд 1).
+            if (!f || typeof f !== "object" || Array.isArray(f)) continue;
+            const variable = f.variable == null ? null : String(f.variable);
+            const description = f.description == null ? null : String(f.description);
+            const problems = [];
+            if (!variable || !VAR_RE.test(variable)) problems.push("имя переменной должно соответствовать [a-z_][a-z0-9_]{0,63}");
+            if (blank(description)) problems.push("описание не должно быть пустым");
+            if (variable === "ai_summary") problems.push("имя 'ai_summary' занято сводкой агента");
+            if (variable && seenVars.has(variable)) problems.push("имя переменной повторяется");
+            if (variable) seenVars.add(variable);
+            if (problems.length) {
+              errors.push(`AGENT_BAD_EXTRACT: ${who} — поле извлечения${variable ? ` '${variable}'` : ""}: ${problems.join("; ")}.`);
+            }
+          }
+        }
+        // Ветка "не знаю" не подключена — предупреждение, но только для узла, достижимого от
+        // триггера (зеркало GraphValidator.draftWarnings:394-402): `reach` считается позже общего
+        // per-node прохода, поэтому сама проверка — в отдельном проходе ниже.
+      } else {
+        if (blank(c.userPromptTemplate)) errors.push(`AI_NO_PROMPT: ${who} — нужен userPromptTemplate.`);
+        if (typeof c.temperature === "number" && (c.temperature < 0 || c.temperature > 2)) errors.push(`AI_BAD_TEMPERATURE: ${who} — temperature ∈ [0.0, 2.0].`);
+        if (c.sendToUser !== true && blank(c.saveTo)) errors.push(`AI_NO_OUTPUT: ${who} — нужен sendToUser:true или saveTo.`);
+      }
       break;
     }
     case "PAYMENT_LINK": {
@@ -261,6 +418,33 @@ for (const n of nodes) {
       else if (!isHttp(u) && !u.startsWith("{{")) errors.push(`PAY_BAD_SCHEME: ${who} — paymentUrl = http(s):// или {{var.x}}.`);
       break;
     }
+    case "YOOKASSA_PAYMENT": {
+      // Зеркало GraphValidator.validateYooKassaPayment(): без кассы платёж создать нечем,
+      // и раньше это вылезало только в рантайме — перед клиентом, на шаге оплаты.
+      if (blank(c.connectionId)) {
+        errors.push(`YK_NO_CONNECTION: ${who} — нужен connectionId подключения ЮKassa (list_integrations).`);
+      }
+      const amount = String(c.amount == null ? "" : c.amount);
+      if (blank(amount)) {
+        errors.push(`YK_NO_AMOUNT: ${who} — нужна amount.`);
+      } else if (!amount.includes("{{")) {
+        const n = Number(amount.trim().replace(",", "."));
+        if (!Number.isFinite(n)) errors.push(`YK_BAD_AMOUNT: ${who} — amount должна быть числом.`);
+        else if (n <= 0) errors.push(`YK_BAD_AMOUNT: ${who} — amount должна быть > 0.`);
+      }
+      if (blank(c.description)) errors.push(`YK_NO_DESC: ${who} — нужно description (за что платят).`);
+      if (c.timeoutMinutes != null) {
+        const t = Number(c.timeoutMinutes);
+        if (!Number.isFinite(t) || t < 1 || t > 1440) {
+          errors.push(`YK_BAD_TIMEOUT: ${who} — timeoutMinutes ∈ [1, 1440].`);
+        }
+      }
+      break;
+    }
+    // TRIGGER_PAYMENT намеренно без проверок: отсутствие фильтров (minAmount /
+    // descriptionContains) — рискованно, но для бэкенда это валидный граф. Ругаться здесь
+    // строже, чем GraphValidator, значит расходиться с сервером: сценарий падал бы у
+    // сборщика и публиковался бы вручную. Риск описан в schema.md.
   }
 }
 
@@ -275,6 +459,18 @@ for (const n of nodes) {
   if (!reach.has(n.id)) errors.push(`Недостижимый узел от триггера: «${n.config?._title || n.id}» (${n.type}).`);
 }
 
+// AI-агент: ветка "не знаю" не подключена — предупреждение, зеркало GraphValidator.draftWarnings
+// (394-402): только для узла, реально достижимого от триггера (`reach` посчитан только что выше).
+for (const n of nodes) {
+  const c = n.config || {};
+  if (n.type !== "AI_REPLY" || String(c.mode) !== "agent" || !reach.has(n.id)) continue;
+  const hasUnknownEdge = edges.some((e) => e.sourceNodeId === n.id && e.sourceHandle === "unknown");
+  if (!hasUnknownEdge) {
+    const who = `«${c._title || n.id}» (${n.type})`;
+    warns.push(`AGENT_UNKNOWN_NOT_CONNECTED: ${who} — ветка «не знаю» не подключена — диалог упрётся в тупик там, где нужен человек.`);
+  }
+}
+
 // --- синхронные циклы (цикл без DELAY/ASK_QUESTION/SCHEDULE = ошибка) ---
 const waitTypes = new Set(["ASK_QUESTION", "DELAY", "SCHEDULE"]);
 const typeById = Object.fromEntries(nodes.map((n) => [n.id, n.type]));
@@ -300,7 +496,8 @@ for (const n of nodes) if (!color[n.id]) dfs(n.id);
 // Зеркало GraphValidator.platformErrors() (Java).
 // IG_ALLOWED_NODES: TRIGGER_IG_COMMENT, TRIGGER_IG_DM, TRIGGER_IG_STORY_REPLY,
 //   TRIGGER_IG_STORY_MENTION, SEND_MESSAGE, SEND_PHOTO, BRANCH, CONDITION,
-//   SET_VARIABLE, ADD_TAG, REMOVE_TAG, FORMULA, ASK_QUESTION, DELAY, END.
+//   SET_VARIABLE, ADD_TAG, REMOVE_TAG, FORMULA, ASK_QUESTION, DELAY, END,
+//   SWITCH, STOP_AND_ERROR.
 // IG_ALLOWED_INPUT_KINDS: TEXT, EMAIL, PHONE, NUMBER, CONTACT (CONTACT деградирует в ручной ввод номера — кнопки в IG нет).
 // IG_MAX_DELAY_SECONDS: 86400 (24 часа).
 // ============================================================
@@ -313,6 +510,7 @@ if (platform === "INSTAGRAM") {
     "BRANCH", "CONDITION", "SET_VARIABLE",
     "ADD_TAG", "REMOVE_TAG", "FORMULA",
     "ASK_QUESTION", "DELAY", "END",
+    "SWITCH", "STOP_AND_ERROR",
   ]);
   const IG_ALLOWED_INPUT_KINDS = new Set(["TEXT", "EMAIL", "PHONE", "NUMBER", "CONTACT"]);
   const IG_MAX_DELAY_SEC = 86400; // 24h messaging window