@retensy/mcp 0.11.0 → 0.12.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "retensy-mcp",
   "displayName": "Retensy MCP",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "MCP-сервер + скилл для Retensy Bots: сборка и публикация воронок ботов (Telegram/MAX/Instagram) и публикация статей блога в Markdown — всё одним токеном zmcp_.",
   "author": { "name": "retensy", "url": "https://bots.retensy.com" },
   "homepage": "https://bots.retensy.com/bots",

package/README.md

@@ -19,7 +19,7 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 |---|---|---|---|
 | **Telegram** | Токен бота (BotFather) | `/start`, команды, callback, текст, рассылки | Полный функционал |
 | **MAX** | Токен бота (MAX Developer) | Команды, callback, текст | Без SUBSCRIBED/reply-клавиатур (мягкие предупреждения) |
-| **Instagram** | OAuth в `/growth` (без токена) | Комментарий/Direct/Ответ на историю/Упоминание | Ограниченный набор узлов; DELAY ≤ 24ч; ASK_QUESTION только TEXT/EMAIL/PHONE/NUMBER/CONTACT (CONTACT = ручной ввод номера); без рассылок |
+| **Instagram** | OAuth в `/bots/instagram` (без токена) | Комментарий/Direct/Ответ на историю/Упоминание | Ограниченный набор узлов; DELAY ≤ 24ч; ASK_QUESTION только TEXT/EMAIL/PHONE/NUMBER/CONTACT (CONTACT = ручной ввод номера); без рассылок |
 
 ---
 
@@ -43,7 +43,7 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
   "mcpServers": {
     "retensy-mcp": {
       "command": "npx",
-      "args": ["-y", "@retensy/mcp"],
+      "args": ["-y", "@retensy/mcp@latest"],
       "env": {
         "RETENSY_BASE_URL": "https://bots.retensy.com",
         "RETENSY_MCP_TOKEN": "zmcp_ваш_токен"
@@ -94,6 +94,7 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 | `list_bots` | список ботов |
 | `list_graphs(botId)` | графы (сценарии) бота |
 | `list_channels(botId)` | каналы/группы, подключённые к боту (chatId для условия SUBSCRIBED) |
+| `list_integrations()` | подключённые сервисы (amoCRM, Битрикс24, GetCourse, Я.Метрика): `id` = `connectionId` для действий сценария |
 | `get_graph(graphId, [summary], [saveToFile])` | получить граф; `summary:true` — компактная сводка (id/type/title + рёбра), `saveToFile` — записать полный JSON на диск (для больших графов, чтобы не упереться в лимит токенов) |
 | `create_graph(botId, name)` | создать пустой граф (DRAFT) |
 | `update_graph(graphId, graphFile\|graph\|nodes,edges)` | залить узлы/рёбра (PUT); `graphFile` — путь к локальному JSON, граф не нужно слать инлайном |
@@ -150,6 +151,54 @@ RETENSY_MCP_TOKEN=zmcp_... node src/index.mjs   # стартует stdio MCP-с
 
 Зависимостей нет — это голый JSON-RPC по stdio (протокол MCP `2024-11-05`).
 
+## Обновления
+
+При старте сервер сверяет свою версию с npm (результат кэшируется на 6 часов в
+`~/.retensy-bot-graph/update-check.json`). Если вышла новая — уведомление появится в `setup` и
+в первом ответе инструмента.
+
+- **Установка через npx** (вариант B): держите в конфиге `@retensy/mcp@latest` — тогда свежая
+  версия подтягивается при запуске. Если пакет установлен глобально, сервер сам запустит
+  `npm i -g @retensy/mcp@latest` в фоне (отключается `RETENSY_MCP_AUTOUPDATE=0`).
+- **Установка как плагин** (вариант A): обновляйте плагин/`git pull` — npm тут не при чём,
+  исполняется файл репозитория.
+
+Важно: запущенный процесс не может подменить собственный код — **обновление вступает в силу после
+перезапуска MCP-сервера**. Нет сети или npm недоступен — проверка молча пропускается, работа не ломается.
+
+## Отчёты о неудачах (телеметрия)
+
+Чтобы мы узнавали, каких возможностей не хватает, при неудаче инструмента отправляется **анонимный**
+отчёт: неизвестный инструмент, отказ публикации (`errors[]`), ошибка API.
+
+Отчёт уходит на **`POST {RETENSY_BASE_URL}/api/mcp/report`** — то есть на тот же сервер, с которым
+вы и так работаете. Адреса чата/вебхука, куда мы складываем отчёты, в пакете нет: он живёт в
+переменной окружения на сервере. Так его нельзя вытащить из пакета и залить, а мы можем сменить
+приёмник без выпуска новой версии.
+
+**Что уходит:** имя инструмента, категория неудачи, текст ошибки, ключи аргументов, версия, платформа
+и анонимный id установки (хэш от имени хоста и домашнего каталога — не сами значения).
+**Что НЕ уходит никогда:** токены, cookie, пароли, креды интеграций, содержимое графов и текстов
+рассылок. Значения аргументов по умолчанию скрыты — присылаются только безопасные поля вроде
+`graphId`/`botId`/`kind`.
+
+Если персональный токен настроен, он прикладывается к отчёту — тогда мы видим, у кого именно
+не хватило возможности, и можем ответить. Токен прикладывается **только** когда приёмник совпадает
+с `RETENSY_BASE_URL`: на сторонний `RETENSY_MCP_REPORT_URL` он не отправляется.
+
+| Переменная | Значение |
+|---|---|
+| `RETENSY_MCP_TELEMETRY=off` | полностью выключить отчёты |
+| `RETENSY_MCP_TELEMETRY=full` | присылать и значения аргументов (для отладки своей установки) |
+| `RETENSY_MCP_REPORT_URL=<url>` | свой приёмник (напр. локальный сервер), вместо `/api/mcp/report` |
+
+Отчёты дедуплицируются и ограничены 20 на запуск, отправка не блокирует ответ инструмента
+(таймаут 4 с) и при сбое сети молча игнорируется. На сервере — свои лимиты (30 в час с адреса,
+500 в час всего), так что отчёты нельзя использовать для заливки.
+
+Отдельно: если токен ещё не настроен вовсе, отчёт **не** отправляется — это обычное состояние
+нового пользователя, а не пробел в возможностях.
+
 ## Безопасность
 
 Токен = доступ к аккаунту по API. Не коммить его; держи в `env`. В конфигах храни ссылку `${RETENSY_MCP_TOKEN}`, не само значение.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retensy/mcp",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "MCP server to build and publish Telegram, MAX and Instagram bot funnels/automations — and publish Markdown blog articles — in the Retensy Bots service. Zero dependencies.",
   "type": "module",
   "bin": { "retensy-mcp": "src/index.mjs" },
@@ -10,7 +10,7 @@
   "scripts": {
     "start": "node src/index.mjs",
     "check": "node --check src/index.mjs",
-    "test": "node scripts/smoke.mjs",
+    "test": "node scripts/smoke.mjs && node scripts/telemetry.test.mjs && node scripts/live-edit-422.test.mjs",
     "validate": "node skills/build-bot-funnel/validate.mjs"
   },
   "engines": { "node": ">=18" },

package/skills/build-bot-funnel/SKILL.md

@@ -10,7 +10,7 @@ description: Собрать воронку (сценарий) бота для с
 **Различия платформ (кратко):**
 - **Telegram** — полный функционал: `/start` и другие команды, все типы узлов, SUBSCRIBED, кнопки-контакты, рассылки.
 - **MAX** — те же узлы, но без SUBSCRIBED/reply-клавиатур (мягкие предупреждения при публикации, не блокируют).
-- **Instagram** — ограниченный набор узлов; вход только через комментарий/директ/историю (нет `/start`); нет рассылок; DELAY не более 24ч; ASK_QUESTION только TEXT/EMAIL/PHONE/NUMBER/CONTACT (CONTACT = ручной ввод номера, кнопки «Поделиться номером» в IG нет); онбординг через OAuth в разделе «Инструменты роста» (/growth), без токена бота.
+- **Instagram** — ограниченный набор узлов; вход только через комментарий/директ/историю (нет `/start`); нет рассылок; DELAY не более 24ч; ASK_QUESTION только TEXT/EMAIL/PHONE/NUMBER/CONTACT (CONTACT = ручной ввод номера, кнопки «Поделиться номером» в IG нет); онбординг через OAuth на странице `/bots/instagram` («Подключения» → Instagram), без токена бота.
 
 ## Когда применять
 Пользователь описывает сценарий бота словами: приветствие → подписка → вопрос с кнопками → ветки → задержки → вебинар и т.п. Либо просит залить/опубликовать готовую воронку.
@@ -30,7 +30,15 @@ description: Собрать воронку (сценарий) бота для с
    - `SEND_MESSAGE` умеет быть и сообщением, и **вопросом** (`awaitReply:true` + `saveTo`/`inputKind`/`validator`). У кнопок-ссылок (`kind:"URL"`) есть флаг `track:true` — на такой шаг ссылается условие `LINK_CLICKED`.
    - **Медиа** (фото/видео/аудио/документ/кружок/галерея): загрузи файл инструментом `upload_file` (локальный `path` или `url` для перезаливки) → получишь публичный URL → вставь его в медиа-карточку `SEND_MESSAGE` (`url`, у `gallery` — `urls[]`) или в `SEND_PHOTO.photoUrl`. Уже загруженное — `list_files`. Бинарь в графе не хранится, только ссылки. Подробности — в schema.md.
    - `CONDITION` умеет: теги, переменные, UTM-метки, имя/email/телефон из профиля, @username, подписку на канал (`SUBSCRIBED`), клик по ссылке шага (`LINK_CLICKED`), дату/время/день недели. Полная таблица `kind`/`op` — в schema.md.
-   - Пакет `ACTIONS` — до 30 действий (метки, профиль, HTTP, уведомления, интеграции GetCourse/amoCRM/Google Sheets/Я.Метрика, модерация группы). Список — в schema.md.
+   - Пакет `ACTIONS` — до 30 действий (метки, профиль, HTTP, уведомления, интеграции GetCourse/amoCRM/Битрикс24/Google Sheets/Я.Метрика, приём оплат, модерация группы). Список — в schema.md. **Интеграции РАБОТАЮТ** (это не заглушки), но каждой нужен `connectionId` — возьми его через **`list_integrations`**; без него действие упадёт «не выбрано подключение». Для Google Таблиц вместо `connectionId` нужен `googleEmail` (аккаунт подключается в вебе).
+   - `AI_REPLY` («AI-агент») — два режима, поле `mode` (`"simple"`/не задан, либо `"agent"`). Платный узел в обоих режимах (`PREMIUM_NODE_FORBIDDEN` на бесплатном тарифе) и недоступен в Instagram-графах (нет в IG-allowlist). Тратит месячный AI-бюджет тарифа — он в токенах, не в рублях.
+     - **`mode` не задан или `"simple"`** — ответ модели по `systemPrompt`/`userPromptTemplate` (обязателен, иначе выход `error`). Исчерпание бюджета — не ошибка: узел шлёт `quotaFallbackText` (если задан) и идёт дальше по `next`, как обычно.
+     - **`mode: "agent"`** — поиск по подключённой базе знаний (`knowledgeBaseId`), ветки-действия (`actions[]`, каждому — своё ребро `action_<id>`), извлечение переменных из разговора (`extract[]`, значения — слова клиента, не проверенный факт) и готовая сводка на действии в `{{var.ai_summary}}` без отдельной настройки. Без найденных в базе фрагментов (нет базы, либо релевантность ниже порога) агент в ЛЮБОМ режиме (строгом и нет) уходит в `unknown` — модель даже не вызывается; исключение — узел с непустым `actions[]`: он и без фрагментов зовёт модель, чтобы та могла выбрать действие («запишите меня на завтра» слов из базы не содержит), а её ответ без фрагментов в любом режиме (и в нестрогом тоже) уходит в `unknown`; нестрогий режим лишь разрешает модели дополнять УЖЕ найденные фрагменты общими знаниями (кроме цен/сроков/обещаний), а не отвечать вовсе без базы. **У узла нет выхода `next`** — только `answered`/`action_<id>`/`unknown`/`budget_exhausted`/`error` (`error` — сбой модели/поиска, ИИ не настроен, headless-вебхук или исчерпанный бюджет без ветки `budget_exhausted`). Исчерпание бюджета — своя ветка `budget_exhausted` (если подключена) либо `error`, `quotaFallbackText` отправляется в обоих случаях. Если собираешь агента этим скиллом — обязательно веди себя по этому списку выходов, старый одиночный `AI_REPLY` без `mode` для агента не годится. `systemPrompt`: мягкая норма 10 000 символов (у бэкенда для неё нет отдельного предупреждения, только `validate.mjs` этого скилла warn'ит явно), жёсткий потолок 30 000 (`AGENT_PROMPT_TOO_LONG`, блокирует публикацию) — платформа сама добавляет защиту от инъекций/вытягивания инструкции, запрет обещать несделанное и формат под мессенджер, дублировать это в `systemPrompt` не нужно. Подробности всех полей и кодов ошибок (`AGENT_*`) — в schema.md/validation.md.
+   - **Приём оплат** — действие `issue_invoice` внутри `ACTIONS` (НЕ отдельный узел: `YOOKASSA_PAYMENT` устарел). Деньги идут на кассу владельца бота; `connectionId` — подключение `provider=YOOKASSA` из `list_integrations`. Два режима, выбирай по задаче:
+     - **дождаться оплаты прямо в диалоге** — протяни от блока ветку `paid` (появятся выходы `paid`/`timeout`); сценарий встанет на паузу до подтверждения кассой;
+     - **не ждать** — ветку `paid` не рисуй, блок просто пришлёт счёт и пойдёт по `next`; выдать доступ потом сможет отдельный сценарий с триггером `TRIGGER_PAYMENT`.
+     Счёт обязан быть **последним** действием в блоке и только одним (`INVOICE_NOT_LAST`, `INVOICE_DUPLICATE`).
+   - **`TRIGGER_PAYMENT` («оплата прошла»)** — если счёт выставлял бот, подписчик определяется САМ (счёт помнит его в metadata платежа): можно сразу слать сообщение и вешать метку, разбирать ответ кассы не нужно. Если оплата пришла мимо бота — прогон headless, получателя задавай через `config.target`. Ставь фильтр `minAmount`/`descriptionContains`, иначе сценарий сработает на любую оплату в кассе.
 
 4. **Проверь локально** перед заливкой:
    ```bash
@@ -47,15 +55,15 @@ description: Собрать воронку (сценарий) бота для с
    - `create_graph(botId, name)` → получить `graphId`. Либо стартуй с готовой основы: `list_templates` → `create_graph_from_template(botId, templateId, name)`.
    - `update_graph(graphId, nodes, edges, canvasMeta)` → залить узлы/рёбра.
    - `dry_run(graphId, kind:"command", value:"start")` → прогнать стартовую ветку, проверить `runStatus`.
-   - `publish_graph(graphId)` → если вернулись `errors[]`, разобрать по `code`/`nodeId`, починить узлы, обновить, опубликовать снова.
+   - `publish_graph(graphId)` → при отказе инструмент вернёт ошибку `HTTP 422` со ВСЕМИ причинами построчно (`code@nodeId: message`) — разобрать, починить узлы, обновить, опубликовать снова.
    - Управление сценариями: `clone_graph`, `rename_graph`, `set_active_graph` (переключить живой граф), `delete_graph` (активный нельзя — сначала переключи).
    Если MCP не подключён — отдай готовый `import.json` и подскажи: /bots → граф → **Импорт**.
 
 5b. **Правка СУЩЕСТВУЮЩЕГО / живого сценария — по умолчанию `edit_graph_live`, а НЕ clone+publish.**
-   - Когда пользователь просит «поправь сценарий X» (особенно если он уже открыт в редакторе или опубликован) — правь **ТОТ ЖЕ `graphId`** через **`edit_graph_live(graphId, nodes, edges)`**. Он сам снимает авто-бэкап предыдущего состояния (один rolling-граф «🔙 Авто-бэкап») и делает PUT на месте — **id не меняется**.
+   - Когда пользователь просит «поправь сценарий X» (особенно если он уже открыт в редакторе или опубликован) — правь **ТОТ ЖЕ `graphId`** через **`edit_graph_live(graphId, nodes, edges)`**. Он сам снимает авто-бэкап предыдущего состояния (один rolling-граф «🔙 Авто-бэкап») и делает PUT на месте — **id не меняется**. Живой сценарий бота — граф с `isActive: true` в `list_graphs` (статус `PUBLISHED`; после `publish_graph` черновика это `publishedGraphId`, а **не** id черновика) — правь его id, иначе правка ляжет в черновик и до бота не дойдёт.
    - Почему так: бэкенд при PUT/публикации шлёт `external_update` в WS-комнату → открытые редакторы перечитывают граф **вживую** (юзеру не надо перезаходить). Бот читает активный граф **заново из БД на каждое сообщение** → правка живого PUBLISHED-графа применяется **сразу, без отдельной публикации**.
-   - `clone_graph`+`publish_graph` каждый раз плодят НОВЫЙ id и переключают активный → юзер вынужден открывать новый граф. Так делай только для крупного рискованного рефактора, где нужна изолированная песочница.
-   - ⚠️ PUT не валидирует (валидирует только `publish`) → перед `edit_graph_live` живого графа **обязательно** прогони `validate.mjs` + `dry_run`. Откат: опубликовать граф «🔙 Авто-бэкап» (или скопировать его содержимое обратно).
+   - `clone_graph`+`publish_graph` НЕ создают новый живой граф и НЕ песочница: публикация копирует клон (как любой черновик) в id ТЕКУЩЕГО опубликованного графа бота и затирает его содержимое без бэкапа — вместе с живыми правками, сделанными после прошлой публикации; `set_active_graph` на прежний id после этого вернёт уже новое содержимое, а открытые редакторы живого графа об этом не узнают. Клон годится, чтобы спокойно собрать крупный рискованный рефактор в черновике, но перед его публикацией сохрани живой граф: `get_graph(graphId, saveToFile)` — откат = залить файл обратно через `edit_graph_live`/`update_graph` с `graphFile`.
+   - ⚠️ PUT **активного** (PUBLISHED) графа сервер проверяет как `publish`: валидатор, платные блоки, лимит блоков тарифа, платформа. Ошибка → `HTTP 422` со всеми `code@nodeId`, граф **не сохранён**, бот работает на прежней версии. Черновик (`DRAFT`) PUT сохраняет без проверок, и на бота он не влияет: `publish_graph` черновика копирует его в отдельный `PUBLISHED`-граф (`publishedGraphId`), а сам черновик остаётся `DRAFT`. Всё равно прогоняй `validate.mjs` + `dry_run` заранее. Откат: версии активного не хранятся — опубликовать граф «🔙 Авто-бэкап» (или скопировать его содержимое обратно).
 
 6. **Отчитайся**: сколько узлов/веток, какие тексты помечены на проверку, ссылка/ id графа.
 
@@ -64,6 +72,30 @@ description: Собрать воронку (сценарий) бота для с
 - **Авторизация MCP** — персональный токен (создаётся в вебе на `/bots/mcp-tokens`, формат `zmcp_…`, полный доступ). Если инструмент вернул «нет токена» или ошибку доступа — **вызови `setup`**, объясни пользователю шаги, попроси прислать токен и сохрани его через **`set_token`** (применяется сразу, без env/рестарта). Также работают env `RETENSY_MCP_TOKEN` и session-cookie.
 - Бэкенд читает плоские поля `config.text`/`config.photoUrl`; редактор берёт текст из первой карточки `type:"text"`. Поэтому **всегда заполняй и `text`, и `cards`**.
 
+## Если возможности не хватает — она фиксируется автоматически
+
+При каждой неудаче инструмента отправляется **анонимный** отчёт на `POST /api/mcp/report` того же
+сервера retensy (неизвестный инструмент, отказ публикации `errors[]`, ошибка API). Так мы узнаём,
+чего людям не хватает, и добавляем это в продукт.
+
+Что это значит для тебя как ассистента:
+- **Не выдумывай обходные пути для того, чего нет в schema.md.** Просят узел/триггер/действие,
+  которого в схеме нет, — скажи прямо, что этого пока нет, и что запрос уже зарегистрирован
+  автоматически. Не подменяй это самодельным костылём молча.
+- **Не повторяй один и тот же падающий вызов по кругу.** Отчёты дедуплицируются, но бессмысленные
+  ретраи всё равно тратят время пользователя. Разбери `code`/`nodeId` и исправь причину.
+- Секреты в отчёт не попадают: токены, cookie и креды интеграций вырезаются, значения аргументов
+  по умолчанию скрыты. Пользователь может выключить отчёты через `RETENSY_MCP_TELEMETRY=off`.
+- **Нужна помощь человека** — если что-то не работает или вопрос не про сборку сценария, направляй
+  пользователя в чат «Поддержка» в кабинете bots.retensy.com (кнопка внизу бокового меню): там
+  отвечает менеджер. Внешние контакты поддержки не называй.
+
+## Версия сервера
+
+При старте сервер сверяется с npm. Если вышла новая версия — уведомление появится в `setup` и
+в первом ответе инструмента. **Увидел такое уведомление — передай его пользователю**: обновление
+вступает в силу только ПОСЛЕ перезапуска MCP-сервера, сам процесс свой код подменить не может.
+
 ## Файлы скилла
 - [reference/schema.md](reference/schema.md) — формат графа, типы узлов, конфиги, хэндлы.
 - [reference/validation.md](reference/validation.md) — правила валидатора бэкенда (коды ошибок) и `cardsToLegacy`.

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

@@ -36,6 +36,44 @@
 - `TRIGGER_CALLBACK` — `{ "matchMode": "EQUALS"|"STARTS_WITH", "value": "<callback_data>" }`
 - `TRIGGER_TEXT` — `{ "matchMode": "ANY"|"EQUALS"|"CONTAINS"|"REGEX", "value": "..." }`
 - `BROADCAST_FILTER` — режим рассылки (если есть — единственный триггер).
+- `TRIGGER_PAYMENT` — в кассе владельца прошла оплата.
+  `{ "minAmount": "1000", "descriptionContains": "курс" }` — оба фильтра необязательны.
+  **Ставь хотя бы один фильтр:** без них сценарий будет запускаться на КАЖДУЮ оплату в кассе.
+  В контексте: `{{payment.id}}`, `{{payment.amount}}`, `{{payment.status}}`,
+  `{{payment.description}}`, `{{payment.currency}}`, плюс весь ответ ЮKassa как `body`.
+  Запуск — один раз на платёж: повторные уведомления ЮKassa о той же оплате сценарий не перезапускают.
+  - **Счёт выставлял бот** (действие `issue_invoice`) → подписчик определяется САМ: счёт
+    помнит его в `metadata` платежа. Прогон идёт в обычной сессии — можно прямо ставить
+    «Отправить сообщение» и «Добавить метку», указывать получателя и разбирать ответ кассы
+    не нужно. Это штатный способ «оплатил → выдать доступ», когда ждать в сценарии не хочется.
+  - **Оплата мимо бота** (ссылка из рассылки, счёт из кабинета ЮKassa) → получателя нет,
+    прогон headless: узлы отправки адресуй через `config.target`, либо пиши в CRM и таблицы.
+  ⚠️ Если оплату надо дождаться ПРЯМО в диалоге, триггер не нужен — веди ветку `paid`
+  от блока `ACTIONS` со счётом.
+- `TRIGGER_TG_EVENT` — любое событие Telegram, кроме обычного сообщения: вступил/вышел из канала,
+  реакция, буст, заявка в закрытую группу, ответ в опросе и т.п.
+  `{ "event": "<имя поля Update>", "filter": { ... }, "priority": 0 }`.
+  Рабочие `event` (бэкенд их размечает, остальные молчат): `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`.
+  **НЕ работают** (Telegram их шлёт, но рантайм не разбирает): `business_*`, `chat_shared`,
+  `users_shared`, `write_access_allowed`, `purchased_paid_media` — такой триггер не сработает.
+  `filter` (все условия по И, пустое = не задано):
+  `{"status":"member"|"left"|"kicked"|…}` — только там, где есть `member.status`
+  (`chat_member`, `my_chat_member`); `{"chatId":"-1001234567890"}` — конкретный чат/канал
+  (сравнение строкой, id каналов не влезают в int), доступен у 12 событий с `chat`;
+  `{"text":"купить","textMode":"contains"|"equals"}` — только `message`/`edited_message`/
+  `channel_post`/`edited_channel_post`. У `poll`/`poll_answer`/`inline_query`/
+  `chosen_inline_result`/`shipping_query`/`pre_checkout_query` чата нет → фильтров тоже.
+  Бот должен быть админом канала/группы, иначе события оттуда не придут.
+- `TRIGGER_ANY_UPDATE` — `{}`, ловит ЛЮБОЙ апдейт. Приоритет самый низкий: срабатывает, только
+  если не подошёл ни один конкретный триггер. Удобен как «ничего не понял» / отладка.
+- `TRIGGER_WEBHOOK` — `{}`, точка входа сценария с источником WEBHOOK (не бот). Такие сценарии
+  создаются в вебе; у графа бота этот триггер не сработает.
+- ~~`TRIGGER_COMMENT`~~ — **мёртвый тип**: рантайм нигде не выставляет `event="comment"`, сработать
+  он не может. Убран из палитры редактора. Комментарии Instagram — `TRIGGER_IG_COMMENT`.
 
 #### Instagram (только для IG-ботов)
 IG-боты не поддерживают команды (`/start`). Вход — через взаимодействие с контентом или директ:
@@ -69,6 +107,19 @@ IG-боты не поддерживают команды (`/start`). Вход
 ### Логика / ветвление
 - `CONDITION` — проверка условий, выходы `yes` / `no`. `{ "match":"ALL"|"ANY", "conditions":[ { "kind":"...", "op":"...", "key":"...", "value":"..." } ] }`. `match:"ALL"` — все условия истинны; `"ANY"` — хотя бы одно. Полный список `kind`/`op`/полей — в разделе [«Условия CONDITION»](#условия-condition).
 - `BRANCH` — `{ "cases":[ {"id":"c1","label":"...","expression":"var.x=='a'"} ], "hasDefault": false, "abTest": false }`. Выходы: `case_<id>` (+ `default`).
+- `SWITCH` — развилка по ЗНАЧЕНИЮ, когда веток больше двух.
+  `{ "expression":"{{var.http_status}}", "cases":[ {"id":"v1","value":"200","label":"Успех"},
+  {"id":"v2","value":"404","label":"Не найдено"} ] }`. Выходы: `case_<id>` + `default` (есть всегда).
+  Выражение рендерится как шаблон (обычно просто `{{var.x}}`) и сравнивается со `value` каждого
+  случая **без учёта регистра и пробелов по краям**; первое совпадение выигрывает, иначе `default`.
+  Отличия: `CONDITION` — бинарное да/нет, `BRANCH` — случайный выбор (A/B), `SWITCH` —
+  детерминированный выбор по значению. Валидатор режет: пустое `expression`
+  (`SWITCH_NO_EXPRESSION`), нет случаев (`SWITCH_NO_CASES`), пустое `value` (`SWITCH_EMPTY_VALUE`),
+  повтор значения (`SWITCH_DUPLICATE_VALUE`), случай без ребра (`SWITCH_CASE_UNCONNECTED`).
+  Ребро на `default` необязательно.
+- `STOP_AND_ERROR` — `{ "message":"CRM не ответила: {{var.http_status}}" }`. Обрывает прогон и
+  помечает его в журнале как ошибочный (`FAILED`), шаг — `ok:false` с этим текстом. Выходов нет,
+  ничего подписчику не отправляет. Пустой `message` → «Сценарий остановлен с ошибкой».
 - `ASK_QUESTION` — вопрос со сбором ответа. `{ "promptText":"...","saveTo":"name","inputKind":"TEXT"|"PHOTO"|"DOCUMENT"|"CONTACT"|"LOCATION","validator":"ANY"|"PHONE"|"EMAIL"|"REGEX","regex":"...","retryText":"...","maxAttempts":3 }`. `inputKind` (по умолчанию `TEXT`) — что ждём в ответ (`CONTACT` → телефон: в Telegram показывается кнопка «Поделиться номером», в MAX/Instagram кнопки нет — номер вводится вручную и принимается как телефон на всех платформах; `LOCATION` → `lat,lon`, `PHOTO`/`DOCUMENT` → file_id). Выходы `valid` / `invalid`.
 - `END` — `{}` (конец ветки). **Не добавляй `END`**: ветка и так завершается на узле без исходящих рёбер; явный «конец сценария» бесполезен и убран из палитры редактора. Тип оставлен лишь для совместимости со старыми графами.
 
@@ -84,16 +135,198 @@ IG-боты не поддерживают команды (`/start`). Вход
 - `ACTIONS` — непустой пакет действий `{ "actions":[ { "kind":"...", ...поля } ] }`. Допустимые `kind` (иначе ошибка `ACTION_UNKNOWN_KIND`):
   - **метки/автоворонки**: `add_tag`, `remove_tag`, `autoflow_add`, `autoflow_remove` — поле `tag` (`[a-z0-9_-]{1,64}`)
   - **профиль**: `set_field` — `key` (`[a-z_][a-z0-9_]{0,63}`) + `value`; `subscribe`, `unsubscribe`
-  - **HTTP**: `external_request`, `subscriber_webhook` — `url` (http/https) + `method`/`headersJson`/`bodyTemplate`
+  - **HTTP**: `external_request` — **основной способ сходить в чужой API**, те же поля и возможности,
+    что у узла `CALL_WEBHOOK`: `url` + `method`/`headersJson`/`bodyTemplate`/`timeoutMs` +
+    `saveStatusTo`/`saveBodyTo`/`extract`. Отличие одно: своих выходов у действия нет — сбой уводит
+    ВЕСЬ блок `ACTIONS` в его выход `error` (если ребро нарисовано; нет — идём по `next`), а
+    ветвиться по коду ответа надо следующим блоком `SWITCH`. **Платное действие** (как `CALL_WEBHOOK`):
+    на бесплатном тарифе публикация падает с `PREMIUM_NODE_FORBIDDEN`.
+    Ещё есть `subscriber_webhook` — `url` + `method`/`headersJson`/`bodyTemplate`
   - **уведомления**: `notify` (`text`), `subscriber_email` (`email`,`text`), `agent_chat`
   - **бот/шаг**: `stop_bot`, `delete_step_message`, `cancel_payment_subscription`
   - **Google Таблицы (работает)**: `gsheets_send` — дописать строку-заявку в таблицу: `{ "kind":"gsheets_send", "googleEmail":"me@gmail.com", "spreadsheetId":"<id таблицы>", "sheetName":"Лист1", "cells":["{{from.first_name}}","{{var.phone}}","{{var.email}}"] }`. `cells` — значения по порядку (шаблоны), бот дописывает их строкой в конец листа. Google-аккаунт подключается В ВЕБЕ (`/bots` → у действия кнопка «Подключить Google»), НЕ через MCP — у пользователя уже должен быть подключён `googleEmail`. Нужны `googleEmail` + `spreadsheetId` + непустой `cells[]` (иначе `ACTION_GSHEETS_INCOMPLETE`).
-  - **интеграции (пока заглушки, no-op `integration_not_connected`)**: `getcourse_send`, `getcourse_order`, `amocrm_send`, `amocrm_update`, `yametrika_event`, `gsheets_get`, `gsheets_update`, `gsheets_write_cell`, `gsheets_read_cell`
+    Остальные четыре действия с таблицами тоже РАБОТАЮТ и тоже требуют `googleEmail` + `spreadsheetId`:
+    `gsheets_get` (`range` → `saveTo`), `gsheets_update` (`range`, `values[]`), `gsheets_write_cell`
+    (`cell`, `value`), `gsheets_read_cell` (`cell` → `saveTo`; пустая ячейка не ошибка — переменная станет `""`).
+  - **CRM и внешние системы — РАБОТАЮТ** (реальные HTTP-клиенты на бэкенде, не заглушки).
+    Всем им нужен **`connectionId`** — id подключения пользователя; без него действие падает
+    «не выбрано подключение». **Узнать id: инструмент MCP `list_integrations`** (отдаёт
+    `{id, provider, title, hint}`; сами креды не отдаются). Значения полей — шаблоны
+    (`{{var.x}}`, `{{from.first_name}}`).
+    - `amocrm_send` — создать сделку (+контакт): `connectionId`, `leadName`, опц. `price`,
+      `pipelineId`, `statusId` (числа), `contactName`, `phone`, `email`. Если все три контактных
+      поля после рендера пусты — сделка уходит без контакта. В переменные кладёт `amo_lead_id`
+      и `amo_contact_id` (если amo его вернул).
+    - `amocrm_update` — частичное обновление сделки: `connectionId`, `leadId` (обычно
+      `{{var.amo_lead_id}}`), плюс те же `leadName`/`price`/`pipelineId`/`statusId`. Пустой
+      `leadId` или отсутствие полей для обновления — отказ.
+    - `bitrix24_call` — любой REST-метод Битрикс24: `connectionId`, **`b24method`** (именно так,
+      не `method` — это имя занято HTTP-методом «Внешнего запроса»), `fields` — список пар
+      `{key, value}` (ключ вида `fields[TITLE]` разворачивается во вложенную карту),
+      `extract` — список `{path, saveTo}` для JsonPath-извлечения ответа в переменные.
+    - `getcourse_send` — добавить/обновить пользователя: `connectionId`, `email`, опц. `userName`,
+      `phone`, `groups` (CSV групп), `addfields` (карта доп.полей). Повторная заявка обновляет,
+      а не дублирует.
+    - `getcourse_order` — создать заказ: те же поля пользователя + `offerCode`, опц. `dealStatus`,
+      `dealComment`. В переменные кладёт `gc_deal_id`, если GetCourse его вернул.
+    - `yametrika_event` — офлайн-конверсия в Я.Метрику: `connectionId`, `idType`
+      (`ClientId`|`Yclid`, по умолчанию `ClientId`), **`idValue`** (обязателен после рендера —
+      пустой обрывает действие), опц. `target`, `price`, `currency` (по умолчанию `RUB`),
+      `dateTime` (unix-секунды, по умолчанию «сейчас»).
+  - **Единственные НЕ интегрированные действия**: `agent_chat` и `cancel_payment_subscription` —
+    принимается как no-op с пометкой `integration_not_connected`.
   - **модерация группы**: `group_unban`, `group_kick`, `group_approve`, `group_decline`
 
 ### Внешнее / прочее
-- `CALL_WEBHOOK` — `{ "url":"https://...", "method":"POST", "bodyTemplate":"{...}", "timeoutMs":5000 }`. Выходы `ok` / `error`.
-- `AI_REPLY`, `PAYMENT_LINK`.
+- `CALL_WEBHOOK` — `{ "url":"https://...", "method":"POST", "headersJson":"{\"X-Key\":\"…\"}",
+  "bodyTemplate":"{...}", "timeoutMs":5000, "saveStatusTo":"http_status", "saveBodyTo":"http_body",
+  "extract":[{"path":"$.id","saveTo":"crm_id"}] }`. Выходы `ok` (код 2xx) / `error` (код ≥ 400,
+  сетевая ошибка, таймаут, отказ SSRF-гарда). Если ребра `error` нет — прогон идёт по `next`.
+  - `timeoutMs` — на этот узел; 0/не задан = общий клиент (connect 5 с / read 7 с), иначе значение
+    прижимается к диапазону **500…30000 мс**.
+  - `saveStatusTo` / `saveBodyTo` — имена переменных для HTTP-кода и тела ответа целиком.
+    Пишутся ВСЕГДА, в том числе на `error`: при сетевой ошибке код `0` и пустое тело (чтобы в
+    переменной не осталось значение прошлого прогона). Тело длиннее 64 КБ обрезается.
+    Это штатный способ разветвиться по коду ответа: `saveStatusTo` → `SWITCH`.
+  - `extract` — разбор JSON-тела по JsonPath в переменные (работает только на валидном JSON).
+- `AI_REPLY` — ответ модели. Два режима, переключатель — поле `mode` (`"simple"`/не задано, либо
+  `"agent"`). Узел без `mode` работает дословно как режим `simple` (обратная совместимость: в
+  проде живут графы без этого поля). **Оба режима платные** (`PREMIUM_NODES`): на бесплатном
+  тарифе публикация падает с `PREMIUM_NODE_FORBIDDEN`. Веб-редактор показывает поле
+  `quotaFallbackText` в инспекторе для ОБОИХ режимов (без подстановки `{{var.x}}` — уходит клиенту
+  как есть).
+
+  **`mode: "simple"`** (сегодняшнее поведение, без изменений):
+  `{ "systemPrompt":"Ты консультант магазина.", "userPromptTemplate":"Вопрос: {{last_text}}",
+  "sendToUser": true, "saveTo":"ai_answer", "quotaFallbackText":"Спросите менеджера" }`.
+  `userPromptTemplate` обязателен (пустой → выход `error`). `sendToUser:true` — отправить ответ
+  подписчику; `saveTo` — положить в переменную. Если месячный AI-бюджет тарифа исчерпан, узел НЕ
+  ошибка: отправляется `quotaFallbackText` (если задан) и сценарий идёт дальше по `next`. В этом
+  случае `saveTo` НЕ обновляется — переменная хранит значение прошлого прогона (или остаётся
+  пустой, если прогона ещё не было). Температура задаётся глобально на сервере — поле
+  `temperature` в конфиге рантайм не читает.
+
+  **`mode: "agent"`** — поиск по базе знаний + ветки-действия + память диалога на этом узле. Температура
+  агента своя, серверная (`botbuilder.ai.agent-temperature`, по умолчанию 0.3), `temperature` узла не читается
+  (спека `docs/superpowers/specs/2026-09-21-ai-agent-node-design.md`, раздел 10). У узла-агента
+  **нет выхода `next`** — вместо него именованные ветки ниже.
+  ```json
+  { "mode": "agent", "knowledgeBaseId": "<id базы знаний>", "strict": true,
+    "systemPrompt": "Ты консультант магазина. Отвечай по базе, вежливо и по делу.",
+    "actions": [ { "id": "order", "title": "Оформить заказ", "when": "клиент готов купить" } ],
+    "extract": [ { "variable": "phone", "description": "телефон клиента" } ],
+    "quotaFallbackText": "Спросите менеджера" }
+  ```
+  Необязательные числовые/флаговые поля и их дефолты (можно не указывать вовсе):
+  `directAnswer` (`false`), `directAnswerThreshold` (`0.88`), `minScore` (`0.35`), `topK` (`5`),
+  `maxContextChars` (`6000`), `historyTurns` (`6`).
+  - `knowledgeBaseId` — id базы знаний ЭТОГО владельца (иначе рантайм ведёт себя так, будто базы
+    нет). `strict` (по умолчанию `true`) — без базы в строгом режиме публикация падает с
+    `AGENT_NO_KNOWLEDGE_BASE`.
+  - **Без найденных в базе фрагментов агент уходит в `unknown` в ЛЮБОМ режиме** — если хитов нет
+    или лучший скор ниже `minScore`, до вызова модели дело не доходит вообще (нестрогий режим
+    агента без базы или без совпадений не «отвечает по общим знаниям», он так же уходит в
+    `unknown`). **Исключение — узел с непустым `actions[]`:** он и без фрагментов зовёт модель
+    (платно), чтобы та могла выбрать действие — «запишите меня на завтра» слов из базы не содержит;
+    её ответ без фрагментов в любом режиме (и в нестрогом) уходит в `unknown` — только действие. Узел только с
+    `extract[]` выходит рано, как раньше. `strict` решает только то, что делает модель, когда релевантные фрагменты уже
+    нашлись: в строгом режиме — отвечает исключительно по ним; без строгого режима — может
+    дополнить их общими знаниями модели, но не про цены/сроки/обещания — это всегда только из
+    базы и инструкции.
+  - `directAnswer` (по умолчанию `false`) — прямой ответ готовой парой вопрос-ответ БЕЗ обращения
+    к модели (бесплатно), когда совпадение по базе ≥ `directAnswerThreshold`. Пара ищется по вектору
+    своего вопроса, так что порог 0.88 проходят почти дословные формулировки. Работает только для
+    документов-пар вопрос-ответ (не для кусков файлов/сайта) — кусок PDF, отданный дословно,
+    выглядел бы поломкой.
+  - `minScore` — порог релевантности фрагмента для решения «есть о чём отвечать»; ниже — выход
+    `unknown`. `topK`/`maxContextChars` — сколько фрагментов брать и лимит символов контекста.
+    `historyTurns` — сколько реплик истории диалога передавать модели.
+  - `systemPrompt` — инструкция агента. Мягкая норма — **до 10 000 символов**: длиннее модель хуже
+    держит середину, и каждый ответ дороже. У бэкенда для этого нет отдельного предупреждения при
+    публикации (веб-инспектор просто красит счётчик символов) — только `validate.mjs` (этот
+    скилл) предупреждает об этом явно. Жёсткий потолок — **30 000 символов**
+    (`AGENT_PROMPT_TOO_LONG`, блокирует публикацию и у бэкенда, и у `validate.mjs`). Платформа
+    сама добавляет ПЕРЕД инструкцией служебный блок: защиту от инъекций/вытягивания инструкции
+    через реплики клиента, историю и фрагменты базы, запрет писать, что действие уже выполнено
+    (это делает сценарий, не модель), запрет обещать несделанное, и формат ответа под конкретный
+    мессенджер — **дублировать это в `systemPrompt` не нужно**.
+  - `actions[]` — ветки, которые выбирает сама модель по смыслу разговора: `id` (латиница/цифры/`_`),
+    `title` (человеческое название — без него запись целиком игнорируется рантаймом и валидатором),
+    `when` (опц., подсказка модели, когда применять). Каждому действию — своё ребро
+    `action_<id>`; повтор `id` → `AGENT_DUPLICATE_ACTION_ID`, отсутствие ребра →
+    `AGENT_ACTION_NOT_CONNECTED`.
+  - `extract[]` — переменные, которые агент сам заполняет из разговора: `variable`
+    (`[a-z_][a-z0-9_]{0,63}`, не `ai_summary` — оно зарезервировано), `description` (что искать).
+    Значение — **слова клиента, а не проверенный факт**. Кривая запись → `AGENT_BAD_EXTRACT`.
+  - При уходе в действие (`action_<id>`) агент сам готовит сводку разговора для менеджера —
+    без отдельной настройки, кладёт её в `{{var.ai_summary}}` (до 1500 символов, тоже слова
+    клиента, не проверенные данные).
+  - Выходы: `answered` (ответила модель — по базе, а без строгого режима ещё и общими знаниями),
+    `action_<id>` (по числу `actions[]`), `unknown` (не знает ответа — нет фрагментов выше
+    `minScore`, ветка не подключена не блокирует публикацию, только предупреждение
+    `AGENT_UNKNOWN_NOT_CONNECTED`, но диалог упрётся в тупик), `budget_exhausted` (месячный
+    AI-бюджет исчерпан, если ветка подключена), `error` (сбой модели/поиска, ИИ не настроен на
+    сервере, headless-вебхук — у агента нет собеседника — или исчерпан бюджет, а ветка
+    `budget_exhausted` не подключена). Прямой ответ (`directAnswer`) отправляется и идёт в выход
+    `answered`, как обычный ответ модели.
+  - **Исчерпание бюджета у агента — НЕ `next`** (такого выхода у узла нет): уходит в
+    `budget_exhausted`, если ветка подключена, иначе в `error`. `quotaFallbackText` (без
+    подстановки переменных) отправляется в обоих случаях, если задан. Это касается и
+    `directAnswer` — бесплатный прямой ответ тоже не сработает при исчерпанном бюджете месяца,
+    проверка бюджета идёт раньше поиска по базе.
+- `PAYMENT_LINK` — сообщение с кнопкой-ссылкой на оплату (сам платёж не проводит).
+  `{ "paymentUrl":"https://example.com/pay?user={{from.id}}", "description":"Оплатите подписку:",
+  "buttonText":"Оплатить" }`.
+- `YOOKASSA_PAYMENT` — узел оплаты. **В новых сценариях его не ставь**: выставление счёта — это
+  действие, поэтому оно живёт действием `issue_invoice` внутри `ACTIONS` (см. ниже), а узла больше
+  нет в палитре. Тип жив в рантайме только ради графов, где он уже стоит.
+- Действие **`issue_invoice`** внутри `ACTIONS` — настоящий счёт на **кассу владельца бота**
+  (деньги идут на его магазин, не на счёт сервиса) и, если нужно, ожидание оплаты.
+  `{ "kind":"issue_invoice", "connectionId":"<id подключения ЮKassa>", "amount":"990",
+  "description":"Доступ к курсу", "buttonText":"Оплатить", "timeoutMinutes":60 }`.
+  - `connectionId` **обязателен** — подключение из реестра с `provider=YOOKASSA`
+    (`list_integrations`). Нет его → `YK_NO_CONNECTION`. Касса обязана принадлежать владельцу
+    бота, чужой id рантайм отвергает.
+  - `amount` обязателен, > 0, можно шаблоном (`{{var.price}}`); `description` обязателен.
+  - **Выходы даёт БЛОК `ACTIONS`** (тем же приёмом, что и `error`): при наличии счёта у блока
+    появляются `paid` и `timeout`. Ключевое правило: **поведение зависит от того, протянул ли ты
+    ветку `paid`.**
+    - Ветки `paid` НЕТ → блок просто шлёт счёт и идёт по `next`, ничего не дожидаясь.
+    - Ветка `paid` ЕСТЬ → сценарий встаёт на паузу до подтверждения оплаты кассой; не дождался за
+      `timeoutMinutes` → уйдёт в `timeout`. Сообщения подписчика до оплаты (другие триггеры, ветки до END,
+      вопроса или задержки) ожидание не сбрасывают: `paid`/`timeout` всё равно сработают. Сбрасывает его только
+      пауза на ДРУГОМ счёте с веткой `paid` — тогда оплата прежней ссылки сценарий не продолжает.
+  - ⚠️ **Счёт обязан быть ПОСЛЕДНИМ действием в блоке** (`INVOICE_NOT_LAST`) и только один
+    (`INVOICE_DUPLICATE`). Причина: с веткой `paid` блок встаёт на паузу, а возобновиться с
+    середины списка движок не умеет — действия после счёта молча не выполнились бы.
+  - `timeoutMinutes` — 1…1440, по умолчанию 60. Имеет смысл только вместе с веткой `paid`.
+  - Переменные после шага: `{{var.payment_url}}`, `{{var.payment_id}}`.
+  - Повторный проход по счёту: пока попытка ЭТОГО шага жива (не оплачена, таймаут не сработал, другой счёт с
+    `paid` её не сменил) — та же ссылка (тот же платёж), даже если между проходами подписчик ушёл в другую
+    ветку; после оплаты или таймаута — новый счёт. Оплата, пришедшая после таймаута, сценарий не продолжает.
+  - Без ветки `paid` ожидания нет: каждый проход по такому счёту — новый платёж с новой ссылкой.
+  - Действие бесплатное (в отличие от `external_request`).
+  - ⚠️ Чтобы `paid` вообще срабатывал, владелец должен вписать адрес уведомлений из карточки
+    подключения в кабинет ЮKassa (событие `payment.succeeded`). Если этого не сделано, оплата
+    пройдёт, а сценарий будет молча ждать до таймаута — это не баг графа.
+  - Бот выключен в момент оплаты или проверка платежа не удалась (сбой ЮKassa, устаревший ключ в подключении) →
+    ЮKassa повторяет уведомление до суток; `paid` сработает на первом удачном повторе, если сценарий к тому
+    времени ещё не ушёл в `timeout`. Не удалось за сутки — сценарий по этой оплате не продолжится.
+- `CALL_WEBHOOK` — тоже платный узел, см. раздел «Внешнее / прочее». **В новых сценариях его не
+  ставь**: узла больше нет ни в палитре, ни в меню — внешний запрос собирается действием
+  `external_request` внутри `ACTIONS`. Тип живёт в рантайме только ради графов, где он уже стоит.
+- Действие `external_request` внутри `ACTIONS` — **тоже платное**, гейт тот же.
+
+## Лимиты тарифа, которые видит сборщик графов
+
+- **Блоков в сценарии.** Публикация падает с `NODE_LIMIT_EXCEEDED` (в тексте — сколько блоков в
+  графе и сколько даёт тариф). Ошибка на весь граф, `nodeId` пустой. Проверять нечем заранее:
+  число блоков берётся из `nodes[]`, лимит — из тарифа владельца.
+- **Число сценариев.** `create_graph`, `create_graph_from_template`, `clone_graph`, `copy_graph` и
+  создание сценария в вебе отдают **HTTP 402** `{error, upgradeUrl}`, когда лимит исчерпан.
+  Считаются сценарии, которые завёл человек; снимок публикации место не занимает.
+- **Переменные** (глобальные и на сценарий) тоже лимитированы тарифом — сама подсистема переменных
+  ещё не построена, поле лимита в тарифе уже есть.
 
 ## Условия CONDITION
 
@@ -124,7 +357,8 @@ IG-боты не поддерживают команды (`/start`). Вход
 
 ## Платформа Instagram
 
-IG-боты подключаются через OAuth в разделе **«Инструменты роста»** (`/growth`) — **без вставки токена вручную**; у IG нет персонального бот-токена. После OAuth бот получает доступ к Messaging API через привязанный Instagram Business/Creator-аккаунт.
+IG-боты подключаются через OAuth на странице **`/bots/instagram`** (раздел «Подключения» → карточка
+Instagram; прежний раздел «Инструменты роста» / `/growth` расформирован и редиректит) — **без вставки токена вручную**; у IG нет персонального бот-токена. После OAuth бот получает доступ к Messaging API через привязанный Instagram Business/Creator-аккаунт.
 
 ### Разрешённые типы узлов для IG-ботов
 
@@ -134,14 +368,15 @@ IG-боты подключаются через OAuth в разделе **«Ин
 |---|---|
 | `TRIGGER_IG_COMMENT`, `TRIGGER_IG_DM`, `TRIGGER_IG_STORY_REPLY`, `TRIGGER_IG_STORY_MENTION` | ✅ (триггеры входа) |
 | `SEND_MESSAGE`, `SEND_PHOTO` | ✅ |
-| `BRANCH`, `CONDITION` | ✅ |
+| `BRANCH`, `CONDITION`, `SWITCH`, `STOP_AND_ERROR` | ✅ |
 | `SET_VARIABLE`, `ADD_TAG`, `REMOVE_TAG`, `FORMULA` | ✅ |
 | `ASK_QUESTION` | ✅ (с ограничениями — см. ниже) |
 | `DELAY` | ✅ (не более 24ч — см. ниже) |
 | `END` | ✅ |
 | `TRIGGER_COMMAND`, `TRIGGER_CALLBACK`, `TRIGGER_TEXT` | ❌ |
 | `BROADCAST_FILTER` (рассылки) | ❌ |
-| `SCHEDULE`, `ACTIONS`, `CALL_WEBHOOK`, `AI_REPLY`, `PAYMENT_LINK` | ❌ |
+| `SCHEDULE`, `ACTIONS`, `CALL_WEBHOOK`, `AI_REPLY`, `PAYMENT_LINK`, `YOOKASSA_PAYMENT` | ❌ |
+| `TRIGGER_PAYMENT` | ❌ |
 
 ### Ограничения IG-ботов
 
@@ -186,8 +421,13 @@ node validate.mjs graph.json --platform=INSTAGRAM
 | `ASK_QUESTION` | `valid`, `invalid` |
 | `SEND_MESSAGE` с `awaitReply:true` | `valid`, `invalid` (+ `btn_N` для кнопок) |
 | `CALL_WEBHOOK` | `ok`, `error` |
+| `ACTIONS` | `next`, плюс `error` — если внутри есть действие, которое может упасть (внешний запрос, CRM, Таблицы) |
+| `SWITCH` | `case_<id>`, `default` |
+| `STOP_AND_ERROR` | выходов нет (терминатор) |
 | `SCHEDULE` | `scheduled`, `past` |
 | `DELAY` | `next` |
+| `AI_REPLY` (`mode` не задан/`simple`) | `next`, `error` |
+| `AI_REPLY` (`mode:"agent"`) | `answered`, `action_<id>` (по числу `actions[]`), `unknown`, `budget_exhausted`, `error` — **выхода `next` нет** |
 
 ## Подстановки в тексте
 `{{from.first_name}}`, `{{from.username}}`, `{{var.<имя>}}`, либо `{Имя}` как плейсхолдер. Имена переменных/меток: `[a-z_][a-z0-9_]{0,63}` (var) и `[a-z0-9_-]{1,64}` (tag).