@retensy/mcp 0.23.0 → 0.24.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
       "name": "retensy-mcp",
       "source": "./",
       "version": "0.15.1",
-      "description": "Сборка и публикация воронок ботов (Telegram/MAX, Retensy Bots) из описания, рассылки, подключение ботов и сервисов, сайтов из блоков + публикация статей блога в Markdown — через MCP + скилл."
+      "description": "Сборка и публикация воронок ботов (Telegram/MAX, Retensy Bots) из описания или переноса из другого конструктора (BotHelp, SaleBot, Senler и др.), рассылки, подключение ботов и сервисов, сайтов из блоков + публикация статей блога в Markdown — через MCP + скилл."
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "retensy-mcp",
   "displayName": "Retensy MCP",
   "version": "0.15.1",
-  "description": "MCP-сервер + скилл для Retensy Bots: подключение ботов и сервисов, сборка и публикация воронок ботов (Telegram/MAX), рассылки, сайты из блоков (Zero-блок, дизайны, шаблоны, свои домены, заявки) и статьи блога в Markdown — всё одним токеном zmcp_.",
+  "description": "MCP-сервер + скилл для Retensy Bots: подключение ботов и сервисов, сборка и публикация воронок ботов (Telegram/MAX), перенос воронок из других конструкторов (BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat и др.), рассылки, сайты из блоков (Zero-блок, дизайны, шаблоны, свои домены, заявки) и статьи блога в Markdown — всё одним токеном zmcp_.",
   "author": { "name": "retensy", "url": "https://bots.retensy.com" },
   "homepage": "https://bots.retensy.com/bots",
   "repository": "https://github.com/retensy/retensy-mcp",

package/README.md

@@ -7,6 +7,47 @@
 
 MCP-сервер (+ скилл для Claude Code) для **сборки и публикации воронок/автоматизаций ботов (Telegram, MAX и Instagram)** в сервисе [retensy `/bots`](https://bots.retensy.com/bots): из текстового описания → валидный граф сценария → заливка и публикация через API.
 
+---
+
+## Быстрый старт
+
+1. **Получи токен.** Залогинься на https://bots.retensy.com → открой `/bots/mcp-tokens` → создай токен → скопируй секрет `zmcp_...` (показывается один раз).
+2. **Подключи у своего клиента** (env-переменные везде одни и те же: `RETENSY_BASE_URL`, `RETENSY_MCP_TOKEN`):
+
+   **Claude Desktop** — добавь в `claude_desktop_config.json`:
+   ```json
+   {
+     "mcpServers": {
+       "retensy-mcp": {
+         "command": "npx",
+         "args": ["-y", "@retensy/mcp@latest"],
+         "env": {
+           "RETENSY_BASE_URL": "https://bots.retensy.com",
+           "RETENSY_MCP_TOKEN": "zmcp_ваш_токен"
+         }
+       }
+     }
+   }
+   ```
+
+   **Claude Code** — одной командой:
+   ```bash
+   claude mcp add retensy-mcp -e RETENSY_BASE_URL=https://bots.retensy.com -e RETENSY_MCP_TOKEN=zmcp_ваш_токен -- npx -y @retensy/mcp@latest
+   ```
+   Или как плагин (подтянет и скиллы, см. [«Вариант A» ниже](#вариант-a--как-плагин-claude-code-рекомендуется)):
+   ```text
+   /plugin marketplace add retensy/retensy-mcp
+   /plugin install retensy-mcp@retensy
+   ```
+
+   **Cursor** — Settings → MCP → Add new MCP Server (или `.cursor/mcp.json` в проекте) — тот же JSON-объект, что и для Claude Desktop выше (`mcpServers.retensy-mcp` с `command`/`args`/`env`).
+
+3. **Собери первую воронку.** Опиши сценарий словами агенту — он сам соберёт граф и опубликует (см. [«Использование»](#использование)), либо перенеси готовую воронку из другого сервиса — см. [«Перенос воронки из другого конструктора»](#перенос-воронки-из-другого-конструктора) ниже.
+
+Проверить подключение в любом клиенте: спроси агента «настрой подключение» — вызовет `setup` и подскажет, если что-то не так.
+
+---
+
 - 🤖 **Сценарии ботов**: `list_bots`, `list_graphs`, `list_channels`, `get_graph`, `create_graph`, `update_graph`, `edit_graph_live`, `patch_graph`, `dry_run`, `publish_graph`, `import_funnel`, `list_templates`, `create_graph_from_template`, `clone_graph`, `copy_graph`, `rename_graph`, `set_active_graph`, `delete_graph`, `upload_file`, `list_files`, `delete_file`, `graph_analytics`, `list_bot_users`, `list_links` (+ `setup`/`set_token`).
 - 🔌 **Боты и сервисы**: `create_bot` (Telegram/MAX по токену), `bot_stop`/`bot_resume`, `connect_integration`/`disconnect_integration` (amoCRM, Битрикс24, GetCourse, Я.Метрика, ЮKassa; Google Таблицы — ссылкой на вход Google; креды хранятся зашифрованными и не возвращаются), `integration_catalog`/`integration_status`/`integration_test` (каталог Integration Core и живая проверка подключения), `integration_ingress_url` (URL ингресса «Внешних событий» — Tilda, JivoSite, WooCommerce, amoCRM, Битрикс24, GetCourse, CloudPayments, Robokassa, Т-Банк, Prodamus — для `TRIGGER_WEBHOOK`), `channel_post` (пост в канал Telegram/MAX).
 - 📣 **Рассылки**: `broadcast_preview` (размер аудитории), `broadcast_send` (сейчас или по расписанию, сразу по нескольким ботам; сообщения или запуск сценария; полный фильтр аудитории `audienceFilter`, дедуп `dedup` и распределённый запуск `stagger` по ботам), `broadcast_list`/`broadcast_get`/`broadcast_cancel`, повторяющиеся (`broadcast_recurring`), черновики (`broadcast_drafts`, `broadcast_duplicate`), мульти-бот группы (`broadcast_group` — preview/list/get/pause/resume/cancel) + скилл `send-broadcast`.
@@ -20,6 +61,7 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 - 📎 **Медиа**: `upload_file` грузит фото/видео/документы в библиотеку **/bots/files** (до 50 МБ) и возвращает публичный URL — его вставляешь в медиа-карточку сценария.
 - 🌐 **Сайты из блоков** (раздел «Страницы»): создание, правка операциями (блоки, Zero-блок со свободной вёрсткой, код блока, папки страниц, дизайны, шаблоны из библиотеки), публикация и откат, свои домены, заявки из форм и куда их доставлять — инструменты `site_*` + скилл `build-site`.
 - 🧠 **Скилл `build-bot-funnel`**: учит агента собирать корректный граф (типы узлов, ветки, кнопки, задержки) и проверять его перед публикацией. Поддерживает Telegram, MAX и Instagram.
+- 🔁 **Скилл `rebuild-funnel-from-builder`**: переносит воронку из другого конструктора (BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot и др.) по export JSON/тексту, скриншотам или пересказу — в граф Retensy, новым черновиком, без перезаписи текущего сценария. См. [«Перенос воронки из другого конструктора»](#перенос-воронки-из-другого-конструктора).
 - 📦 **Без зависимостей** — чистый Node ≥18, ставится и запускается сразу.
 
 ### Поддерживаемые платформы
@@ -41,7 +83,7 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 /plugin install retensy-mcp@retensy
 ```
 
-Подтянутся MCP-сервер и скиллы `build-bot-funnel`, `build-site`, `send-broadcast`. Проверить: `/mcp` и `/plugin`.
+Подтянутся MCP-сервер и скиллы `build-bot-funnel`, `rebuild-funnel-from-builder`, `build-site`, `send-broadcast`. Проверить: `/mcp` и `/plugin`.
 
 ### Вариант B — как обычный MCP-сервер (Claude Code / Cursor / Windsurf / любой MCP-клиент)
 
@@ -79,6 +121,10 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 
 Отозвать токен можно там же — доступ блокируется мгновенно.
 
+> С 14.10 тот же токен `zmcp_...` полностью покрывает и вебхук-сценарии (`/api/scenarios` — `scenario_*`),
+> и управление подключениями сервисов (`/api/integrations` — `connect_integration`/`disconnect_integration`/
+> `integration_update` и остальные `integration_*`), не только `/api/bots`. Отдельного токена под эти инструменты не нужно.
+
 > **Не знаешь, что делать?** Скажи агенту «настрой подключение» — он вызовет `setup`, объяснит шаги и попросит токен. Любой инструмент при отсутствии токена тоже вернёт пошаговую инструкцию.
 
 > Дев-окружение: `RETENSY_BASE_URL=http://localhost:8066`.
@@ -225,6 +271,15 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 | `scenario_timeseries(graphId, from, to)` | дневной ряд прогонов сценария `{ok, failed, other}` (по узлам — `graph_analytics`) |
 | `agent_tool_test(agentId, toolId, params?)` | проверить инструмент агента (`AMO_LOOKUP`/`SHEETS_LOOKUP`/`HTTP_API`) напрямую, без модели — бюджет ИИ не тратится |
 | `site_lead_file_download(siteId, leadId, fileId)` | метаданные вложения заявки + ссылка на скачивание (сам файл через MCP не передаётся — HEAD-запрос, не GET) |
+| `scenario_list()` | сценарии автора, включая вебхук-сценарии (`sourceType: WEBHOOK`\|`BOT`) — в `list_graphs` вебхук-сценарии не входят |
+| `scenario_create(name, botId?)` | создать сценарий: без `botId` — вебхук-сценарий (сервер сам выпускает путь входа и секрет), с `botId` — бот-сценарий, сразу привязанный к боту |
+| `scenario_get(scenarioId)` | сценарий целиком — граф + `source` (у вебхук-сценария: путь/секрет входа) + `outputBinding` |
+| `scenario_update_source(scenarioId, botId?, channel?, recipientFrom?)` | привязка выхода вебхук-сценария, заменяется ЦЕЛИКОМ (без `botId` — привязка снимается, без `recipientFrom` — очищается); только для `sourceType:"WEBHOOK"` |
+| `scenario_publish(scenarioId)` | опубликовать вебхук-сценарий (бот-сценарий — через `publish_graph`) |
+| `scenario_rotate_secret(scenarioId)` | выпустить новый секрет входа вебхук-сценария — старый сразу перестаёт приниматься |
+| `agent_api_key_create(agentId, name?)` / `agent_api_key_list(agentId)` / `agent_api_key_revoke(agentId, keyId, confirm:true)` | API-ключи публичного чата агента (`zagt_...`, секрет виден один раз) — для `POST /api/public/agents/{agentId}/chat` без основного токена |
+| `ai_packs()` | каталог пакетов ответов ИИ сверх тарифа + текущий баланс (`aiPackAnswersLeft`) |
+| `ai_pack_purchase(sku, method?, confirm:true)` | купить пакет — возвращает ссылку на оплату, деньги не списываются этим вызовом |
 
 ### Рассылки
 
@@ -285,6 +340,20 @@ node skills/build-bot-funnel/validate.mjs path/to/import.json --platform=MAX
 
 ---
 
+## Перенос воронки из другого конструктора
+
+Есть готовая воронка в BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot или
+любом другом сервисе — скилл [`rebuild-funnel-from-builder`](skills/rebuild-funnel-from-builder/SKILL.md)
+учит агента перенести её в Retensy: разобрать export JSON/текст/скриншоты/пересказ → построить
+инвентарь блоков → сопоставить с реальными типами узлов Retensy (таблица в
+[reference/mapping.md](skills/rebuild-funnel-from-builder/reference/mapping.md)) → прямо спросить
+про то, что не мапится, вместо того чтобы выдумывать замену → собрать граф → проверить
+`validate.mjs`/`dry_run` → залить **новым** черновиком (никогда не поверх текущего сценария) →
+опубликовать только после явного подтверждения. Перенос самих подписчиков (не графа) — отдельно,
+через `migration_presets`/`migration_preview`/`migration_commit` (CSV).
+
+---
+
 ## Разработка
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retensy/mcp",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "MCP server to build and publish Telegram and MAX bot funnels/automations, broadcasts, service integrations, block-based websites (incl. free-layout Zero blocks, designs, templates, custom domains, form leads) and Markdown blog articles in the Retensy Bots service. Zero dependencies.",
   "type": "module",
   "bin": {
@@ -21,7 +21,7 @@
   "scripts": {
     "start": "node src/index.mjs",
     "check": "node --check src/index.mjs",
-    "test": "node scripts/smoke.mjs && node scripts/telemetry.test.mjs && node scripts/live-edit-422.test.mjs && node scripts/broadcast-connect.test.mjs && node scripts/integration-core.test.mjs && node scripts/site-init.test.mjs && node scripts/ai-agents.test.mjs && node scripts/battery-tools.test.mjs && node scripts/parity-tools.test.mjs && node scripts/parity-2.test.mjs && node scripts/validate-graph.test.mjs && node scripts/call-scenario.test.mjs && node scripts/audience-publications.test.mjs && node scripts/chains-analytics.test.mjs",
+    "test": "node scripts/smoke.mjs && node scripts/telemetry.test.mjs && node scripts/live-edit-422.test.mjs && node scripts/broadcast-connect.test.mjs && node scripts/integration-core.test.mjs && node scripts/site-init.test.mjs && node scripts/ai-agents.test.mjs && node scripts/battery-tools.test.mjs && node scripts/parity-tools.test.mjs && node scripts/parity-2.test.mjs && node scripts/validate-graph.test.mjs && node scripts/call-scenario.test.mjs && node scripts/audience-publications.test.mjs && node scripts/chains-analytics.test.mjs && node scripts/platform-decisions.test.mjs",
     "validate": "node skills/build-bot-funnel/validate.mjs"
   },
   "engines": {

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

@@ -73,8 +73,15 @@
   Бот должен быть админом канала/группы, иначе события оттуда не придут.
 - `TRIGGER_ANY_UPDATE` — `{}`, ловит ЛЮБОЙ апдейт. Приоритет самый низкий: срабатывает, только
   если не подошёл ни один конкретный триггер. Удобен как «ничего не понял» / отладка.
-- `TRIGGER_WEBHOOK` — `{}`, точка входа сценария с источником WEBHOOK (не бот). Такие сценарии
-  создаются в вебе; у графа бота этот триггер не сработает.
+- `TRIGGER_WEBHOOK` — `{}`, точка входа сценария с источником WEBHOOK (не бот); у графа БОТ-сценария
+  этот триггер не сработает. Такой сценарий создаётся `scenario_create(name)` без `botId` — сервер сам
+  выпускает путь входа и секрет (видны в `scenario_get` → `source.config`, ротируются `scenario_rotate_secret`);
+  узлы/рёбра — как у обычного графа, через `update_graph`/`edit_graph_live`/`patch_graph` по вернувшемуся id.
+  Выходной бот (кому слать ответ) задаётся/снимается отдельно через `scenario_update_source(scenarioId, botId?,
+  channel?, recipientFrom?)` — поле заменяется ЦЕЛИКОМ, без `botId` сценарий остаётся headless. Публикуется
+  такой сценарий `scenario_publish`, НЕ `publish_graph` (у него на source.type WEBHOOK — 409). Список своих
+  сценариев, включая вебхук-сценарии (их нет в `list_graphs`), — `scenario_list`; удаление — `delete_graph`
+  (тем же id). Собрать так же можно и в вебе — оба пути ведут в один и тот же объект.
   - **Внешние события интеграции** — тот же `TRIGGER_WEBHOOK`, но с заполненными
     `{ "provider": "<provider-ключ из integration_catalog, нижний регистр>", "connectionId": "<id из list_integrations>",
     "event": "<events[].key нужного события из inbound.events того же provider в integration_catalog>" }`.

package/skills/rebuild-funnel-from-builder/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: rebuild-funnel-from-builder
+description: Перенести воронку (сценарий бота) из другого конструктора — BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot или любого другого — в Retensy. На входе export JSON/текст, скриншоты редактора или устное описание воронки другого сервиса; на выходе валидный граф retensy-bot-graph, созданный НОВЫМ черновиком (никогда не перезаписывая существующий активный сценарий), проверенный validate.mjs/dry_run и опубликованный только после подтверждения пользователя. Использовать, когда пользователь просит «перенеси воронку из BotHelp/SaleBot/...», «импортируй бота с другого конструктора», присылает экспорт JSON/CSV другого сервиса, скриншоты его редактора сценариев или пересказывает словами, как была устроена воронка там.
+---
+
+# Перенос воронки из другого конструктора в Retensy
+
+Превращает воронку, собранную в ДРУГОМ сервисе (BotHelp, SaleBot, Senler, Leadteh, Smartsender,
+ManyChat, PuzzleBot — или любом не названном здесь), в валидный граф `retensy-bot-graph`. Источник —
+что угодно: export JSON/CSV, скопированный текст из экспорта, скриншоты экрана редактора, либо
+устный пересказ пользователем «как это было устроено».
+
+Это не альтернатива [`build-bot-funnel`](../build-bot-funnel/SKILL.md), а его надстройка для
+конкретного случая «source = чужой конструктор»: формат графа, типы узлов, правила валидатора,
+публикация — всё то же самое, описано там. Прочитай
+[`../build-bot-funnel/reference/schema.md`](../build-bot-funnel/reference/schema.md) и
+[`../build-bot-funnel/reference/validation.md`](../build-bot-funnel/reference/validation.md) —
+это единственный источник правды о том, какие типы узлов РЕАЛЬНО существуют в Retensy. Не выдумывай
+несуществующий тип узла только потому, что в другом конструкторе была похожая кнопка.
+
+## Когда применять
+
+Пользователь присылает экспорт/скриншоты/описание воронки ДРУГОГО бот-конструктора и просит её
+«перенести», «воссоздать», «импортировать», «сделать то же самое у нас». Если он просто описывает
+воронку своими словами без привязки к другому сервису — это обычный `build-bot-funnel`.
+
+## Рабочий процесс
+
+### 1. Собери вход и опиши его как инвентарь блоков
+
+Прими то, что есть, без требования единого формата:
+- **Export JSON/XML/CSV** другого конструктора — прочитай файл целиком, не фрагментом.
+- **Вставленный текст** экспорта (многие сервисы отдают воронку как список шагов текстом/таблицей).
+- **Скриншоты редактора** — опиши по ним каждый блок: тип, текст, кнопки и их подписи, куда ведёт
+  каждая кнопка (по стрелке или по названию следующего блока).
+- **Устный пересказ** — задавай уточняющие вопросы по узлам (см. п.3), не додумывай недостающее
+  самостоятельно без спроса.
+
+Построй **плоский инвентарь блоков** ДО всякого маппинга: порядковый номер/id в исходнике, тип блока
+как он назван у источника (напр. «Сообщение», «Условие», «Задержка», «Webhook», «Оплата»), текст/содержимое,
+исходящие связи (на какой блок/по какому условию). Это промежуточный список, который потом построчно
+переводится в узлы Retensy — не пропускай этот шаг и не иди сразу в генерацию JSON по памяти о скриншотах.
+
+### 2. Сопоставь концепции с типами узлов Retensy
+
+Таблица сопоставления — в [reference/mapping.md](reference/mapping.md): по каждому общему понятию
+builders (сообщение, кнопка, задержка, тег, переменная, условие/ветка, оплата, форма, интеграция,
+AI/бот-ответчик, рассылка, вебхук) — какой РЕАЛЬНЫЙ тип узла/конфиг Retensy его покрывает, и ссылка
+на точный раздел schema.md. Особенности конкретных источников (BotHelp, SaleBot, Senler, Leadteh,
+Smartsender, ManyChat, PuzzleBot) и частые ловушки каждого — там же.
+
+Общее правило маппинга: сопоставляй **по смыслу шага**, а не по названию блока источника. «Условие»
+в одном конструкторе может оказаться у нас `CONDITION` (да/нет), `BRANCH` (A/B) или `SWITCH`
+(детерминированный выбор по значению) — смотри, что блок реально делает.
+
+### 3. Зафиксируй немаппируемое и спроси пользователя
+
+После прохода по инвентарю у тебя будет три корзины:
+- **Маппится напрямую** — идёт в граф.
+- **Маппится с потерей/приближением** (напр. специфичный виджет оплаты источника → наш `issue_invoice`
+  без части его настроек) — помечай и предупреждай пользователя, что именно теряется.
+- **Не маппится вовсе** (нет такого типа узла/действия в Retensy — см. schema.md) — **не выдумывай
+  обходной путь молча**. Перечисли пользователю такие блоки списком («в источнике был блок X — в
+  Retensy аналога нет; варианты: пропустить / заменить на Y / реализовать иначе») и жди решения,
+  прежде чем собирать граф целиком. Это тот же принцип, что в `build-bot-funnel`: отказ инструмента
+  на несуществующую возможность уже регистрируется автоматически на сервере — тебе отдельно
+  дублировать это не нужно, просто не подменяй отсутствующее самоделкой.
+
+Не выдумывай маркетинговые тексты за пользователя — если текст сообщения не виден в источнике
+(обрезан на скриншоте, не указан в экспорте), спроси его или пометь `[ВСТАВЬ ТЕКСТ]` только если
+пользователь сам разрешил так делать.
+
+### 4. Построй граф
+
+Дальше — как в `build-bot-funnel`: дерево узлов и рёбер, у каждой кнопки-выбора свой `btn_N`,
+валидные UUID, хотя бы один корневой `TRIGGER_*`, без циклов вне `ASK_QUESTION`/`DELAY`/`SCHEDULE`,
+без узлов `END`. Все детали типов/конфигов — в schema.md, не здесь (чтобы не держать два
+расходящихся описания одного формата).
+
+Особенность переноса: исходная воронка почти всегда имела **одну** точку входа (команда/кнопка
+запуска у источника). Замени её на подходящий Retensy-триггер по платформе назначения
+(`TRIGGER_COMMAND` для Telegram/MAX, `TRIGGER_IG_DM`/`TRIGGER_IG_COMMENT`/... для Instagram) — см.
+раздел триггеров в schema.md и платформенные отличия в самом начале `build-bot-funnel/SKILL.md`.
+
+### 5. Проверь локально
+
+```bash
+node "<путь к build-bot-funnel>/validate.mjs" <путь к import.json>
+# Для IG-бота:
+node "<путь к build-bot-funnel>/validate.mjs" <путь к import.json> --platform=INSTAGRAM
+# Для MAX-бота:
+node "<путь к build-bot-funnel>/validate.mjs" <путь к import.json> --platform=MAX
+```
+
+Исправь всё, что покажет валидатор, прежде чем предлагать заливку.
+
+### 6. Залей как НОВЫЙ черновик — никогда не перезаписывай существующее
+
+Это главное отличие переноса из другого конструктора от обычной правки:
+- **Всегда `create_graph` (новый `graphId`) или `create_graph_from_template`**, затем `update_graph`.
+  Либо `import_funnel(botId, name, graph)` — он сам делает create → update → dry-run → publish, но
+  publish из него всё равно требует подтверждения (см. п.7) — не вызывай `import_funnel` раньше, чем
+  пользователь согласился на публикацию, либо вызови и объясни, что опубликованный результат — это
+  черновик, который он должен подтвердить, ещё раз, прежде чем переключать его в активный.
+- **Никогда не используй `edit_graph_live`, `patch_graph` или PUT в существующий `graphId`** для
+  результата переноса — это чужая, параллельно создаваемая воронка, а не правка уже работающего
+  сценария. Если у бота есть похожий/одноимённый старый граф — не трогай его.
+- Назови новый граф так, чтобы было видно происхождение, например `"Перенос из BotHelp — <название>"`.
+- Прогони `dry_run(graphId, kind:"command", value:"start")` (или подходящий триггер для IG) и
+  разбери `runStatus`.
+
+### 7. Публикуй только после подтверждения пользователя
+
+Собранный и провалидированный черновик — не значит «готово к продакшену». Покажи пользователю: сколько
+узлов/веток получилось, что промаплено с потерей (из п.3), что попало в `[ВСТАВЬ ТЕКСТ]`, ссылку/id
+графа. **Публикуй (`publish_graph`) и переключай на активный (`set_active_graph`) только по явному
+«ОК, публикуй» пользователя** — перенос почти всегда замещает текущую рабочую воронку бота, ошибка
+здесь стоит дороже, чем при сборке воронки с нуля.
+
+### 8. (Опционально) перенос подписчиков
+
+Перенос графа не переносит людей — это отдельный процесс через `migration_*` инструменты (CSV):
+- `migration_presets()` — какие источники/пресеты колонок уже знает сервис (BotHelp, SaleBot, Senler,
+  Leadteh, Smartsender, ManyChat, универсальный CSV).
+- `migration_preview(botId, path, platform, mapping?)` — без `mapping` вернёт подсказку сопоставления
+  колонок; с `mapping` — полный dry-run (ничего не пишет): сколько новых, сколько уже есть, нет ли
+  превышения лимита подписчиков тарифа.
+- `migration_commit(botId, path, platform, mapping)` — реальный импорт тем же `mapping`, что
+  подтвердил `migration_preview`. Делай только после явного согласия пользователя, как и публикацию
+  графа.
+
+Экспорт воронки (структуры сценария) ни один из этих сервисов документированно не отдаёт — поэтому
+граф всегда собирается по п.1–7, а `migration_*` покрывает только список подписчиков (CSV).
+
+## Важные ограничения
+
+- Если источник прислал JSON с кастомными типами блоков, которых нет у нас — **сначала** сверься со
+  schema.md, **потом** спрашивай пользователя (п.3). Никогда не придумывай тип узла по аналогии.
+- Как и `build-bot-funnel`, при распознавании с приватной доски (Miro и т.п.) надёжнее всего
+  CSV-экспорт из неё самой, а не попытка распознать скриншот холста.
+- Все лимиты и правила валидации графа (размер ≤4 МБ, длины текста, платные узлы/действия, лимиты
+  переменных) — те же, что в `build-bot-funnel`; не дублируются здесь.
+
+## Файлы скилла
+
+- [reference/mapping.md](reference/mapping.md) — таблица сопоставления понятий (сообщения, кнопки,
+  задержки, теги, переменные, условия, оплаты, формы) с реальными узлами Retensy + ловушки по
+  конкретным источникам (BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot).
+- [`../build-bot-funnel/reference/schema.md`](../build-bot-funnel/reference/schema.md) — формат графа
+  и единственный источник правды о типах узлов.
+- [`../build-bot-funnel/reference/validation.md`](../build-bot-funnel/reference/validation.md) —
+  правила валидатора и коды ошибок.
+- [`../build-bot-funnel/validate.mjs`](../build-bot-funnel/validate.mjs) — используй его же, отдельного
+  валидатора у этого скилла нет.

package/skills/rebuild-funnel-from-builder/reference/mapping.md

@@ -0,0 +1,95 @@
+# Таблица сопоставления: другой конструктор → Retensy
+
+Общие понятия, которые есть почти в любом bot-builder'е, и к чему они маппятся в `retensy-bot-graph`.
+Полные конфиги и правила валидатора — в [`../../build-bot-funnel/reference/schema.md`](../../build-bot-funnel/reference/schema.md)
+и [`validation.md`](../../build-bot-funnel/reference/validation.md) — здесь только «куда класть», не дублируем поля.
+
+## Таблица по концепциям
+
+| Концепция в источнике | Узел/конфиг Retensy | Примечания |
+|---|---|---|
+| Точка входа / команда запуска / приветственное сообщение | `TRIGGER_COMMAND` (`/start` и т.п., Telegram/MAX) | Для Instagram входа нет — `TRIGGER_IG_DM`/`TRIGGER_IG_COMMENT`/`TRIGGER_IG_STORY_REPLY`/`TRIGGER_IG_STORY_MENTION` |
+| Триггер по ключевому слову/тексту | `TRIGGER_TEXT` (`matchMode: ANY/EQUALS/CONTAINS/REGEX`) | |
+| Триггер по нажатию инлайн-кнопки (legacy callback без нашего авто-handle) | `TRIGGER_CALLBACK` | Для НОВЫХ кнопок-выборов отдельный триггер не нужен — используй рёбра `btn_N` от `SEND_MESSAGE` |
+| Сообщение / текстовый блок / карточка | `SEND_MESSAGE` (`config.text` + `cards[0]`) | Оба поля обязательны, см. `SEND_NO_TEXT` в validation.md |
+| Сообщение с фото/видео/документом/голосовым/кружком | `SEND_MESSAGE` с медиа-карточкой (`cards[].type`) или `SEND_PHOTO` | Файл заранее через `upload_file`, в графе хранится только URL |
+| Альбом/галерея фото | `SEND_MESSAGE` карточка `type:"gallery"`, `urls[]` | 2–10 картинок |
+| Инлайн-кнопка с выбором (ведёт к ветке сценария) | Кнопка `kind:"CALLBACK"` на `SEND_MESSAGE`, `value:""`, ребро `btn_N` | Непустой `value` ломает переход — см. `validation.md` |
+| Кнопка-ссылка (переход на внешний сайт) | Кнопка `kind:"URL"`, `value` = ссылка; `track:true` если нужно считать клики | Условие по клику — `CONDITION kind:"LINK_CLICKED"` |
+| Вопрос с ожиданием свободного ответа / сбор данных (имя/телефон/email) | `ASK_QUESTION` или `SEND_MESSAGE` с `awaitReply:true` + `saveTo`/`inputKind`/`validator` | Выходы `valid`/`invalid` |
+| Задержка / «подождать N часов/дней» | `DELAY kind:"FIXED"` (`durationSec`) | |
+| Отправка «завтра в HH:MM» | `DELAY kind:"TOMORROW"` | |
+| Отправка в конкретный момент / «через сутки после записи» | `DELAY kind:"UNTIL"` (`isoTimestamp`, опц. `offset`) | |
+| Запуск по расписанию (cron, ежедневная рассылка сводки и т.п.) | `TRIGGER_SCHEDULE` (`cron`, `timezone`) | Headless — без чата, отправка только через `config.target` |
+| Тег / метка подписчика | `ADD_TAG` / `REMOVE_TAG`, условие `CONDITION kind:"TAG"` | `tag` ∈ `[a-z0-9_-]{1,64}` |
+| Переменная / поле подписчика (custom field) | `SET_VARIABLE`, условие `CONDITION kind:"VARIABLE"` | `key` ∈ `[a-z_][a-z0-9_]{0,63}` |
+| Условие «если/иначе» (бинарное) | `CONDITION` (выходы `yes`/`no`) | `match: ALL/ANY` по списку `conditions[]` |
+| Условие со случайным сплитом (A/B тест) | `BRANCH` (`abTest:true`, выходы `case_<id>`) | |
+| Ветвление по значению переменной/коду ответа (больше двух исходов) | `SWITCH` (`expression`, `cases[].value`, выходы `case_<id>`+`default`) | Детерминированный выбор, не случайный |
+| Условие «подписан ли на канал» | `CONDITION kind:"SUBSCRIBED"` | Только Telegram/MAX |
+| Условие по UTM-метке | `CONDITION kind:"UTM"` | |
+| HTTP-запрос / вебхук наружу | Действие `external_request` в блоке `ACTIONS` | Платное действие; своих выходов нет — ветвиться по коду ответа через `saveStatusTo`+`SWITCH` |
+| Входящий вебхук от стороннего сервиса | `TRIGGER_WEBHOOK` (+ `provider`/`connectionId`/`event` для готовых интеграций) | |
+| Оплата / приём платежа | Действие `issue_invoice` в `ACTIONS` (НЕ отдельный узел) | `connectionId` подключения `provider=YOOKASSA`; ветка `paid` — если нужно ждать оплату в диалоге |
+| Триггер «оплата прошла» | `TRIGGER_PAYMENT` | Фильтр `minAmount`/`descriptionContains` обязателен, иначе срабатывает на любую оплату |
+| Форма на сайте / лендинге | `TRIGGER_SITE_FORM` (`siteId`, `formId`) | Только для своего опубликованного сайта в Retensy |
+| Интеграция с CRM (amoCRM, Битрикс24, GetCourse и т.п.) | Действия `amocrm_send`/`bitrix24_call`/`getcourse_send`/... в `ACTIONS` | Нужен `connectionId` из `list_integrations` |
+| Передача диалога оператору / «позвать менеджера» | Действие `agent_chat` в `ACTIONS` | Возврат — `dialog_handoff {active:false}` |
+| AI-ответчик / встроенный GPT-блок | `AI_REPLY` (`mode: "simple"` или `"agent"`) | Платный узел на любом тарифе; у режима `agent` нет выхода `next`, только именованные ветки |
+| Переход в другой сценарий / подворонку | Действие `call_scenario` в `ACTIONS` (`mode: "goto"`/`"call"`) | Ставится последним действием блока |
+| Рассылка по сегменту/тегу | Отдельный инструмент `broadcast_send`, НЕ узел графа | Описание — скилл `send-broadcast` |
+| Конец ветки / «стоп» | Ничего — ветка просто не имеет исходящих рёбер | **Не добавляй** узел `END`, его больше нет в палитре |
+
+## Особенности конкретных источников
+
+Эти сервисы не публикуют документированный формат экспорта воронки/сценария (только список
+подписчиков CSV-экспортом) — поэтому граф почти всегда переносится по скриншотам/пересказу, а не
+по машинному JSON. Ниже — на что обращать внимание при разборе каждого.
+
+- **BotHelp** — сценарии строятся из «блоков» с условными переходами по тегам и триггерам ключевых
+  слов; у BotHelp есть «цепочки» (broadcast-подобные серии сообщений с задержками) — переносятся как
+  последовательность `SEND_MESSAGE` + `DELAY`, а не как единая рассылка. Переменные BotHelp
+  (`{{переменная}}`) — проверь синтаксис конкретных полей (имя/телефон/UTM) и сопоставь с нашими
+  `{{var.*}}`/`{{from.*}}`.
+- **SaleBot** — активно использует HTTP-блоки («Внешний запрос») и JS-код внутри сценария. Код
+  (кастомная логика на JS) не маппится напрямую — спроси пользователя, что конкретно он делает, и
+  реализуй через `external_request`/`FORMULA`/`CONDITION`, либо зафиксируй как немаппируемое.
+- **Senler** — завязан на ВКонтакте (группы, UTM ВК). У Retensy VK — это публикации на стену
+  (`vk_post`), а не полноценный бот-конструктор ВК: диалоговые сценарии Senler ВК переносятся в
+  Telegram/MAX/Instagram-бота Retensy, это не 1:1 перенос платформы, предупреди пользователя.
+- **Leadteh** — похож на BotHelp по модели «блоки + условия по тегам»; отдельно стоит «воронка
+  продаж» (канбан-доска сделок) — это НЕ часть графа сценария, в Retensy ближайший аналог —
+  интеграция с внешней CRM (amoCRM/Битрикс24) через `ACTIONS`, не переноси как узлы графа.
+- **Smartsender** — мультиканальный (email + мессенджеры + SMS); переноси только мессенджер-ветку в
+  граф, email/SMS-рассылки за пределами диалога — отдельный процесс (не маппятся в узлы графа).
+- **ManyChat** — активно использует «Growth Tools» (виджеты входа с разных площадок — Ref URL, Click
+  Widget, Facebook Comments) и условные Smart Delay. Смарт-триггеры входа превращаются в один
+  подходящий `TRIGGER_*` Retensy (чаще `TRIGGER_COMMAND`/`TRIGGER_TEXT`); «Customer Chat» элементы
+  (facebook-специфика) обычно немаппируемы — фиксируй в корзине «не маппится».
+- **PuzzleBot** — конструктор на основе «кубиков» с явными condition-блоками по переменным/рефералам;
+  реферальная система (учёт кто кого привёл) не имеет прямого аналога в Retensy — переносится как
+  `SET_VARIABLE`/`CONDITION` вручную по переменной, зафиксируй ограничение пользователю.
+- **Любой другой источник, не названный выше** — та же методика: инвентарь → сопоставление по
+  смыслу шага (не по названию блока) → немаппируемое в отдельный список на подтверждение.
+
+## Частые ловушки при переносе (из любого источника)
+
+- **Кнопка-выбор с непустым `value`.** В исходнике кнопка часто хранит «значение» (тег/id ветки) —
+  при переносе в CALLBACK-кнопку Retensy это значение **не** переносится в поле `value` (оно должно
+  остаться `""`), переход задаётся только ребром `btn_N`. Если очень нужно явное значение — это
+  отдельный узел `TRIGGER_CALLBACK`, а не кнопка-выбор.
+- **Задержки в других единицах.** Источники часто пишут задержку как «1440 минут» или «1 день» —
+  переведи в секунды (`durationSec`) аккуратно, не копируй число как есть в другое поле.
+- **HTML/markdown разметка текста.** Форматирование источника (жирный/курсив/ссылки) почти никогда
+  не совпадает байт-в-байт с безопасным Telegram-HTML Retensy (`b,strong,i,em,u,ins,s,strike,del,code,pre,a[href],tg-spoiler,br`).
+  Если не уверен, что разметка пройдёт — ставь `parseMode:"PLAIN"` и убери теги.
+  Пустой экран над таблицей выбора кнопок — тоже источник незаметной потери контента, см. п.1 скилла
+  (сначала инвентарь, потом граф).
+- **«Условие» в источнике — не всегда `CONDITION`.** Если исходный блок на самом деле случайно
+  делит аудиторию (A/B) — это `BRANCH`, а не `CONDITION`; если выбирает по значению из списка
+  вариантов — это `SWITCH`. Смотри поведение, не название.
+- **Платные блоки источника vs платные узлы Retensy не совпадают 1:1.** AI-блок / внешний запрос /
+  оплата — в Retensy тоже платные (`PREMIUM_NODE_FORBIDDEN`/`PREMIUM_NODES`) независимо от того,
+  был ли эквивалент бесплатным в источнике — предупреди пользователя при переносе таких блоков.
+- **Не копируй ID узлов источника как ID узлов Retensy.** Нужны валидные UUID (п.4 skill) —
+  генерируй новые, при необходимости сохраняя исходные имена/заголовки в `_title` для трассируемости.

package/src/index.mjs

@@ -27,7 +27,7 @@ import os from "node:os";
 import fs from "node:fs";
 import path from "node:path";
 
-const VERSION = "0.23.0";
+const VERSION = "0.24.0";
 /** С чего начать пустой сайт (init у /document/ops; на сайте с черновиком игнорируется). */
 const SITE_INITS = ["starter", "blank", "mini-landing"];
 /** Безвредная операция, когда нужен только init: бэкенд не принимает пустой ops[]. */
@@ -889,7 +889,7 @@ const TOOLS = [
   { name: "rename_graph", description: "Переименовать сценарий (работает и для опубликованных — имя не влияет на исполнение).", inputSchema: { type: "object", properties: { graphId: { type: "string" }, name: { type: "string" } }, required: ["graphId", "name"] } },
   { name: "clone_graph", description: "Склонировать граф в новый DRAFT «… (copy)» — безопасно итерировать поверх опубликованного. Клон сценария-вебхука получает собственный путь и секрет вебхука.", inputSchema: { type: "object", properties: { graphId: { type: "string" } }, required: ["graphId"] } },
   { name: "copy_graph", description: "Скопировать граф в ДРУГОГО бота (в т.ч. на другую платформу). Возвращает {graphId, sourcePlatform, targetPlatform, notes[]}. notes[] помечают, что адаптировано (severity=TRANSFORM, напр. вопрос-контакт → ввод телефона текстом), что требует ручной правки (MANUAL, напр. условие SUBSCRIBED в MAX) и особенности платформы (INFO). Авто-адаптация узлов реализована для Telegram⇄MAX; при копировании в/из Instagram-бота граф копируется без трансформаций — несовместимые узлы будут отмечены при публикации (IG-allowlist). preview=true — только проверка совместимости, без копирования. Тот же бот запрещён (для дублирования есть clone_graph). Копия сценария-вебхука становится обычным сценарием бота-получателя (вход по вебхуку не переносится).", inputSchema: { type: "object", properties: { graphId: { type: "string" }, targetBotId: { type: "string", description: "id бота-получателя (см. list_bots)" }, preview: { type: "boolean", description: "true = только отчёт о совместимости, ничего не сохраняется" } }, required: ["graphId", "targetBotId"] } },
-  { name: "delete_graph", description: "Удалить граф. Активный (опубликованный и назначенный боту) удалить нельзя — будет 409; сначала переключи активный через set_active_graph.", inputSchema: { type: "object", properties: { graphId: { type: "string" } }, required: ["graphId"] } },
+  { name: "delete_graph", description: "Удалить граф (DELETE /api/bots/graphs/{id}) — тот же эндпоинт удаляет и вебхук-сценарий (scenarioId из scenario_list/scenario_create — это id того же графа). Активный (опубликованный и назначенный боту) удалить нельзя — будет 409; сначала переключи активный через set_active_graph. Необратимо.", inputSchema: { type: "object", properties: { graphId: { type: "string" } }, required: ["graphId"] } },
   { name: "set_active_graph", description: "Назначить, какой опубликованный граф активен у бота (переключение живого сценария без перепубликации). HTTP 409 — граф не опубликован или это сценарий-вебхук (источник WEBHOOK — такой включается своей публикацией в вебе).", inputSchema: { type: "object", properties: { botId: { type: "string" }, graphId: { type: "string" } }, required: ["botId", "graphId"] } },
   { name: "upload_file", description: "Загрузить файл в библиотеку /bots/files (POST /api/bots/media) и получить публичный URL для вставки в сценарий. Передай path (локальный файл) ИЛИ url (перезалить файл по ссылке в своё хранилище). Возвращает {id, url, mediaType, sizeBytes, originalName}. Полученный url ставь в медиа-карточку SEND_MESSAGE (image/video/audio/file/voice/videonote → поле url; gallery → urls[]) или в SEND_PHOTO.photoUrl. Лимит 50 МБ; типы: image/video/audio/pdf/zip/doc(x)/xlsx/pptx/txt (SVG запрещён); при нехватке места — HTTP 402.", inputSchema: { type: "object", properties: { path: { type: "string", description: "Путь к локальному файлу (поддерживается ~)" }, url: { type: "string", description: "Ссылка на файл — будет скачан и перезалит в /bots/files" }, filename: { type: "string", description: "Переопределить имя файла (необязательно)" } } } },
   { name: "list_files", description: "Список файлов в библиотеке /bots/files (GET /api/bots/media) + использовано/лимит байт. Бери готовые url отсюда, чтобы не загружать одно и то же повторно.", inputSchema: { type: "object", properties: {} } },
@@ -1052,6 +1052,20 @@ const TOOLS = [
   { name: "agent_tool_test", description: "Проверить инструмент агента напрямую, БЕЗ модели (POST /api/bots/agents/{agentId}/tools/{toolId}/test): params — аргументы вызова (AMO_LOOKUP: query ИЛИ leadId; SHEETS_LOOKUP: value; HTTP_API: имена из httpParams этого инструмента). Проверяет только конфиг инструмента (подключение amoCRM/таблицу Sheets/URL) — модель не вызывается, бюджет ИИ не тратится. {ok:true, result} при успехе; ошибка конфига/внешнего сервиса — HTTP 400 {ok:false, error} с причиной на русском (никогда не 500). toolId — id инструмента из agent_get → tools[].id (настраивается через agent_update {patch:{tools:[...]}})." , inputSchema: { type: "object", properties: { agentId: { type: "string" }, toolId: { type: "string" }, params: { type: "object", description: "Аргументы вызова инструмента (см. описание)" } }, required: ["agentId", "toolId"] } },
   // ---- Заявки сайта: файлы вложений ----
   { name: "site_lead_file_download", description: "Метаданные и ссылка на скачивание файла из заявки сайта (GET /api/bots/pages/{siteId}/leads/{leadId}/files/{fileId}, владелец/ADMIN сайта). Байты файла НЕ передаются через MCP (может быть большим/бинарным) — инструмент делает HEAD-запрос, чтобы подтвердить, что файл принадлежит этой заявке (404 иначе), и вернуть {fileId, fileName, contentType, sizeBytes, downloadUrl}. downloadUrl отдаёт файл только с тем же токеном, что у этого MCP (заголовок Authorization: Bearer zmcp_...), — скачай curl'ом с этим заголовком или открой заявку в кабинете (сайт → «Заявки»). Список файлов заявки с теми же полями уже есть в site_leads (поле files[] каждой заявки) — этот инструмент нужен, только когда нужна именно прямая ссылка на скачивание одного файла.", inputSchema: { type: "object", properties: { siteId: { type: "string" }, leadId: { type: "string" }, fileId: { type: "string" } }, required: ["siteId", "leadId", "fileId"] } },
+  // ---- Вебхук-сценарии (/api/scenarios, PAT-доступ открыт решением владельца 14.10) ----
+  { name: "scenario_list", description: "Сценарии автора (GET /api/scenarios): [{id, name, status, active, sourceType: BOT|WEBHOOK, botId}] — включая вебхук-сценарии (в list_graphs их нет, см. его описание). sourceType WEBHOOK — свой вход по адресу (path+secret в scenario_get), выход — произвольный бот через scenario_update_source; BOT — живёт в графах привязанного бота (тот же объект, что и в list_graphs/get_graph этого бота). Read-only.", inputSchema: { type: "object", properties: {} } },
+  { name: "scenario_create", description: "Создать сценарий (POST /api/scenarios), пустым — узлы/рёбра потом через update_graph/edit_graph_live по id из ответа. botId не передан → вебхук-сценарий (source.type WEBHOOK): сервер сам выпускает путь входа и секрет (видны в scenario_get, ротируются scenario_rotate_secret), выходной бот задаётся отдельно через scenario_update_source. botId передан → бот-сценарий (source.type BOT), сразу привязан к этому боту — нужен доступ на редактирование его графов (owner/EDITOR/ADMIN), иначе 403/404; публикуется он уже через publish_graph, не через scenario_publish. Лимит сценариев тарифа — HTTP 402.", inputSchema: { type: "object", properties: { name: { type: "string" }, botId: { type: "string", description: "UUID бота — делает сценарий бот-сценарием вместо вебхук-сценария" } }, required: ["name"] } },
+  { name: "scenario_get", description: "Сценарий по id (GET /api/scenarios/{id}) — тот же граф, что get_graph, плюс source: {type: BOT|WEBHOOK, config: у WEBHOOK path/secret входа и (если задан) botId выхода, у BOT — только botId} и outputBinding {channel, recipientFrom}. Свой сценарий — всегда; чужой бот-сценарий — если есть доступ к боту (как GET .../graphs/{id}); чужой вебхук-сценарий — 404 (в нём секрет входа, виден только автору).", inputSchema: { type: "object", properties: { scenarioId: { type: "string" } }, required: ["scenarioId"] } },
+  { name: "scenario_update_source", description: "Привязка выхода вебхук-сценария, ЦЕЛИКОМ заменяет текущую (PUT /api/scenarios/{id}/source) — только у source.type WEBHOOK, у BOT-сценария 409. botId — бот-выход (нужен доступ на редактирование его графов — owner/EDITOR/ADMIN, иначе 403/404); НЕ передан → привязка снимается, сценарий остаётся headless без бота. channel — OutputChannel: TG_BOT_API (обычный Bot API Telegram/MAX) | TG_USERBOT | IG | MAX; не передан — прежнее значение сохраняется. recipientFrom — откуда брать chatId получателя (например \"CHAT\" — чат-инициатор, или имя переменной сценария); НЕ передан → очищается в пустую строку (поле не частичное — шли его всегда, если хочешь сохранить текущее значение, сначала прочитай scenario_get). У опубликованного сценария новая привязка применяется сразу; если она добавляет НОВЫЕ ошибки проверки (платформа/лимит), которых не было при старой, — HTTP 422 со всеми code@nodeId, ничего не сохранено (уже имевшиеся ошибки не блокируют).", inputSchema: { type: "object", properties: { scenarioId: { type: "string" }, botId: { type: "string", description: "UUID бота-выхода; опусти, чтобы снять привязку" }, channel: { type: "string", enum: ["TG_BOT_API", "TG_USERBOT", "IG", "MAX"] }, recipientFrom: { type: "string", description: "Не передашь — очистится в пустую строку" } }, required: ["scenarioId"] } },
+  { name: "scenario_publish", description: "Опубликовать вебхук-сценарий (POST /api/scenarios/{id}/publish) — только source.type WEBHOOK (у BOT-сценария 409, публикуй через publish_graph). Те же проверки, что у publish_graph (узлы/лимиты/платформа выходного бота, если он задан): отказ → HTTP 422 со всеми причинами построчно (code@nodeId: message), ничего не опубликовано.", inputSchema: { type: "object", properties: { scenarioId: { type: "string" } }, required: ["scenarioId"] } },
+  { name: "scenario_rotate_secret", description: "Выпустить новый секрет входа вебхук-сценария (POST /api/scenarios/{id}/rotate-secret) — старый сразу перестаёт приниматься. Секрет виден в ответе этого вызова и в scenario_get (source.config.secret) — это собственный секрет сценария для настройки его входящего вебхука, не чужой секрет интеграции.", inputSchema: { type: "object", properties: { scenarioId: { type: "string" } }, required: ["scenarioId"] } },
+  // ---- Публичный API ИИ-агента: ключи (решение владельца 14.10) ----
+  { name: "agent_api_key_create", description: "Выпустить API-ключ публичного чата агента (POST /api/bots/agents/{agentId}/api-keys): один ключ работает только с ЭТИМ агентом (не аккаунтом целиком, в отличие от zmcp-токена). Секрет (вид zagt_...) виден ТОЛЬКО в этом ответе — дальше хранится лишь хеш; сохрани/покажи пользователю сразу, повторно его не получить. До 20 активных ключей на агента — сверх лимита HTTP 409 TOO_MANY_KEYS, сначала отзови лишний (agent_api_key_revoke). Ключ шлют заголовком Authorization: Bearer <ключ> на POST /api/public/agents/{agentId}/chat (публичный чат агента, без zmcp-токена/сессии) — {conversationId?, message (1–1000 симв.), metadata?} → {reply, conversationId, sources?}; 30 запросов/мин на ключ (429 иначе), агент должен быть опубликован (agent_publish).", inputSchema: { type: "object", properties: { agentId: { type: "string" }, name: { type: "string", description: "Название ключа для списка, например «Виджет на сайте»" } }, required: ["agentId"] } },
+  { name: "agent_api_key_list", description: "Список API-ключей агента (GET /api/bots/agents/{agentId}/api-keys): {id, name, keyPrefix, createdAt, lastUsedAt} — без секрета (key:null), секрет виден только один раз при agent_api_key_create. Read-only.", inputSchema: { type: "object", properties: { agentId: { type: "string" } }, required: ["agentId"] } },
+  { name: "agent_api_key_revoke", description: "Отозвать API-ключ агента (DELETE /api/bots/agents/{agentId}/api-keys/{keyId}) — публичный чат с этим ключом сразу перестаёт отвечать (401). keyId — из agent_api_key_list. Необратимо: только по явной просьбе пользователя, с confirm:true.", inputSchema: { type: "object", properties: { agentId: { type: "string" }, keyId: { type: "string" }, confirm: { type: "boolean" } }, required: ["agentId", "keyId", "confirm"] } },
+  // ---- Пакеты ответов ИИ сверх тарифа (решение владельца 14.10) ----
+  { name: "ai_packs", description: "Пакеты ответов ИИ сверх месячного бюджета тарифа: каталог (GET /api/bots/ai-packs) — [{sku, answers, priceRub, kopecks}] (ai_pack_1000 — 1000 ответов/490₽, ai_pack_5000 — 5000/1990₽, ai_pack_20000 — 20000/6990₽; kopecks — внутренняя единица бюджета, справочно, не присылай её). Плюс баланс — aiPackAnswersLeft/aiPackTokensLeft из GET /api/bots/subscription: пакет не сгорает без активного тарифа, но списывается только при нём, ПОСЛЕ месячного бюджета тарифа, FIFO по старшинству покупки (сначала самый старый). Read-only; купить — ai_pack_purchase.", inputSchema: { type: "object", properties: {} } },
+  { name: "ai_pack_purchase", description: "ЭТО ПЛАТЁЖ, не покупка напрямую. Купить пакет ответов ИИ (POST /api/bots/ai-packs/purchase {sku, method}): тот же конвейер оплаты (ЮKassa/крипта), что у смены тарифа — ответ НЕ списывает деньги сам, а возвращает invoiceUrl, ссылку на оплату; пакет зачислится на баланс только после подтверждения платежа пользователем в браузере. sku — из ai_packs; method — \"card\" (по умолчанию), как у subscribe. Только по явной просьбе пользователя, с confirm:true.", inputSchema: { type: "object", properties: { sku: { type: "string", description: "sku из ai_packs, например ai_pack_5000" }, method: { type: "string", description: "card (по умолчанию) и т.п., как у subscribe" }, confirm: { type: "boolean" } }, required: ["sku", "confirm"] } },
 ];
 
 async function handleCall(params) {
@@ -2112,6 +2126,77 @@ async function handleCall(params) {
       const meta = await siteLeadFileHead(siteId, leadId, fileId);
       return okResult({ ...meta, authHint: "Скачать: curl -H \"Authorization: Bearer <твой zmcp_-токен>\" \"<downloadUrl>\" -o файл — либо открой заявку в кабинете (сайт → «Заявки»)." });
     }
+    // ---- Вебхук-сценарии ----
+    case "scenario_list": return okResult(await api("/api/scenarios"));
+    case "scenario_create": {
+      const name = String(a.name ?? "").trim();
+      if (!name) throw new Error("Передай name — название сценария.");
+      const source = a.botId != null && String(a.botId).trim() !== ""
+        ? { type: "BOT", config: { botId: uuidArg(a.botId, "botId") } }
+        : { type: "WEBHOOK", config: {} };
+      return okResult(await api("/api/scenarios", { method: "POST", body: { name, source } }));
+    }
+    case "scenario_get": return okResult(await api(`/api/scenarios/${uuidArg(a.scenarioId, "scenarioId")}`));
+    case "scenario_update_source": {
+      const scenarioId = uuidArg(a.scenarioId, "scenarioId");
+      const body = {
+        botId: a.botId != null && String(a.botId).trim() !== "" ? uuidArg(a.botId, "botId") : null,
+        channel: a.channel != null ? enumArg(a.channel, "channel", ["TG_BOT_API", "TG_USERBOT", "IG", "MAX"]) : null,
+        recipientFrom: a.recipientFrom != null ? String(a.recipientFrom) : null,
+      };
+      try {
+        return okResult(await api(`/api/scenarios/${scenarioId}/source`, { method: "PUT", body }));
+      } catch (e) {
+        if (e.status === 409) throw new Error("Это не вебхук-сценарий (source.type BOT) — у бот-сценария выход не перепривязывается, это сам бот графа.");
+        throw e;
+      }
+    }
+    case "scenario_publish": {
+      try {
+        return okResult(await api(`/api/scenarios/${uuidArg(a.scenarioId, "scenarioId")}/publish`, { method: "POST" }));
+      } catch (e) {
+        if (e.status === 409) throw new Error("Это не вебхук-сценарий (source.type BOT) — публикуй через publish_graph.");
+        throw e;
+      }
+    }
+    case "scenario_rotate_secret": return okResult(await api(`/api/scenarios/${uuidArg(a.scenarioId, "scenarioId")}/rotate-secret`, { method: "POST" }));
+    // ---- Публичный API ИИ-агента: ключи ----
+    case "agent_api_key_list": return okResult(await api(`/api/bots/agents/${idArg(a.agentId, "agentId")}/api-keys`));
+    case "agent_api_key_create": {
+      const body = {};
+      if (a.name != null && String(a.name).trim() !== "") body.name = String(a.name).trim();
+      try {
+        return okResult(await api(`/api/bots/agents/${idArg(a.agentId, "agentId")}/api-keys`, { method: "POST", body }));
+      } catch (e) {
+        if (e.status === 409) throw new Error("До 20 активных ключей на агента — сначала отзови лишний (agent_api_key_revoke).");
+        throw e;
+      }
+    }
+    case "agent_api_key_revoke": {
+      const agentId = idArg(a.agentId, "agentId");
+      const keyId = idArg(a.keyId, "keyId");
+      if (a.confirm !== true) throw new Error("Отзыв ключа необратим: публичный чат с ним сразу перестанет отвечать. Спроси пользователя и повтори с confirm:true.");
+      await api(`/api/bots/agents/${agentId}/api-keys/${keyId}`, { method: "DELETE" });
+      return okResult(`🗑️ Ключ ${keyId} отозван.`);
+    }
+    // ---- Пакеты ответов ИИ ----
+    case "ai_packs": {
+      const [skus, sub] = await Promise.all([
+        api("/api/bots/ai-packs"),
+        api("/api/bots/subscription").catch(() => null),
+      ]);
+      return okResult({
+        skus,
+        balance: sub ? { aiPackAnswersLeft: sub.aiPackAnswersLeft, aiPackTokensLeft: sub.aiPackTokensLeft } : null,
+      });
+    }
+    case "ai_pack_purchase": {
+      const sku = String(a.sku ?? "").trim();
+      if (!sku) throw new Error("Передай sku — из ai_packs.");
+      if (a.confirm !== true) throw new Error("Это платёж. Спроси пользователя и повтори с confirm:true.");
+      const r = await api("/api/bots/ai-packs/purchase", { method: "POST", body: { sku, method: a.method || "card" } });
+      return okResult({ ...r, hint: "Пакет зачислится после подтверждения оплаты по invoiceUrl — ничего не списано автоматически." });
+    }
     default:
       throw new Error(`Неизвестный инструмент: ${params && params.name}`);
   }