@retensy/mcp 0.28.0 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retensy/mcp",
-  "version": "0.28.0",
+  "version": "0.29.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": {

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

@@ -155,6 +155,26 @@ IG-боты не поддерживают команды (`/start`). Вход
 - `STOP_AND_ERROR` — `{ "message":"CRM не ответила: {{var.http_status}}" }`. Обрывает прогон и
   помечает его в журнале как ошибочный (`FAILED`), шаг — `ok:false` с этим текстом. Выходов нет,
   ничего подписчику не отправляет. Пустой `message` → «Сценарий остановлен с ошибкой».
+- `DELETE_MESSAGE` — `{ "mode":"PREVIOUS"|"NODE"|"USER_LAST"|"NEXT", "nodeId":"<id узла>", "delay":30, "unit":"SECONDS"|"MINUTES"|"HOURS" }`.
+  Удаляет сообщение у подписчика, выход один — `next`. `mode`: `PREVIOUS` — последнее сообщение бота перед этим
+  узлом; `NODE` — последнее сообщение узла `nodeId` (узел этого же сценария, который шлёт сообщение:
+  `SEND_*`, `ASK_QUESTION`, `AI_REPLY`, `ACTIONS`, оплата); `USER_LAST` — последнее сообщение подписчика
+  (только Telegram, в личке); `NEXT` — сообщение, которое отправит следующий отправляющий узел (нужен `delay` > 0).
+  `delay`+`unit` — пауза до удаления без остановки сценария (по умолчанию удаляет сразу), меньше 24 часов, допускается
+  дробное значение (округляется вверх до секунды).
+  **Ограничения.** `NEXT` срабатывает только если следующий узел отправляет сообщение сразу: если между ними `DELAY` или
+  `SCHEDULE`, сценарий паркуется, флаг сгорает и ничего не удаляется (валидатор предупреждает `DELETE_NEXT_PARKED`,
+  а если отправляющего узла после вообще нет, `DELETE_NEXT_NO_SENDER`). `USER_LAST` работает только в личке Telegram
+  (в группах, VK и MAX шаг пропускается с ошибкой в журнале). `NODE`/`PREVIOUS` помнят последнее сообщение узла: если блок
+  `ACTIONS` отправил несколько сообщений, удалится только последнее. Отложенные удаления переживают рестарт, остановку
+  бота и снятие сценария с публикации.
+  Пример «выгнали из канала и удалили сообщение со ссылкой»: `ACTIONS(invite_link_create)` → `ACTIONS(group_kick)` →
+  `DELETE_MESSAGE{mode:"NODE", nodeId:<id блока со ссылкой>}`. Сценарий НЕ падает, если удалить нельзя (Telegram даёт
+  48 часов на сообщения бота в личке, VK 24 часа, сообщение уже удалено или платформа не умеет): идёт дальше по
+  `next`, а шаг помечается ошибкой в журнале и аналитике. Валидатор режет: неизвестный `mode`
+  (`DELETE_BAD_MODE`), `NODE` без существующего узла (`DELETE_NODE_MISSING`) или с узлом, который ничего не шлёт
+  (`DELETE_NODE_NOT_SENDER`), пауза не число (`DELETE_BAD_DELAY`) или от 24 часов (`DELETE_DELAY_TOO_LONG`),
+  `NEXT` без паузы (`DELETE_NEXT_NO_DELAY`). Instagram узел не поддерживает.
 - `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`**: ветка и так завершается на узле без исходящих рёбер; явный «конец сценария» бесполезен и убран из палитры редактора. Тип оставлен лишь для совместимости со старыми графами.
 
@@ -483,6 +503,7 @@ node validate.mjs graph.json --platform=INSTAGRAM
 | `ACTIONS` | `next`, плюс `error` — если внутри есть действие, которое может упасть (внешний запрос, CRM, Таблицы); `taken` — слот `booking_book` занят |
 | `SWITCH` | `case_<id>`, `default` |
 | `STOP_AND_ERROR` | выходов нет (терминатор) |
+| `DELETE_MESSAGE` | `next` (всегда, даже если удалить не вышло) |
 | `SCHEDULE` | `scheduled`, `past` |
 | `DELAY` | `next`; у `UNTIL` ещё `late` (момент уже прошёл) и `error` (шаблон не разобрался как дата) |
 | `AI_REPLY` (`mode` не задан/`simple`) | `next`, `error` |

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

@@ -279,6 +279,50 @@ for (const n of nodes) {
       }
       break;
     }
+    case "DELETE_MESSAGE": {
+      // Зеркало GraphValidator.validateDeleteMessage (Java).
+      if (!["NODE", "PREVIOUS", "USER_LAST", "NEXT"].includes(c.mode)) {
+        errors.push(`DELETE_BAD_MODE: ${who} — mode ∈ {NODE,PREVIOUS,USER_LAST,NEXT}.`);
+        break;
+      }
+      if (c.mode === "NODE") {
+        const target = nodes.find((x) => x.id === c.nodeId);
+        const SENDERS = ["SEND_MESSAGE", "SEND_PHOTO", "SEND_VIDEO", "SEND_DOCUMENT", "SEND_VOICE", "SEND_VIDEO_NOTE",
+          "SEND_MEDIA_GROUP", "ASK_QUESTION", "AI_REPLY", "PAYMENT_LINK", "YOOKASSA_PAYMENT", "ACTIONS"];
+        if (!target) errors.push(`DELETE_NODE_MISSING: ${who} — nodeId должен указывать на узел этого сценария.`);
+        else if (!SENDERS.includes(target.type)) errors.push(`DELETE_NODE_NOT_SENDER: ${who} — узел nodeId ничего не отправляет.`);
+      }
+      // Зеркало FlowExecutor.deleteDelaySec: дробная пауза округляется вверх, потолок 24 часа.
+      const delay = c.delay === undefined || c.delay === null ? 0 : Number(c.delay);
+      const mult = c.unit === "HOURS" ? 3600 : c.unit === "MINUTES" ? 60 : 1;
+      const delaySec = Number.isFinite(delay) && delay > 0 ? Math.min(Math.ceil(delay * mult), 86400) : 0;
+      if (!Number.isFinite(delay) || delay < 0) errors.push(`DELETE_BAD_DELAY: ${who} — delay должен быть числом не меньше 0.`);
+      else if (delaySec >= 86400) errors.push(`DELETE_DELAY_TOO_LONG: ${who} — пауза должна быть меньше 24 часов.`);
+      if (c.mode === "NEXT" && delaySec <= 0) errors.push(`DELETE_NEXT_NO_DELAY: ${who} — для mode NEXT нужен delay больше нуля.`);
+      if (c.mode === "NEXT") {
+        // Флаг «удалить следующее» живёт в одном прогоне: пауза (DELAY/SCHEDULE) до отправки его сжигает.
+        const SENDERS_NEXT = ["SEND_MESSAGE", "SEND_PHOTO", "SEND_VIDEO", "SEND_DOCUMENT", "SEND_VOICE", "SEND_VIDEO_NOTE",
+          "SEND_MEDIA_GROUP", "ASK_QUESTION", "AI_REPLY", "PAYMENT_LINK", "YOOKASSA_PAYMENT", "ACTIONS"];
+        const out = {};
+        for (const e of edges) (out[e.sourceNodeId] = out[e.sourceNodeId] || []).push(e.targetNodeId);
+        const seen = new Set();
+        const queue = [[n.id, false]];
+        let senderFound = false, parkedSender = false;
+        while (queue.length) {
+          const [id, parked] = queue.shift();
+          for (const t of out[id] || []) {
+            const tn = nodes.find((x) => x.id === t);
+            if (!tn || seen.has(`${t}:${parked}`)) continue;
+            seen.add(`${t}:${parked}`);
+            if (SENDERS_NEXT.includes(tn.type)) { senderFound = true; if (parked) parkedSender = true; }
+            else queue.push([t, parked || tn.type === "DELAY" || tn.type === "SCHEDULE"]);
+          }
+        }
+        if (parkedSender) warns.push(`DELETE_NEXT_PARKED: ${who} — между узлом и отправкой есть пауза (DELAY/SCHEDULE): сценарий паркуется, удаление следующего сообщения не сработает.`);
+        else if (!senderFound) warns.push(`DELETE_NEXT_NO_SENDER: ${who} — после узла нет блока, который отправляет сообщение.`);
+      }
+      break;
+    }
     case "STOP_AND_ERROR":
       // message необязателен (рантайм подставит свой текст), но безымянная ошибка в журнале бесполезна.
       if (blank(c.message)) warns.push(`${who}: STOP_AND_ERROR без message — в журнале будет обезличенное «Сценарий остановлен с ошибкой».`);