bitrix24-mcp-bridge 0.2.1 → 0.4.0

package/README.md

@@ -52,6 +52,19 @@ bitrix24-mcp-bridge`.
   портал по умолчанию, `[p]` порт, `[t]` ротировать токен, `[u]` обновить
   расширение из установленного пакета, `[q]` выход.
 
+**Обновление пакета** почти полностью автоматическое:
+
+- **Каталог** — новые записи дописываются в ваш `~/.bitrix24-mcp-bridge/actions.json` при следующем
+  старте (в stderr — `[catalog] added N new entries…`). Ваши записи и правки не трогаются, а запись,
+  которую вы удалили сами, назад не возвращается: доставленные ключи помечаются в
+  `catalog-state.json`, поэтому удаление считается решением, а не пробелом.
+- **Файлы расширения** в `~/.bitrix24-mcp-bridge/extension/` обновляются там же автоматически, если
+  версия пакета изменилась (`[extension] refreshed …`), — запускать `setup` → `[u]` вручную больше не нужно.
+- **Один ручной шаг остаётся:** нажать «Обновить» на расширении в `chrome://extensions` и перезагрузить
+  вкладку портала. Программно это сделать нельзя — Chrome перечитывает файлы unpacked-расширения только
+  сам. Пока этого не сделано, `bitrix_status` возвращает `warning` с версиями моста и расширения, так
+  что рассинхрон виден сразу, а не всплывает необъяснимой ошибкой.
+
 **Мультипортальность** поддержана: каждый портал — отдельная запись, а в манифесте
 расширения `matches`/`host_permissions` перечисляют ровно сконфигурированные origin'ы
 (least-privilege на origin).
@@ -97,6 +110,7 @@ daemon после любой правки, затрагивающей конфи
 | *Люди / поиск* | |
 | `bitrix_user_get` | карточка пользователя |
 | `bitrix_entity_selector` / `bitrix_entity_search` | загрузка селектора / текстовый поиск сущностей |
+| `bitrix_entity_chat` | chatId чата связанного объекта (задача/группа/CRM) через `im.chat.get` |
 
 `bitrix_help` — единственный источник конвенций params (select/filter/order/пагинация,
 имена полей). Он отдаёт `docs/api-notes.md`, так что любому агенту не нужен доступ к репозиторию.
@@ -181,13 +195,23 @@ bun run src/index.ts --daemon   # daemon вручную
 bun run src/index.ts setup      # интерактивная настройка
 bun test                        # юнит-тесты (bun:test)
 bun run typecheck               # tsc --noEmit (сервер + extension)
-bun run build:ext               # dev-сборка пер-пользовательского расширения
+bun run build:dist              # бандл сервера → dist/cli.js
+bun run build:ext               # dev-сборка расширения → extension/dev/ (загружаемое)
+bun run sync:runtime            # применить репо-изменения к живому daemon (см. ниже)
 ```
 
-`.env` — **только dev-оверрайд** (gitignored): `BITRIX_MCP_TOKEN`, `BITRIX_ORIGIN`,
-`BITRIX_MCP_PORT`, опционально `BITRIX_CATALOG`. В проде конфиг живёт в
+`.env` — **только dev-оверрайды** (gitignored). Токен / origin / порт берутся из общего
+`~/.bitrix24-mcp-bridge/config.json` (через `loadConfig`) — дублировать их в `.env` не нужно, иначе
+dev-токен разойдётся с daemon. Осмысленно держать там лишь `BITRIX_CATALOG` (указывает
+dev-сборку/daemon на репозиторный `actions.json`). В проде весь конфиг — в
 `~/.bitrix24-mcp-bridge/config.json`, который пишет `setup`.
 
+**Репо ≠ живой daemon.** Daemon, к которому ходят агенты, читает **runtime-папку**
+(`~/.bitrix24-mcp-bridge/actions.json` + запущенный `dist/cli.js`), а не файлы репозитория. После
+правки каталога или кода сервера выполни **`bun run sync:runtime`**: она пересоберёт бандл, скопирует
+репо-`actions.json` в runtime-папку и погасит daemon (следующий вызов агента поднимет свежий). Без
+этого новые инструменты/методы агенту не видны.
+
 Дистрибуция: `bin` `bitrix24-bridge` → `dist/cli.js`; npm-хук `prepare` при установке
 собирает и `dist/cli.js`, и статичные бандлы расширения (`extension/dist/`), которые
 `setup` затем копирует в runtime-домашнюю папку. Публикуемые файлы перечислены в `files`
@@ -205,6 +229,6 @@ Trusted Publisher** (с provenance, без токенов). CI ([`.github/workfl
 ## Документация
 
 - [docs/RUNBOOK.md](docs/RUNBOOK.md) — установка, настройка, повседневная работа, диагностика
-- [docs/api-notes.md](docs/api-notes.md) — карта API Bitrix24 (единый источник для `bitrix_help`)
-- [docs/reconnaissance.md](docs/reconnaissance.md) — как снять HAR и расширить `actions.json`
+- [docs/api-notes.md](docs/api-notes.md) — карта API Bitrix24 для агента (единый источник для `bitrix_help`)
+- [docs/reconnaissance.md](docs/reconnaissance.md) — capture, транспорт записи каталога, расширение `actions.json`
 - [extension/README.md](extension/README.md) — устройство расширения и модель доверия

package/actions.example.json

@@ -23,7 +23,10 @@
   "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" },
+  "im.chat.get": { "endpoint": "/rest/im.chat.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" }
+  "task.related": { "action": "tasks.v2.Task.Relation.Related.list", "method": "POST", "bodyType": "json" },
+
+  "call.detail": { "endpoint": "/call/detail/{callId}", "method": "GET", "params": { "IFRAME": "Y", "IFRAME_TYPE": "SIDE_SLIDER" }, "responseType": "text" }
 }