@retensy/mcp 0.40.0 → 0.42.0

package/README.md

@@ -441,6 +441,16 @@ RETENSY_MCP_TOKEN=zmcp_... node src/index.mjs   # стартует stdio MCP-с
 Важно: запущенный процесс не может подменить собственный код — **обновление вступает в силу после
 перезапуска MCP-сервера**. Нет сети или npm недоступен — проверка молча пропускается, работа не ломается.
 
+### Каталог действий без обновления пакета
+
+С версии 0.42 сервер при старте загружает единый каталог действий сервиса
+(`GET /api/agent-tools/catalog` — тот же список, что у «Чата с ИИ» в кабинете) и регистрирует его
+инструменты динамически; вызов идёт через `POST /api/agent-tools/invoke`, права токена, тариф и
+подтверждение проверяет сервер. Новые действия появляются **без релиза npm**: каталог обновляется раз в
+10 минут, клиент получает `notifications/tools/list_changed`. Каталог кэшируется в
+`~/.retensy-bot-graph/catalog-*.json`. Действия с подтверждением (удаление, рассылка всем, публикация)
+выполняются только с `confirm:true` после явного согласия пользователя. Выключить: `RETENSY_MCP_CATALOG=off`.
+
 ## Отчёты о неудачах (телеметрия)
 
 Чтобы мы узнавали, каких возможностей не хватает, при неудаче инструмента отправляется **анонимный**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retensy/mcp",
-  "version": "0.40.0",
+  "version": "0.42.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",
+    "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",
     "validate": "node skills/build-bot-funnel/validate.mjs"
   },
   "engines": {

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

@@ -104,6 +104,7 @@
   `hoursBefore` 1..720 для `reminder`, `hoursAfter` 1..168 для `after_visit` (`BOOKING_TRIGGER_BAD_HOURS`). Если запись сделана через бота,
   сценарий идёт в диалоге клиента; иначе без получателя. Переменные: `{{booking.id}}`, `{{booking.event}}`, `{{booking.calendar}}`,
   `{{booking.start}}`, `{{booking.end}}`, `{{booking.label}}`, `{{booking.name}}`, `{{booking.phone}}`. Каждое событие на запись срабатывает один раз.
+- `TRIGGER_LINK_CLICK` — подписчик первый раз нажал отслеживаемую URL-кнопку (кнопка с `track:true`) в сообщении: `{ "sourceNodeId": "<uuid шага, необязательно = любой>", "buttonIdx": 0 }` (buttonIdx с нуля, необязательно). Сценарий идёт в диалоге кликнувшего; в шаблонах `{{link_click.url}}`, `{{link_click.buttonIdx}}`. Только основной сценарий бота.
 - `TRIGGER_SITE_FORM` — `{ "siteId": "<uuid сайта>", "formId": "<id формы>" }` — заявка с формы
   опубликованного сайта владельца. `formId` пустой/нет = любая форма сайта. `siteId` обязателен
   (`SITE_FORM_NO_SITE`), сайт должен быть свой (`SITE_FORM_FOREIGN_SITE`). Переменные: поля формы

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

@@ -89,6 +89,7 @@
   `amount` (`YK_NO_AMOUNT`/`YK_BAD_AMOUNT`), `description` (`YK_NO_DESC`).
 - `TRIGGER_BOOKING`: `events` непустой список из booked|confirmed|cancelled|reminder|after_visit (`BOOKING_TRIGGER_NO_EVENTS`, `BOOKING_TRIGGER_BAD_EVENT`);
   `calendarId` UUID или пусто (`BOOKING_TRIGGER_BAD_CALENDAR`); `hoursBefore` 1..720, `hoursAfter` 1..168 (`BOOKING_TRIGGER_BAD_HOURS`).
+- `TRIGGER_LINK_CLICK`: `sourceNodeId` (если задан) - UUID шага (`LINK_CLICK_BAD_SOURCE`), `buttonIdx` (если задан) - целое 0..99 (`LINK_CLICK_BAD_BUTTON`).
 - `start_broadcast` (в `ACTIONS`): `draftId` UUID (`BROADCAST_BAD_DRAFT`), `segmentId` UUID или пусто (`BROADCAST_BAD_SEGMENT`),
   `minIntervalHours` целое 1..720 (`BROADCAST_BAD_INTERVAL`).
 - `TRIGGER_PAYMENT`: обязательных полей нет. Фильтры `minAmount`/`descriptionContains`

package/src/catalog.mjs

@@ -0,0 +1,115 @@
+// Единый каталог действий сервиса (GET /api/agent-tools/catalog) — тот же список, что у «Чата с ИИ» в кабинете.
+// Инструменты каталога регистрируются динамически и вызываются через POST /api/agent-tools/invoke: новые действия
+// появляются в MCP без релиза npm. Захардкоженные инструменты остаются для обратной совместимости; при совпадении
+// имени берётся версия из каталога (сервер гарантирует тот же смысл — контракт-тест реестра на бэкенде).
+//
+// Кэш: в памяти + файл ~/.retensy-bot-graph/catalog-<хэш базы>.json (чтобы tools/list сразу после старта уже
+// знал каталог), обновление по TTL. Изменился набор — сервер шлёт notifications/tools/list_changed.
+// Выключить: RETENSY_MCP_CATALOG=off.
+
+import fs from "node:fs";
+import path from "node:path";
+
+export const CATALOG_TTL_MS = 10 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 6000;
+/** Служебные инструменты MCP: каталог их никогда не перекрывает. */
+const RESERVED = new Set(["setup", "set_token"]);
+const NAME_RX = /^[a-z][a-z0-9_]{2,63}$/;
+
+/** Валидная запись каталога: имя, описание, схема-объект. Остальное отбрасывается, а не ломает tools/list. */
+export function validCatalogTool(t) {
+  return !!t && typeof t === "object" && typeof t.name === "string" && NAME_RX.test(t.name) && !RESERVED.has(t.name)
+    && typeof t.description === "string" && t.description.trim().length > 0
+    && t.inputSchema && typeof t.inputSchema === "object" && t.inputSchema.type === "object";
+}
+
+/**
+ * Список tools/list: захардкоженные инструменты, кроме перекрытых каталогом, + инструменты каталога.
+ * Порядок стабильный: сначала захардкоженные (как было), затем новые из каталога.
+ */
+export function mergeTools(staticTools, catalogTools) {
+  const byName = new Map((catalogTools || []).filter(validCatalogTool).map((t) => [t.name, t]));
+  const out = staticTools.map((t) => {
+    const c = byName.get(t.name);
+    return c ? { name: c.name, description: c.description, inputSchema: c.inputSchema } : t;
+  });
+  const known = new Set(staticTools.map((t) => t.name));
+  for (const c of byName.values()) {
+    if (!known.has(c.name)) out.push({ name: c.name, description: c.description, inputSchema: c.inputSchema });
+  }
+  return out;
+}
+
+export function createCatalog({ base, headers, configDir, enabled = true, now = () => Date.now(), fetchImpl = fetch }) {
+  const file = path.join(configDir, `catalog-${hash(base)}.json`);
+  let tools = readCache(file);
+  let fetchedAt = 0;
+  let inflight = null;
+  let signature = sig(tools);
+
+  async function refresh() {
+    if (!enabled) return false;
+    if (inflight) return inflight;
+    inflight = (async () => {
+      const ctrl = new AbortController();
+      const timer = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
+      try {
+        const res = await fetchImpl(`${base}/api/agent-tools/catalog`, { headers: headers(), signal: ctrl.signal });
+        if (!res.ok) return false;
+        const data = await res.json();
+        const next = Array.isArray(data?.tools) ? data.tools.filter(validCatalogTool) : null;
+        if (!next) return false;
+        fetchedAt = now();
+        tools = next;
+        try {
+          fs.mkdirSync(configDir, { recursive: true });
+          fs.writeFileSync(file, JSON.stringify({ fetchedAt, tools }));
+        } catch { /* кэш на диске — удобство, не обязанность */ }
+        const s = sig(tools);
+        const changed = s !== signature;
+        signature = s;
+        return changed;
+      } catch {
+        return false;
+      } finally {
+        clearTimeout(timer);
+        inflight = null;
+      }
+    })();
+    return inflight;
+  }
+
+  return {
+    tools: () => (enabled ? tools : []),
+    has: (name) => enabled && tools.some((t) => t.name === name),
+    stale: () => enabled && now() - fetchedAt > CATALOG_TTL_MS,
+    refresh,
+  };
+}
+
+function readCache(file) {
+  try {
+    const data = JSON.parse(fs.readFileSync(file, "utf8"));
+    return Array.isArray(data?.tools) ? data.tools.filter(validCatalogTool) : [];
+  } catch {
+    return [];
+  }
+}
+
+function sig(tools) {
+  return JSON.stringify((tools || []).map((t) => [t.name, t.description, t.inputSchema]));
+}
+
+function hash(s) {
+  let h = 0x811c9dc5;
+  for (const ch of String(s)) { h ^= ch.charCodeAt(0); h = (h * 0x01000193) >>> 0; }
+  return h.toString(16).padStart(8, "0");
+}
+
+/** Ответ invoke → результат MCP. 409 needsConfirmation — не ошибка сервиса, а просьба спросить человека. */
+export function confirmationText(data) {
+  if (data && typeof data === "object" && data.needsConfirmation === true) {
+    return `⚠️ Нужно подтверждение пользователя. ${typeof data.message === "string" ? data.message : ""}`.trim();
+  }
+  return null;
+}

package/src/index.mjs

@@ -22,6 +22,7 @@
 
 import { createInterface } from "node:readline";
 import { validateAgentTools } from "./agent-tools.mjs";
+import { createCatalog, mergeTools, confirmationText } from "./catalog.mjs";
 import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 import os from "node:os";
@@ -2708,6 +2709,32 @@ async function handleCall(params) {
   }
 }
 
+// ---- Единый каталог действий (тот же, что у «Чата с ИИ» в кабинете) ----
+const catalog = createCatalog({
+  base: BASE,
+  headers: authHeaders,
+  configDir: CONFIG_DIR,
+  enabled: (process.env.RETENSY_MCP_CATALOG || "on").trim().toLowerCase() !== "off",
+});
+
+/** Инструмент каталога: сервер сам проверит права токена, тариф и подтверждение. */
+async function callCatalog(params) {
+  try {
+    return okResult(await api("/api/agent-tools/invoke", { method: "POST", body: { name: params.name, args: params.arguments || {} } }));
+  } catch (e) {
+    const text = e?.status === 409 ? confirmationText(e.data) : null;
+    if (text) return okResult(text);
+    throw e;
+  }
+}
+
+function notifyListChanged() { send({ jsonrpc: "2.0", method: "notifications/tools/list_changed" }); }
+/** Обновить каталог в фоне; изменился набор — сказать клиенту перечитать tools/list. */
+function refreshCatalog() {
+  if (!isAuthed()) return;
+  catalog.refresh().then((changed) => { if (changed) notifyListChanged(); }).catch(() => {});
+}
+
 // ---- JSON-RPC stdio (MCP) ----
 function send(msg) { process.stdout.write(JSON.stringify(msg) + "\n"); }
 
@@ -2720,13 +2747,16 @@ rl.on("line", async (line) => {
   const { id, method, params } = req;
   try {
     if (method === "initialize") {
-      send({ jsonrpc: "2.0", id, result: { protocolVersion: "2024-11-05", capabilities: { tools: {} }, serverInfo: { name: "retensy-mcp", version: VERSION } } });
+      send({ jsonrpc: "2.0", id, result: { protocolVersion: "2024-11-05", capabilities: { tools: { listChanged: true } }, serverInfo: { name: "retensy-mcp", version: VERSION } } });
+      refreshCatalog();
     } else if (method === "tools/list") {
-      send({ jsonrpc: "2.0", id, result: { tools: TOOLS } });
+      send({ jsonrpc: "2.0", id, result: { tools: mergeTools(TOOLS, catalog.tools()) } });
+      if (catalog.stale()) refreshCatalog();
     } else if (method === "tools/call") {
       let result;
       try {
-        result = await handleCall(params);
+        result = isAuthed() && catalog.has(params?.name) ? await callCatalog(params) : await handleCall(params);
+        if (params?.name === "set_token") refreshCatalog(); // новый токен — другой набор прав и действий
       } catch (e) {
         result = errResult(e);
         // Единая точка: сюда приходит ЛЮБАЯ неудача инструмента — в т.ч. «Неизвестный