@retensy/mcp 0.50.0 → 0.52.0

package/README.md

@@ -224,8 +224,8 @@ MCP-сервер (+ скилл для Claude Code) для **сборки и пу
 | `site_list()` | сайты пользователя (id, mode, url, publishedRevision, status — `BLOCKED` у заблокированных модерацией, blockedReason) |
 | `site_create(title, slug?, template?)` | новый сайт из блоков → `id`; `template` (`starter`/`blank`/`mini-landing`/`shop-starter`) — сразу черновик из шаблона; число сайтов ограничено тарифом — сверх лимита HTTP 402 с причиной и ссылкой на смену тарифа |
 | `site_get(siteId, saveToFile?)` | модель сайта (`revision`, `draft`, `versions[]` публикаций) |
-| `site_schema()` | JSON Schema модели и операций — читать перед правкой |
-| `site_edit(siteId, ops[]?, revision?, init?)` | правка операциями (`init`: `starter`/`blank`/`mini-landing`/`shop-starter`; только `init` — черновик из шаблона), всё или ничего: страницы и папки, блоки, Zero-элементы, код блока (`get/set/add_block_code`), дизайны и их кадры, шаблоны (`add_template`), тема, попапы; пиксели аналитики (GA4/GTM/Meta/VK/Яндекс.Метрика) — тоже сюда, `set_settings {analytics: {...}}` (отдельного инструмента нет — те же `settings.analytics` модели сайта, валидируются форматом id на сервере) |
+| `site_schema(full?)` | компактный справочник модели и операций (~10 КБ); `full:true` — полная JSON Schema — читать перед правкой |
+| `site_edit(siteId, ops[]?, revision?, init?, reset?)` | правка операциями (`init`: `starter`/`blank`/`mini-landing`/`shop-starter`; только `init` — черновик из шаблона; `reset:true` с `init` и `revision` — пересобрать черновик из шаблона, деструктивно), всё или ничего: страницы и папки, блоки, Zero-элементы, код блока (`get/set/add_block_code`), дизайны и их кадры, шаблоны (`add_template`), тема, попапы; пиксели аналитики (GA4/GTM/Meta/VK/Яндекс.Метрика) — тоже сюда, `set_settings {analytics: {...}}` (отдельного инструмента нет — те же `settings.analytics` модели сайта, валидируются форматом id на сервере) |
 | `site_templates(category?, full?)` | библиотека шаблонов блоков для `add_template` |
 | `site_publish(siteId)` | опубликовать черновик → `url` |
 | `site_rollback(siteId, revision)` | вернуть прошлую публикацию |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retensy/mcp",
-  "version": "0.50.0",
+  "version": "0.52.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/agent-write-tools.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 && node scripts/token-scopes.test.mjs && node scripts/secondary-graphs.test.mjs && node scripts/graph-versions.test.mjs && node scripts/templates-filter.test.mjs && node scripts/agent-tests.test.mjs && node scripts/catalog.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/agent-write-tools.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 && node scripts/token-scopes.test.mjs && node scripts/secondary-graphs.test.mjs && node scripts/graph-versions.test.mjs && node scripts/templates-filter.test.mjs && node scripts/agent-tests.test.mjs && node scripts/catalog.test.mjs && node scripts/confirm-409.test.mjs",
     "validate": "node skills/build-bot-funnel/validate.mjs"
   },
   "engines": {

package/src/catalog.mjs

@@ -150,14 +150,27 @@ function hash(s) {
   return h.toString(16).padStart(8, "0");
 }
 
+/** Что изменится: summary.text от сервера (diff узлов/блоков, получатели), иначе общий message. */
+function changeSummary(data) {
+  const sum = data?.step?.confirm?.summary;
+  if (!sum || typeof sum !== "object") return "";
+  const parts = [];
+  if (typeof sum.text === "string" && sum.text) parts.push(sum.text);
+  if (typeof sum.recipients === "number") parts.push(`Получателей: ${sum.recipients}.`);
+  if (sum.irreversible === true) parts.push("Действие необратимо.");
+  return parts.join(" ");
+}
+
 /** Ответ invoke → результат MCP. 409 needsConfirmation — не ошибка сервиса, а просьба спросить человека. */
 export function confirmationText(data) {
   if (data && typeof data === "object" && data.needsConfirmation === true) {
     const msg = typeof data.message === "string" ? data.message : "";
+    const what = changeSummary(data);
+    const head = ["Нужно подтверждение пользователя.", what && !msg.includes(what) ? `Что изменится: ${what}` : "", msg].filter(Boolean).join(" ");
     if (typeof data.confirmToken === "string" && data.confirmToken) {
-      return `⚠️ Нужно подтверждение пользователя. ${msg} Опиши пользователю, что именно будет сделано, получи его явное согласие и повтори вызов с ТЕМИ ЖЕ аргументами плюс confirmToken: "${data.confirmToken}" (токен привязан к этим аргументам и действует 5 минут).`.trim();
+      return `⚠️ ${head} Опиши пользователю, что именно будет сделано, получи его явное согласие и повтори вызов с ТЕМИ ЖЕ аргументами плюс confirmToken: "${data.confirmToken}" (токен одноразовый, привязан к этим аргументам и действует 5 минут; если состояние изменилось, придёт новый запрос — покажи пользователю новое описание).`.trim();
     }
-    return `⚠️ Нужно подтверждение пользователя. ${msg}`.trim();
+    return `⚠️ ${head}`.trim();
   }
   return null;
 }

package/src/index.mjs

@@ -1079,7 +1079,7 @@ const TOOLS = [
   { name: "site_list", description: "Сайты (раздел «Страницы», GET /api/bots/pages): id, title, mode (BLOCKS — сайт из блоков, CODE — файлы/Mini App), url (основной адрес), publishedRevision, status (ACTIVE | BLOCKED — заблокирован модерацией: посетители видят HTTP 451, удалить такой сайт нельзя — 409) и blockedReason. Включает и свои сайты, и сайты команды проекта (привязанные к боту, где тебя пригласили) — у каждого accessRole (OWNER/ADMIN/EDITOR/VIEWER), у чужих — ownerName. Доступ проверяется на каждый вызов. Read-only.", inputSchema: { type: "object", properties: {} } },
   { name: "site_create", description: "Создать сайт из блоков (POST /api/bots/pages, mode=BLOCKS). Возвращает id. Дальше: site_edit (init=starter — стартовый лендинг, init=blank — пустая главная, init=mini-landing — мини-лендинг с кнопками мессенджеров, init=shop-starter — многостраничный магазин: главная, каталог, о нас, доставка, контакты, политика конфиденциальности, оферта, корзина; общие шапка и подвал) → site_publish. template (starter|blank|mini-landing|shop-starter) — сразу создать черновик из шаблона (как «Мини-лендинг» в редакторе), в ответе revision. slug — «название» в адресе pages.retensy.com/<id>/<slug>/ (необязательно, по умолчанию транслит title). Число сайтов ограничено тарифом (free — 1, «Старт» — 3, «Про» — 10, с «Бизнеса» — без лимита): сверх лимита — HTTP 402 с причиной и upgradeUrl (смена тарифа только в браузере, передай ссылку пользователю). Заблокированный модерацией сайт в site_list имеет status=BLOCKED и blockedReason, посетители видят HTTP 451.", inputSchema: { type: "object", properties: { title: { type: "string" }, slug: { type: "string" }, template: { type: "string", enum: ["starter", "blank", "mini-landing", "shop-starter"] } }, required: ["title"] } },
   { name: "site_get", description: "Модель сайта из блоков (GET /api/bots/pages/{siteId}/document): revision, draft (SiteModel: theme, globals.header/footer, pages[].blocks[], popups[]) — id страниц/блоков/попапов нужны для site_edit. draft=null — сайт пуст (первый site_edit создаст его). saveToFile — записать модель на диск и вернуть путь.", inputSchema: { type: "object", properties: { siteId: { type: "string" }, saveToFile: { type: "string" } }, required: ["siteId"] } },
-  { name: "site_schema", description: "JSON Schema модели сайта (model) и операций правки (ops) — какие блоки и поля бывают (GET /api/bots/pages/schema). Читай перед первой правкой.", inputSchema: { type: "object", properties: {} } },
+  { name: "site_schema", description: "Компактный справочник модели сайта и операций правки (ops) — какие блоки и поля бывают (GET /api/bots/pages/schema, ~10 КБ). Читай перед первой правкой. full:true — полная JSON Schema (GET ?full=true), большая.", inputSchema: { type: "object", properties: { full: { type: "boolean", description: "true = полная JSON Schema вместо компактного справочника" } } } },
   { name: "site_edit", description: "Правка сайта операциями — всё или ничего (POST /api/bots/pages/{siteId}/document/ops). " +
     "Страницы: add_page{title} · update_page{pageId,patch: {title?, path?, seo?{title,description,noindex,ogTitle,ogDescription,ogImage}, showHeader?, showFooter?, folder?}} · remove_page{pageId} · move_page{pageId,delta}. " +
     "Папки страниц: add_folder{name} (id в results) · rename_folder{folderId,name} · remove_folder{folderId}; страница в папку — update_page{pageId, patch:{folder: folderId}}. " +
@@ -1091,8 +1091,8 @@ const TOOLS = [
     "Zero-kinds form/product-list/product: form — props.form как у блока form (fields, submitText); product-list — props: categoryId?, limit, columns (значения по экранам {d, t?, m?}); product — productId обязателен (товар из каталога). Новые Zero-блоки создаются с артбордами 1440/768/390 (d/t/m). " +
     "Сайт: set_global{slot: header|footer, on} · set_theme{theme} · set_settings{settings} · add_popup{name} · update_popup{popupId,name?,width?} · remove_popup{popupId}. " +
     "props/style/theme/frame — JSON Merge Patch (null удаляет ключ, массивы заменяются целиком). Типы блоков: header, cover, text, image, gallery, buttons, features, form, video, html, spacer, footer, zero, messengers. " +
-    "Значения по экранам: {d, t?, m?} (десктоп/планшет/телефон). revision — защита от перезаписи (409, если сайт изменили); init (starter|blank|mini-landing|shop-starter) — с чего начать пустой сайт (на сайте с черновиком игнорируется); shop-starter — многостраничный магазин (главная, каталог, о нас, доставка, контакты, политика, оферта, корзина; общие шапка и подвал); только init без ops — создать черновик из шаблона. " +
-    "Ответ: новая revision и results[] с id созданного (и code у get_block_code). Ошибки — HTTP 422 с путями. Тариф: HTML-блок и HTML-элемент Zero публикуются только на платном тарифе (422 при site_publish).", inputSchema: { type: "object", properties: { siteId: { type: "string" }, ops: { type: "array", items: { type: "object" } }, revision: { type: "number" }, init: { type: "string", enum: ["starter", "blank", "mini-landing", "shop-starter"] } }, required: ["siteId"] } },
+    "Значения по экранам: {d, t?, m?} (десктоп/планшет/телефон). revision — защита от перезаписи (409, если сайт изменили); init (starter|blank|mini-landing|shop-starter) — с чего начать пустой сайт (на сайте с черновиком игнорируется); shop-starter — многостраничный магазин (главная, каталог, о нас, доставка, контакты, политика, оферта, корзина; общие шапка и подвал); только init без ops — создать черновик из шаблона. reset:true (с init и revision) — пересобрать существующий черновик из шаблона init, ДЕСТРУКТИВНО (текущий черновик заменяется). " +
+    "Ответ: новая revision и results[] с id созданного (и code у get_block_code). Ошибки — HTTP 422 с путями. Тариф: HTML-блок и HTML-элемент Zero публикуются только на платном тарифе (422 при site_publish).", inputSchema: { type: "object", properties: { siteId: { type: "string" }, ops: { type: "array", items: { type: "object" } }, revision: { type: "number" }, init: { type: "string", enum: ["starter", "blank", "mini-landing", "shop-starter"] }, reset: { type: "boolean", description: "true = пересобрать существующий черновик из шаблона init (ДЕСТРУКТИВНО: текущий черновик заменяется). Требует init и revision." } }, required: ["siteId"] } },
   { name: "site_publish", description: "Опубликовать черновик сайта (POST /api/bots/pages/{siteId}/publish): рендер в статику, адрес начинает отдавать новую версию. Ошибки проверки — HTTP 422 с путями. Возвращает publishedRevision и url.", inputSchema: { type: "object", properties: { siteId: { type: "string" } }, required: ["siteId"] } },
   { name: "site_upload_asset", description: "Загрузить картинку/видео в сайт (POST /api/bots/pages/{siteId}/upload, папка assets). Передай path (локальный файл) ИЛИ url. Возвращает asset — строку вида assets/<имя> для полей image/logo/icon/style.bg.image.", inputSchema: { type: "object", properties: { siteId: { type: "string" }, path: { type: "string" }, url: { type: "string" } }, required: ["siteId"] } },
   { name: "site_rollback", description: "Вернуть прошлую публикацию сайта (POST /api/bots/pages/{siteId}/publish/rollback): revision — номер из истории публикаций (site_get → versions[]). Черновик заменяется этой версией и сразу публикуется. Возвращает publishedRevision и url.", inputSchema: { type: "object", properties: { siteId: { type: "string" }, revision: { type: "number" } }, required: ["siteId", "revision"] } },
@@ -1196,7 +1196,7 @@ const TOOLS = [
   { name: "booking_cancel", description: "Отменить бронь и освободить слот (POST /api/bots/booking/calendars/{calendarId}/bookings/{bookingId}/cancel). Повторная отмена — без ошибки. bookingId — из booking_list.", inputSchema: { type: "object", properties: { calendarId: { type: "string" }, bookingId: { type: "string" } }, required: ["calendarId", "bookingId"] } },
   { name: "booking_confirm", description: "Подтвердить бронь, ждущую решения владельца (MANUAL confirmationMode) — POST .../bookings/{bookingId}/confirm. Клиенту уходит уведомление, если бронь пришла из чата бота. HTTP 404 — бронь не этого календаря, 409 — уже не ждёт решения (подтверждена/отменена/истёк pendingHoldHours).", inputSchema: { type: "object", properties: { calendarId: { type: "string" }, bookingId: { type: "string" } }, required: ["calendarId", "bookingId"] } },
   { name: "booking_reject", description: "Отклонить бронь, ждущую решения владельца (MANUAL confirmationMode) — POST .../bookings/{bookingId}/reject: освобождает слот, клиенту уходит «отклонено владельцем» (в отличие от booking_cancel — то работает на любой активной брони и ничего не присылает клиенту). HTTP 404/409 — как у booking_confirm.", inputSchema: { type: "object", properties: { calendarId: { type: "string" }, bookingId: { type: "string" } }, required: ["calendarId", "bookingId"] } },
-  { name: "site_templates", description: "Библиотека шаблонов блоков сайта (GET /api/bots/pages/templates): {categories: [{id, title, description?}], templates: [{id, category, title, description?, blocks: сколько блоков вставится}]}. Вставка — site_edit add_template {container, templateId, after?} (results.id — первый блок, results.ids — все); дальше блоки правятся как обычные. category — фильтр по id категории.", inputSchema: { type: "object", properties: { category: { type: "string" } } } },
+  { name: "site_templates", description: "Библиотека шаблонов блоков сайта (GET /api/bots/pages/templates): {categories: [{id, title, description?}], templates: [{id, category, title, description?, blocks: сколько блоков вставится}]}. Вставка — site_edit add_template {container, templateId, after?} (results.id — первый блок, results.ids — все); дальше блоки правятся как обычные. category — фильтр по id категории. Ответ также содержит siteTemplates — стартовые шаблоны сайта (starter, blank, mini-landing, shop-starter) с описаниями: для site_create template / site_edit init.", inputSchema: { type: "object", properties: { category: { type: "string" } } } },
   // ---- Паритет платформы, часть 2: бот, база, агент, заявки, подписчики, каналы, ссылки, аналитика ----
   { name: "bot_rename", description: "Переименовать бота (PATCH /api/bots/{botId} {name}): отображаемое имя в кабинете, до 250 символов. Пустое name сбрасывает имя на @username. Имя в самом Telegram/MAX не меняется.", inputSchema: { type: "object", properties: { botId: { type: "string" }, name: { type: "string" } }, required: ["botId", "name"] } },
   { name: "bot_change_token", description: "Сменить токен бота (POST /api/bots/{botId}/token {token}): сервер проверяет токен и перезапускает приём сообщений; сценарии, подписчики и ссылки остаются. Нужен, если токен перевыпущен в @BotFather (/revoke) или MAX. Неверный или чужой токен → ошибка с причиной. Владелец или ADMIN.", inputSchema: { type: "object", properties: { botId: { type: "string" }, token: { type: "string", description: "Новый токен бота" } }, required: ["botId", "token"] } },
@@ -1466,8 +1466,9 @@ async function handleCall(params) {
       return okResult(await api(`/api/bots/graphs/${a.graphId}/dry-run`, { method: "POST", body: { kind: a.kind, value, fromUsername: a.fromUsername, presetVariables: a.presetVariables, presetTags: a.presetTags } }));
     }
     case "publish_graph": {
-      const qs = a.secondary === true ? "?secondary=true" : "";
-      const pub = await api(`/api/bots/graphs/${a.graphId}/publish${qs}`, { method: "POST" });
+      const g = await invokeGuarded("graph_publish", { graphId: a.graphId, ...(a.secondary === true ? { secondary: true } : {}) }, a);
+      if (g.pending) return g.pending;
+      const pub = g.data;
       // errors[] приходит с HTTP 200, но для пользователя это «не получилось» — и самый
       // ценный сигнал: видно, какого узла/возможности ему не хватило.
       if (Array.isArray(pub?.errors) && pub.errors.length) {
@@ -1524,8 +1525,11 @@ async function handleCall(params) {
     case "copy_graph":
       return okResult(await api(`/api/bots/graphs/${a.graphId}/copy`, { method: "POST", body: { targetBotId: a.targetBotId, preview: a.preview === true } }));
     case "delete_graph":
-      await api(`/api/bots/graphs/${a.graphId}`, { method: "DELETE" });
+    {
+      const g = await invokeGuarded("graph_delete", { graphId: a.graphId }, a);
+      if (g.pending) return g.pending;
       return okResult(`🗑️ Граф ${a.graphId} удалён.`);
+    }
     case "set_active_graph":
       await api(`/api/bots/${a.botId}/active-graph`, { method: "POST", body: { graphId: a.graphId } });
       return okResult(`✅ Активный граф бота ${a.botId} → ${a.graphId}.`);
@@ -1565,16 +1569,23 @@ async function handleCall(params) {
       }
       return okResult(doc);
     }
-    case "site_schema": return okResult(await api("/api/bots/pages/schema"));
+    case "site_schema": return okResult(await api(a.full === true ? "/api/bots/pages/schema?full=true" : "/api/bots/pages/schema"));
     case "site_edit": {
       const hasOps = Array.isArray(a.ops) && a.ops.length > 0;
       if (!hasOps && !a.init) throw new Error("Передай ops — массив операций (см. site_schema) — или init, чтобы только создать черновик.");
       if (a.init != null && !SITE_INITS.includes(a.init)) throw new Error(`init — одно из: ${SITE_INITS.join(", ")}.`);
+      if (a.reset === true) {
+        if (!a.init) throw new Error("reset — пересборка черновика из шаблона: нужен init (starter|blank|mini-landing|shop-starter).");
+        if (typeof a.revision !== "number") throw new Error("reset удаляет текущий черновик — передай revision (site_get → revision).");
+      }
       const ops = hasOps ? a.ops : SITE_NOOP_OPS; // бэкенд отвечает 422 на пустой ops[]
-      return okResult(await api(`/api/bots/pages/${a.siteId}/document/ops`, { method: "POST", body: { ops, revision: a.revision, init: a.init } }));
+      const g = await invokeGuarded("site_edit", { siteId: a.siteId, ops, revision: a.revision, init: a.init, reset: a.reset === true ? true : undefined }, a);
+      return g.pending || okResult(g.data);
     }
     case "site_publish": {
-      const r = await api(`/api/bots/pages/${a.siteId}/publish`, { method: "POST" });
+      const g = await invokeGuarded("site_publish", { siteId: a.siteId }, a);
+      if (g.pending) return g.pending;
+      const r = g.data;
       return okResult({ publishedRevision: r?.publishedRevision, url: r?.page?.url });
     }
     case "site_upload_asset": return okResult(await uploadSiteAsset(a.siteId, { filePath: a.path, url: a.url }));
@@ -1587,7 +1598,9 @@ async function handleCall(params) {
     }
     case "site_rollback": {
       if (typeof a.revision !== "number") throw new Error("Передай revision — номер публикации (site_get → versions[]).");
-      const r = await api(`/api/bots/pages/${a.siteId}/publish/rollback`, { method: "POST", body: { revision: a.revision } });
+      const g = await invokeGuarded("site_rollback", { siteId: a.siteId, revision: a.revision }, a);
+      if (g.pending) return g.pending;
+      const r = g.data;
       return okResult({ publishedRevision: r?.publishedRevision, url: r?.page?.url });
     }
     case "site_domains": {
@@ -1629,9 +1642,13 @@ async function handleCall(params) {
         const errs = validateAgentTools(a.patch.tools);
         if (errs.length) throw new Error("Инструменты агента не прошли проверку:\n- " + errs.join("\n- "));
       }
-      return okResult(await api(`/api/bots/agents/${a.agentId}`, { method: "PATCH", body: a.patch }));
+      const g = await invokeGuarded("agent_update", { agentId: a.agentId, patch: a.patch }, a);
+      return g.pending || okResult(g.data);
+    }
+    case "agent_publish": {
+      const g = await invokeGuarded("agent_publish", { agentId: a.agentId }, a);
+      return g.pending || okResult(g.data);
     }
-    case "agent_publish": return okResult(await api(`/api/bots/agents/${a.agentId}/publish`, { method: "POST" }));
     case "agent_health": return okResult(await api(`/api/bots/agents/${a.agentId}/health`));
     case "agent_test_chat": {
       if (!a.question || !String(a.question).trim()) throw new Error("Передай question.");
@@ -1655,7 +1672,10 @@ async function handleCall(params) {
     }
     case "kb_add_site": {
       if (!a.url) throw new Error("Передай url.");
-      return okResult(await api(`/api/bots/kb/${a.kbId}/docs/site`, { method: "POST", body: { url: a.url, schedule: a.schedule } }));
+      // schedule в реестре нет — такой вызов остаётся прямым REST
+      if (a.schedule) return okResult(await api(`/api/bots/kb/${a.kbId}/docs/site`, { method: "POST", body: { url: a.url, schedule: a.schedule } }));
+      const g = await invokeGuarded("kb_add_site", { kbId: a.kbId, url: a.url }, a);
+      return g.pending || okResult(g.data);
     }
     case "kb_reindex": return okResult(await api(`/api/bots/kb/${a.kbId}/docs/${a.docId}/reindex`, { method: "POST", body: { headerRow: a.headerRow } }));
     case "analytics_ask": {
@@ -1710,7 +1730,8 @@ async function handleCall(params) {
     case "dialog_reply": {
       const text = String(a.text ?? "").trim();
       if (!text) throw new Error("Передай text — текст ответа.");
-      return okResult(await api(`/api/bots/${a.botId}/users/${chatIdArg(a.chatId)}/messages`, { method: "POST", body: { text } }));
+      const g = await invokeGuarded("dialog_reply", { botId: a.botId, chatId: chatIdArg(a.chatId), text }, a);
+      return g.pending || okResult(g.data);
     }
     // ---- Запись на слоты ----
     case "booking_calendar_list": return okResult(await api("/api/bots/booking/calendars"));
@@ -1775,7 +1796,8 @@ async function handleCall(params) {
     case "booking_cancel": {
       const id = uuidArg(a.calendarId, "calendarId");
       const bookingId = uuidArg(a.bookingId, "bookingId");
-      await api(`/api/bots/booking/calendars/${id}/bookings/${bookingId}/cancel`, { method: "POST" });
+      const g = await invokeGuarded("booking_cancel", { calendarId: id, bookingId }, a);
+      if (g.pending) return g.pending;
       return okResult(`✅ Бронь ${bookingId} отменена, слот свободен.`);
     }
     case "booking_confirm":
@@ -1870,8 +1892,8 @@ async function handleCall(params) {
     case "scenario_runs": return okResult(await api(`/api/bots/graphs/${uuidArg(a.graphId, "graphId")}/runs${pageQs(a)}`));
     case "bot_delete": {
       const botId = uuidArg(a.botId, "botId");
-      if (a.confirm !== true) throw new Error("Удаление бота необратимо. Спроси пользователя и повтори с confirm:true.");
-      await api(`/api/bots/${botId}`, { method: "DELETE" });
+      const g = await invokeGuarded("bot_delete", { botId }, a);
+      if (g.pending) return g.pending;
       return okResult(`🗑️ Бот ${botId} удалён вместе со сценариями и подписчиками.`);
     }
     // ---- Паритет платформы, часть 2 ----
@@ -2156,10 +2178,15 @@ async function handleCall(params) {
       const inactive = a.inactive === true; // перенос из другого конструктора: не трогать живой вебхук
       let bot;
       try {
-        bot = await api("/api/bots", { method: "POST", body: { token, platform, inactive } });
+        if (inactive) bot = await api("/api/bots", { method: "POST", body: { token, platform, inactive } });
+        else {
+          const g = await invokeGuarded("bot_connect", { platform, token }, a);
+          if (g.pending) return g.pending;
+          bot = g.data;
+        }
       } catch (e) {
         // 400 приходит строкой-причиной (неверный токен, бот уже подключён) — её и показываем.
-        if (e.status === 400) throw new Error(`Бот не подключён: ${typeof e.data === "string" && e.data ? e.data : "токен не принят"}. Проверь токен (${platform === "MAX" ? "MasterBot в MAX" : "@BotFather → /token"}).`);
+        if (e.status === 400) throw new Error(`Бот не подключён: ${bodyReason(e.data) || "токен не принят"}. Проверь токен (${platform === "MAX" ? "MasterBot в MAX" : "@BotFather → /token"}).`);
         throw e;
       }
       if (a.name && bot?.id) {
@@ -2181,7 +2208,10 @@ async function handleCall(params) {
     case "vk_landing_delete":
       await api(`/api/growth/vk-landings/${uuidArg(a.id, "id")}`, { method: "DELETE" });
       return okResult({ deleted: true });
-    case "bot_stop": return okResult(await api(`/api/bots/${a.botId}/stop`, { method: "POST" }));
+    case "bot_stop": {
+      const g = await invokeGuarded("bot_stop", { botId: a.botId }, a);
+      return g.pending || okResult(g.data);
+    }
     case "bot_resume": return okResult(await api(`/api/bots/${a.botId}/resume`, { method: "POST" }));
     // ---- Подключения ----
     case "connect_integration": {
@@ -2341,7 +2371,9 @@ async function handleCall(params) {
         if (a.scheduledAt !== undefined) throw new Error(`scheduledAt ${body.scheduledAt} уже прошло — укажи будущее время или не передавай его (отправить сейчас).`);
         body.scheduledAt = null;
       }
-      const r = await api("/api/bots/broadcasts/direct", { method: "POST", body });
+      const g = await invokeGuarded("broadcast_send_now", body, a);
+      if (g.pending) return g.pending;
+      const r = g.data;
       let draftDeleted = false;
       if (a.draftId) { try { await api(`/api/bots/broadcasts/drafts/${a.draftId}`, { method: "DELETE" }); draftDeleted = true; } catch { /* не критично */ } }
       // dedup/stagger → бэкенд создаёт BroadcastGroup вместо прямых TgBroadcast (другая форма ответа: id/perBot[]/status вместо broadcastIds/totalAudience).
@@ -2471,9 +2503,11 @@ async function handleCall(params) {
       }
       return okResult(await api(`/api/bots/broadcasts/${a.broadcastId}/ops/preview`, { method: "POST", body }));
     }
-    case "broadcast_cancel":
-      await api(`/api/bots/broadcasts/${a.broadcastId}/cancel`, { method: "POST" });
+    case "broadcast_cancel": {
+      const g = await invokeGuarded("broadcast_cancel", { broadcastId: a.broadcastId }, a);
+      if (g.pending) return g.pending;
       return okResult(`⏹️ Рассылка ${a.broadcastId} отменяется (CANCELLING → CANCELLED).`);
+    }
     case "broadcast_recurring": {
       const base = "/api/bots/broadcasts/recurring";
       if (a.action === "list") return okResult(await api(base));
@@ -2559,7 +2593,7 @@ async function handleCall(params) {
       const r = await api("/api/bots/pages/templates");
       let templates = Array.isArray(r?.templates) ? r.templates : [];
       if (a.category) templates = templates.filter((t) => t?.category === a.category);
-      return okResult({ categories: r?.categories ?? [], templates });
+      return okResult({ categories: r?.categories ?? [], templates, siteTemplates: r?.siteTemplates ?? [] });
     }
     // ---- Публикации: цепочки ----
     case "chain_list": return okResult(await api("/api/bots/chains"));
@@ -2584,7 +2618,10 @@ async function handleCall(params) {
       await api(`/api/bots/chains/${chainId}`, { method: "DELETE" });
       return okResult(`🗑️ Цепочка ${chainId} удалена.`);
     }
-    case "chain_enable": return okResult(await api(`/api/bots/chains/${uuidArg(a.chainId, "chainId")}/enable`, { method: "POST" }));
+    case "chain_enable": {
+      const g = await invokeGuarded("chain_enable", { chainId: uuidArg(a.chainId, "chainId") }, a);
+      return g.pending || okResult(g.data);
+    }
     case "chain_pause": return okResult(await api(`/api/bots/chains/${uuidArg(a.chainId, "chainId")}/pause`, { method: "POST" }));
     case "chain_runs": {
       const chainId = uuidArg(a.chainId, "chainId");
@@ -2780,6 +2817,32 @@ async function callCatalog(params) {
   }
 }
 
+/**
+ * Опасное действие через единый реестр: сервер сам требует подтверждение (409 + confirmToken) и пишет вызов в журнал.
+ * { pending } — готовый MCP-результат «спроси пользователя» (с описанием изменений и токеном), { data } — выполнено.
+ * Повтор: те же аргументы + confirmToken (параметр самого инструмента).
+ */
+async function invokeGuarded(name, args, a) {
+  const clean = Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined));
+  if (typeof a?.confirmToken === "string" && a.confirmToken) clean.confirmToken = a.confirmToken;
+  try {
+    return { data: await api("/api/agent-tools/invoke", { method: "POST", body: { name, args: clean } }) };
+  } catch (e) {
+    const text = e?.status === 409 ? confirmationText(e.data) : null;
+    if (text) return { pending: okResult(text) };
+    throw e;
+  }
+}
+/** Обратимые правки: сервер обычно не требует подтверждения, токен нужен лишь при явном 409. */
+const SOFT_CONFIRM_TOOLS = new Set(["site_edit", "agent_update", "kb_add_site", "chain_enable"]);
+const GUARDED_TOOLS = new Set(["publish_graph", "site_publish", "site_rollback", "agent_publish", "booking_cancel", "bot_delete", "broadcast_cancel", "broadcast_send",
+  "delete_graph", "agent_update", "chain_enable", "kb_add_site", "create_bot", "bot_stop", "dialog_reply", "site_edit"]);
+for (const t of TOOLS) {
+  if (!GUARDED_TOOLS.has(t.name)) continue;
+  const soft = SOFT_CONFIRM_TOOLS.has(t.name);
+  t.inputSchema.properties = { ...(t.inputSchema.properties || {}), confirmToken: { type: "string", description: soft ? "Только если сервер вернул запрос подтверждения (409): токен одноразовый, при новом 409 используй новый токен и покажи пользователю новое описание изменений. Обычно не нужен." : "Токен подтверждения из ответа «Нужно подтверждение пользователя»: повтори вызов с теми же аргументами после явного согласия человека. Без него сервер ничего не выполнит." } };
+}
+
 function notifyListChanged() { send({ jsonrpc: "2.0", method: "notifications/tools/list_changed" }); }
 /** Обновить каталог в фоне; изменился набор — сказать клиенту перечитать tools/list. */
 function refreshCatalog() {