@retensy/mcp 0.41.0 → 0.43.0

package/README.md

@@ -441,6 +441,18 @@ 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`. Действия с подтверждением (удаление, рассылка всем, публикация)
+повторяются с `confirmToken` из ответа сервера (привязан к аргументам, живёт 5 минут) только после явного согласия пользователя. Каталог только добавляет новые имена и не перекрывает встроенные инструменты; для не-localhost `RETENSY_BASE_URL` нужен https. Выключить: `RETENSY_MCP_CATALOG=off`.
+
+Настоящее согласие человека для деструктивных инструментов - это подтверждение вызова в самом MCP-клиенте (такие инструменты помечены `destructiveHint`): не включайте для них автоодобрение.
+
 ## Отчёты о неудачах (телеметрия)
 
 Чтобы мы узнавали, каких возможностей не хватает, при неудаче инструмента отправляется **анонимный**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retensy/mcp",
-  "version": "0.41.0",
+  "version": "0.43.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/src/catalog.mjs

@@ -0,0 +1,163 @@
+// Единый каталог действий сервиса (GET /api/agent-tools/catalog) — тот же список, что у «Чата с ИИ» в кабинете.
+// Инструменты каталога регистрируются динамически и вызываются через POST /api/agent-tools/invoke: новые действия
+// появляются в MCP без релиза npm. Захардкоженные инструменты остаются для обратной совместимости; при совпадении
+// имени остаётся локальная версия: каталог только ДОБАВЛЯЕТ новые имена (SEC-24), вызовы локальных
+// инструментов идут через локальный handleCall.
+//
+// Кэш: в памяти + файл ~/.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";
+import crypto from "node:crypto";
+
+export const CATALOG_TTL_MS = 10 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 6000;
+/** Служебные инструменты MCP: каталог их никогда не перекрывает. */
+const RESERVED = new Set(["setup", "set_token"]);
+export const MAX_DESCRIPTION_BYTES = 2 * 1024;
+export const MAX_SCHEMA_BYTES = 8 * 1024;
+export const MAX_CATALOG_TOOLS = 300;
+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
+    && Buffer.byteLength(t.description, "utf8") <= MAX_DESCRIPTION_BYTES
+    && t.inputSchema && typeof t.inputSchema === "object" && t.inputSchema.type === "object"
+    && Buffer.byteLength(JSON.stringify(t.inputSchema), "utf8") <= MAX_SCHEMA_BYTES;
+}
+
+const warned = new Set();
+function warnOnce(key, msg) {
+  if (warned.has(key)) return;
+  warned.add(key);
+  console.error(`[retensy-mcp] ${msg}`);
+}
+
+/** Валидные записи каталога, не больше MAX_CATALOG_TOOLS. */
+function sanitize(list) {
+  const valid = (Array.isArray(list) ? list : []).filter(validCatalogTool);
+  if (valid.length > MAX_CATALOG_TOOLS) warnOnce("max-tools", `каталог: ${valid.length} инструментов, берутся первые ${MAX_CATALOG_TOOLS}`);
+  return valid.slice(0, MAX_CATALOG_TOOLS);
+}
+
+/**
+ * Список tools/list: захардкоженные инструменты, кроме перекрытых каталогом, + инструменты каталога.
+ * Порядок стабильный: сначала захардкоженные (как было), затем новые из каталога.
+ */
+export function mergeTools(staticTools, catalogTools) {
+  const known = new Set(staticTools.map((t) => t.name));
+  const out = [...staticTools];
+  for (const c of sanitize(catalogTools)) {
+    if (known.has(c.name)) {
+      warnOnce(`skip:${c.name}`, `каталог: инструмент ${c.name} уже есть локально, версия сервера пропущена`);
+      continue;
+    }
+    known.add(c.name);
+    const t = { name: c.name, description: c.description, inputSchema: c.inputSchema };
+    if (c.requiresConfirmation === true) t.annotations = { destructiveHint: true };
+    out.push(t);
+  }
+  return out;
+}
+
+function isSafeBase(base) {
+  try {
+    const u = new URL(base);
+    if (u.protocol === "https:") return true;
+    return u.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(u.hostname);
+  } catch { return false; }
+}
+
+export function createCatalog({ base, headers, configDir, enabled = true, now = () => Date.now(), fetchImpl = fetch }) {
+  if (enabled && !isSafeBase(base)) {
+    warnOnce("insecure-base", "каталог выключен: для не-localhost RETENSY_BASE_URL нужен https");
+    enabled = false;
+  }
+  // Ключ кэша: база + хэш токена/куки, чтобы набор одного токена не виден другому.
+  const fileFor = () => {
+    const h = headers() || {};
+    const secret = `${h.Authorization || h.authorization || ""}|${h.Cookie || h.cookie || ""}`;
+    const tokenHash = crypto.createHash("sha256").update(secret).digest("hex").slice(0, 16);
+    return path.join(configDir, `catalog-${hash(base)}-${tokenHash}.json`);
+  };
+  let tools = enabled ? readCache(fileFor()) : [];
+  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) ? sanitize(data.tools) : null;
+        if (!next) return false;
+        fetchedAt = now();
+        tools = next;
+        try {
+          fs.mkdirSync(configDir, { recursive: true });
+          const file = fileFor();
+          fs.writeFileSync(file, JSON.stringify({ fetchedAt, tools }), { mode: 0o600 });
+          try { fs.chmodSync(file, 0o600); } catch { /* Windows */ }
+        } 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) ? sanitize(data.tools) : [];
+  } 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) {
+    const msg = typeof data.message === "string" ? data.message : "";
+    if (typeof data.confirmToken === "string" && data.confirmToken) {
+      return `⚠️ Нужно подтверждение пользователя. ${msg} Опиши пользователю, что именно будет сделано, получи его явное согласие и повтори вызов с ТЕМИ ЖЕ аргументами плюс confirmToken: "${data.confirmToken}" (токен привязан к этим аргументам и действует 5 минут).`.trim();
+    }
+    return `⚠️ Нужно подтверждение пользователя. ${msg}`.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,34 @@ async function handleCall(params) {
   }
 }
 
+// ---- Единый каталог действий (тот же, что у «Чата с ИИ» в кабинете) ----
+const catalog = createCatalog({
+  base: BASE,
+  headers: authHeaders,
+  configDir: CONFIG_DIR,
+  enabled: (process.env.RETENSY_MCP_CATALOG || "on").trim().toLowerCase() !== "off",
+});
+
+const LOCAL_TOOL_NAMES = new Set(TOOLS.map((t) => t.name));
+
+/** Инструмент каталога: сервер сам проверит права токена, тариф и подтверждение. */
+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 +2749,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) && !LOCAL_TOOL_NAMES.has(params?.name) ? await callCatalog(params) : await handleCall(params);
+        if (params?.name === "set_token") refreshCatalog(); // новый токен — другой набор прав и действий
       } catch (e) {
         result = errResult(e);
         // Единая точка: сюда приходит ЛЮБАЯ неудача инструмента — в т.ч. «Неизвестный