bitrix24-mcp-bridge 0.1.1 → 0.2.1

package/README.md

@@ -1,8 +1,9 @@
 # Bitrix24 MCP Bridge
 
-Локальный MCP-сервер, дающий ИИ-агенту **read-only** доступ к задачам, проектам и чатам
-Bitrix24 — в объёме прав пользователя, через браузерное расширение, переиспользующее
-живую сессию. Без прав администратора и без официального REST-вебхука.
+Локальный MCP-сервер, дающий ИИ-агенту доступ к задачам, проектам и чатам Bitrix24 (чтение
+и — для вызовов из каталога — выполнение действий) — в объёме прав пользователя, через
+браузерное расширение, переиспользующее живую сессию. Без прав администратора и без
+официального REST-вебхука.
 
 ```
 ИИ-агент ─stdio─► MCP-клиент ─UDS(bridge.sock)─► daemon ─WS(127.0.0.1:39917, токен+Origin)─► Расширение (вкладка портала)
@@ -64,17 +65,38 @@ daemon после любой правки, затрагивающей конфи
 
 ## Инструменты
 
-Все — read-only, каждый принимает необязательный параметр `portal` (alias; по умолчанию —
-портал по умолчанию из `config.json`):
+Помимо `bitrix_help` / `bitrix_status` / `bitrix_call`, мост регистрирует типизированные обёртки
+над каталогом (разумные дефолты + схема параметров). Регистрируются только те, чьё имя есть в
+`actions.json`. Точная выборка — через необязательный `params` (мержится последним, перекрывает
+дефолты). Каждый принимает необязательный `portal` (alias; по умолчанию — из `config.json`).
+Обёртки в основном read-only; мутирующие помечены ⚠. `bitrix_call` выполняет любой разрешённый
+каталогом вызов, включая мутирующие.
 
 | Инструмент | Назначение |
 |---|---|
-| `bitrix_help` | справка по API/params (то же, что `docs/api-notes.md`) |
-| `bitrix_status` | какие порталы сконфигурированы и какие сейчас подключены |
-| `bitrix_call` | любой разрешённый вызов из каталога по имени |
-| `bitrix_tasks_list` / `bitrix_task_get` | задачи |
+| `bitrix_help` | справка по API/params (= `docs/api-notes.md`) |
+| `bitrix_status` | какие порталы сконфигурированы и подключены |
+| `bitrix_call` | любой разрешённый вызов из каталога по имени (в т.ч. мутирующий) |
+| *Задачи* | |
+| `bitrix_tasks_list` / `bitrix_task_get` | список задач / карточка |
+| `bitrix_task_get_v2` | карточка через v2-подсистему (JSON) |
+| `bitrix_task_scrum_info` | scrum-инфо (спринт / эпик / story points) |
+| `bitrix_task_files` | файлы задачи |
+| `bitrix_task_views_count` | счётчик просмотров |
+| `bitrix_task_subtasks` / `bitrix_task_related` | подзадачи / связанные задачи |
+| *Проекты* | |
 | `bitrix_projects_list` / `bitrix_project_get` | рабочие группы / проекты |
-| `bitrix_chats_recent` / `bitrix_chat_messages` | чаты и история сообщений |
+| *Чаты* | |
+| `bitrix_chats_recent` | недавние чаты (REST) |
+| `bitrix_recent_load` / `bitrix_recent_tail` | недавние по секции (в т.ч. `tasksTask` — чаты задач) + листание |
+| `bitrix_chat_load` | открыть чат по `dialogId`/`chatId` |
+| `bitrix_chat_messages` | последние сообщения чата |
+| `bitrix_chat_history` | листать историю вглубь |
+| `bitrix_chat_get_dialog_id` | резолв dialogId по externalId |
+| `bitrix_chat_mark_read` ⚠ / `bitrix_chat_read_all` ⚠ | пометить сообщения / все чаты прочитанными |
+| *Люди / поиск* | |
+| `bitrix_user_get` | карточка пользователя |
+| `bitrix_entity_selector` / `bitrix_entity_search` | загрузка селектора / текстовый поиск сущностей |
 
 `bitrix_help` — единственный источник конвенций params (select/filter/order/пагинация,
 имена полей). Он отдаёт `docs/api-notes.md`, так что любому агенту не нужен доступ к репозиторию.
@@ -124,9 +146,13 @@ Runtime-домашняя папка — `~/.bitrix24-mcp-bridge/` (или `$BITR
 привилегия — живая аутентифицированная сессия Bitrix24 — физически в расширении, а не в
 сервере. Отсюда:
 
-- **Read-only — гарантия «доброй воли», а не защита.** Ограничение на чтение — это
-  denylist мутирующих глаголов (`…add`/`…update`/`…delete`/…) в каталоге; каталог с
-  мутирующим вызовом просто не загрузится. Значения `params` при этом не инспектируются.
+- **Граница — это allowlist каталога, не режим чтения.** Мост выполняет только именованные
+  вызовы из `actions.json` — теперь среди них могут быть мутирующие. Общий локальный токен
+  (риск G7) в write-режиме означает: процесс, знающий токен и порт демона, может выполнять
+  эти действия в объёме прав пользователя. Внутри разрешённого действия значения `params`
+  не инспектируются — для мутирующего вызова это означает полный контроль агента над телом
+  запроса в рамках этого действия. Держи `actions.json` под контролем — это и есть
+  граница возможностей агента.
 - **Токен — единственная защита loopback-WS.** Генерируйте длинный и случайный —
   `setup` использует `crypto.randomBytes(32)`. Токен отсекает случайные подключения, но
   не является границей против локального атакующего: любой локальный процесс, знающий
@@ -167,6 +193,15 @@ bun run build:ext               # dev-сборка пер-пользовател
 `setup` затем копирует в runtime-домашнюю папку. Публикуемые файлы перечислены в `files`
 (`dist`, `extension/dist`, `docs/api-notes.md`, `actions.example.json`).
 
+### Релизы
+
+Версионирование и публикация автоматизированы (conventional commits →
+[release-please](.github/workflows/release-please.yml)): бот ведёт release-PR с bump'ом версии и
+`CHANGELOG.md`; при его мерже создаётся GitHub Release/тег и пакет публикуется в npm через **OIDC
+Trusted Publisher** (с provenance, без токенов). CI ([`.github/workflows/ci.yml`](.github/workflows/ci.yml))
+гоняет `typecheck` + тесты на push/PR. Ручная до-публикация застрявшего релиза — `workflow_dispatch`
+на `release-please`.
+
 ## Документация
 
 - [docs/RUNBOOK.md](docs/RUNBOOK.md) — установка, настройка, повседневная работа, диагностика

package/actions.example.json

@@ -1,33 +1,29 @@
 {
-  "tasks.list": {
-    "action": "tasks.task.list",
-    "method": "POST"
-  },
-  "task.get": {
-    "action": "tasks.task.get",
-    "method": "POST"
-  },
-  "projects.list": {
-    "action": "socialnetwork.api.workgroup.list",
-    "method": "POST"
-  },
-  "projects.get": {
-    "action": "socialnetwork.api.workgroup.get",
-    "method": "POST"
-  },
-  "chats.recent": {
-    "endpoint": "/rest/im.recent.list.json",
-    "method": "POST",
-    "params": {
-      "LIMIT": 50,
-      "SKIP_OPENLINES": "Y",
-      "GET_ORIGINAL_TEXT": "Y",
-      "PARSE_TEXT": "Y",
-      "WITH_COUNTERS": "N"
-    }
-  },
-  "chat.messages": {
-    "action": "im.v2.Chat.Message.list",
-    "method": "POST"
-  }
+  "tasks.list": { "action": "tasks.task.list", "method": "POST" },
+  "task.get": { "action": "tasks.task.get", "method": "POST" },
+  "task.v2.get": { "action": "tasks.v2.Task.get", "method": "POST", "bodyType": "json" },
+  "task.scrum.info": { "action": "tasks.v2.Scrum.getTaskInfo", "method": "POST", "bodyType": "json" },
+  "task.files": { "action": "tasks.v2.File.listObjects", "method": "POST", "bodyType": "json" },
+  "task.views.count": { "action": "tasks.v2.Task.View.User.count", "method": "POST", "bodyType": "json" },
+
+  "projects.list": { "action": "socialnetwork.api.workgroup.list", "method": "POST" },
+  "projects.get": { "action": "socialnetwork.api.workgroup.get", "method": "POST" },
+
+  "chats.recent": { "endpoint": "/rest/im.recent.list.json", "method": "POST", "params": { "LIMIT": 50, "SKIP_OPENLINES": "Y", "GET_ORIGINAL_TEXT": "Y", "PARSE_TEXT": "Y", "WITH_COUNTERS": "N" } },
+  "chat.load": { "action": "im.v2.Chat.load", "method": "POST", "params": { "messageLimit": 25 } },
+  "chat.messages": { "action": "im.v2.Chat.Message.list", "method": "POST" },
+  "chat.messages.tail": { "action": "im.v2.Chat.Message.tail", "method": "POST", "params": { "order[id]": "DESC", "limit": 25 } },
+  "chat.message.read": { "action": "im.v2.Chat.Message.read", "method": "POST" },
+
+  "entityselector.load": { "action": "ui.entityselector.load", "method": "POST", "bodyType": "json" },
+  "entityselector.search": { "action": "ui.entityselector.doSearch", "method": "POST", "bodyType": "json" },
+
+  "recent.load": { "action": "im.v2.Recent.load", "method": "POST" },
+  "recent.tail": { "action": "im.v2.Recent.tail", "method": "POST" },
+  "chat.dialogId": { "action": "im.v2.Chat.getDialogId", "method": "POST" },
+  "chat.read.all": { "action": "im.v2.Chat.readAll", "method": "POST" },
+  "im.user.get": { "endpoint": "/rest/im.user.get.json", "method": "POST" },
+
+  "task.subtasks": { "action": "tasks.v2.Task.Relation.Child.list", "method": "POST", "bodyType": "json" },
+  "task.related": { "action": "tasks.v2.Task.Relation.Related.list", "method": "POST", "bodyType": "json" }
 }