npm - bitrix24-mcp-bridge - Versions diffs - 0.1.1 → 0.2.0 - Mend

bitrix24-mcp-bridge 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md +14 -8
package/actions.example.json +27 -31
package/dist/cli.js +190 -45
package/docs/api-notes.md +234 -45
package/extension/dist/connector.js +8 -4
package/extension/dist/connector.js.map +2 -2
package/package.json +7 -2

package/README.md CHANGED Viewed

@@ -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,8 +65,9 @@ daemon после любой правки, затрагивающей конфи
 ## Инструменты
-Все — read-only, каждый принимает необязательный параметр `portal` (alias; по умолчанию —
-портал по умолчанию из `config.json`):
+Типизированные инструменты — read-only; `bitrix_call` выполняет любой разрешённый каталогом
+вызов, включая мутирующие. Каждый принимает необязательный параметр `portal` (alias; по
+умолчанию — портал по умолчанию из `config.json`):
 | Инструмент | Назначение |
 |---|---|
@@ -124,9 +126,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)`. Токен отсекает случайные подключения, но
   не является границей против локального атакующего: любой локальный процесс, знающий

package/actions.example.json CHANGED Viewed

@@ -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" }
 }

package/dist/cli.js CHANGED Viewed

@@ -25096,7 +25096,7 @@ var Daemon = class {
             reply({ type: "result", id: msg.id, ok: false, error: `unknown portal "${msg.portal}"` });
             continue;
           }
-          this.bridge.call(origin, { endpoint: msg.endpoint, action: msg.action, method: msg.method, params: msg.params }).then((data) => reply({ type: "result", id: msg.id, ok: true, data })).catch((e) => reply({ type: "result", id: msg.id, ok: false, error: e instanceof Error ? e.message : String(e) }));
+          this.bridge.call(origin, { endpoint: msg.endpoint, action: msg.action, method: msg.method, params: msg.params, bodyType: msg.bodyType }).then((data) => reply({ type: "result", id: msg.id, ok: true, data })).catch((e) => reply({ type: "result", id: msg.id, ok: false, error: e instanceof Error ? e.message : String(e) }));
         }
       } catch (e) {
         console.error(`[daemon] dropping malformed UDS data: ${e instanceof Error ? e.message : String(e)}`);
@@ -25274,46 +25274,12 @@ var entrySchema = external_exports.object({
   endpoint: external_exports.string().min(1).default("/bitrix/services/main/ajax.php"),
   action: external_exports.string().nullable().default(null),
   method: external_exports.enum(["GET", "POST"]).default("POST"),
-  params: external_exports.record(external_exports.unknown()).default({})
+  params: external_exports.record(external_exports.unknown()).default({}),
+  bodyType: external_exports.enum(["json", "form"]).default("form")
 });
 var fileSchema = external_exports.record(entrySchema);
-var MUTATING_VERBS = /* @__PURE__ */ new Set([
-  "add",
-  "update",
-  "delete",
-  "set",
-  "complete",
-  "remove",
-  "create",
-  "save",
-  "send",
-  "rename",
-  "move",
-  "import",
-  "attach",
-  "bind",
-  "unbind"
-]);
-function tokenize(s) {
-  return s.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
-}
-function assertReadOnly(name, entry) {
-  for (const field of [entry.action, entry.endpoint]) {
-    if (!field) continue;
-    for (const token of tokenize(field)) {
-      if (MUTATING_VERBS.has(token)) {
-        throw new Error(
-          `catalog entry "${name}" looks mutating ("${token}") \u2014 this bridge is read-only`
-        );
-      }
-    }
-  }
-}
 function loadCatalog(path) {
   const raw = fileSchema.parse(JSON.parse(readFileSync2(path, "utf8")));
-  for (const [name, entry] of Object.entries(raw)) {
-    assertReadOnly(name, entry);
-  }
   return {
     resolve(name) {
       if (!Object.prototype.hasOwnProperty.call(raw, name)) {
@@ -25330,9 +25296,10 @@ function loadCatalog(path) {
 // src/tools/help.ts
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var API_NOTES = fileURLToPath2(new URL("../../docs/api-notes.md", import.meta.url));
-var HELP = '# Bitrix24 API notes (reverse-engineered)\n\n\u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0435\u043C\u0443 API Bitrix24, \u0434\u043E\u0431\u044B\u0442\u044B\u0439 **\u0436\u0438\u0432\u044B\u043C \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C** (\u0443 \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0438\u0445 ajax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u043E\u0432\n\u043D\u0435\u0442 \u043F\u0443\u0431\u043B\u0438\u0447\u043D\u043E\u0439 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u0438). \u041F\u0440\u0435\u0434\u043D\u0430\u0437\u043D\u0430\u0447\u0435\u043D \u0434\u043B\u044F \u043B\u044E\u0431\u043E\u0433\u043E \u0418\u0418-\u0430\u0433\u0435\u043D\u0442\u0430 \u0438\u043B\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043E\u0442\u0447\u0438\u043A\u0430, \u043A\u043E\u0442\u043E\u0440\u044B\u0439 \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442\n\u044D\u0442\u0438 \u043C\u0435\u0442\u043E\u0434\u044B \u0447\u0435\u0440\u0435\u0437 \u043C\u043E\u0441\u0442 (`bitrix_call` / \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B) \u0438\u043B\u0438 \u0440\u0430\u0441\u0448\u0438\u0440\u044F\u0435\u0442 \u043A\u0430\u0442\u0430\u043B\u043E\u0433.\n\n\u041D\u0430\u0431\u043B\u044E\u0434\u0435\u043D\u0438\u044F \u0441\u043D\u044F\u0442\u044B \u043D\u0430 \u043F\u043E\u0440\u0442\u0430\u043B\u0435 `example.bitrix24.ru` (\u043E\u0431\u043B\u0430\u043A\u043E, \u043C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 **im.v2**, \u0437\u0430\u0434\u0430\u0447\u0438 \u0432 \u0440\u0435\u0436\u0438\u043C\u0435\n**scrum-\u0431\u043E\u0440\u0434\u0430**). \u0418\u043C\u0435\u043D\u0430 \u043F\u043E\u043B\u0435\u0439 \u0438 \u043A\u043E\u043D\u0432\u0435\u043D\u0446\u0438\u0438 \u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442\u043D\u044B \u0434\u043B\u044F \u043E\u0431\u043B\u0430\u0447\u043D\u043E\u0433\u043E Bitrix24, \u043D\u043E \u043F\u0440\u0438 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0435 \u043D\u0430 \u0434\u0440\u0443\u0433\u043E\u0439\n\u043F\u043E\u0440\u0442\u0430\u043B \u0441\u0432\u0435\u0440\u044F\u0439\u0441\u044F \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C (`docs/reconnaissance.md`).\n\n---\n\n## 1. \u041A\u0430\u043A \u0432\u044B\u0437\u044B\u0432\u0430\u0442\u044C\n\n- **\u0422\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B** (`bitrix_tasks_list`, `bitrix_task_get`, `bitrix_projects_list`,\n  `bitrix_project_get`, `bitrix_chats_recent`, `bitrix_chat_messages`) \u2014 \u0441 \u0440\u0430\u0437\u0443\u043C\u043D\u044B\u043C\u0438 \u0434\u0435\u0444\u043E\u043B\u0442\u0430\u043C\u0438.\n  \u0422\u043E\u0447\u043D\u0430\u044F \u0432\u044B\u0431\u043E\u0440\u043A\u0430 \u2014 \u0447\u0435\u0440\u0435\u0437 \u043E\u043F\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u044B\u0439 \u0430\u0440\u0433\u0443\u043C\u0435\u043D\u0442 **`params`** (\u043D\u0430\u0442\u0438\u0432\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 Bitrix), \u043E\u043D \u043C\u0435\u0440\u0436\u0438\u0442\u0441\u044F\n  **\u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u043C** \u0438 \u043F\u0435\u0440\u0435\u043A\u0440\u044B\u0432\u0430\u0435\u0442 \u0434\u0435\u0444\u043E\u043B\u0442\u044B. \u041F\u043E\u0434\u0441\u043A\u0430\u0437\u043A\u0438 \u043F\u043E \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u0430\u043C \u0435\u0441\u0442\u044C \u0432 \u043E\u043F\u0438\u0441\u0430\u043D\u0438\u0438 \u043A\u0430\u0436\u0434\u043E\u0433\u043E \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u0430.\n- **`bitrix_call { name, params }`** \u2014 \u0443\u043D\u0438\u0432\u0435\u0440\u0441\u0430\u043B\u044C\u043D\u044B\u0439 \u0432\u044B\u0437\u043E\u0432 \u043B\u044E\u0431\u043E\u0433\u043E \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u043E\u0433\u043E \u0438\u043C\u0435\u043D\u0438 \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430\n  (`actions.json`). \u0422\u043E\u0442 \u0436\u0435 `params`-\u043C\u0435\u0445\u0430\u043D\u0438\u0437\u043C.\n- **`bitrix_help`** \u2014 \u044D\u0442\u043E\u0442 \u0436\u0435 \u0433\u0430\u0439\u0434, \u043E\u0442\u0434\u0430\u0451\u0442\u0441\u044F \u0447\u0435\u0440\u0435\u0437 MCP (\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 + resource `bitrix://api-notes`),\n  \u0447\u0442\u043E\u0431\u044B \u043B\u044E\u0431\u043E\u0439 \u0430\u0433\u0435\u043D\u0442 \u0440\u0430\u0437\u043E\u0431\u0440\u0430\u043B\u0441\u044F \u0431\u0435\u0437 \u0434\u043E\u0441\u0442\u0443\u043F\u0430 \u043A \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u044E. \u0418\u0441\u0442\u043E\u0447\u043D\u0438\u043A \u2014 **\u044D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B** (`docs/api-notes.md`).\n- \u0412\u0441\u0451 **read-only**: \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0435 \u0432\u044B\u0437\u043E\u0432\u044B (`\u2026add/update/delete/set/complete/\u2026`) \u043E\u0442\u0432\u0435\u0440\u0433\u0430\u044E\u0442\u0441\u044F \u043F\u0440\u0438 \u0437\u0430\u0433\u0440\u0443\u0437\u043A\u0435 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430.\n\n---\n\n## 2. \u0424\u043E\u0440\u043C\u0430\u0442 \u043E\u0442\u0432\u0435\u0442\u0430 (\u0432\u0430\u0436\u043D\u043E!)\n\nAjax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u044B (`/bitrix/services/main/ajax.php`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 HTTP 200 \u0441 \u043A\u043E\u043D\u0432\u0435\u0440\u0442\u043E\u043C:\n\n```jsonc\n{ "status": "success" | "error",\n  "data": { ... },\n  "errors": [] }          // \u041F\u0423\u0421\u0422\u041E\u0419 \u043C\u0430\u0441\u0441\u0438\u0432 \u043F\u0440\u0438 \u0443\u0441\u043F\u0435\u0445\u0435! (\u0432 JS [] \u2014 truthy)\n```\n\n- \u0423\u0441\u043F\u0435\u0445 \u043E\u043F\u0440\u0435\u0434\u0435\u043B\u044F\u0435\u0442\u0441\u044F `status:"success"` \u0438/\u0438\u043B\u0438 **\u043F\u0443\u0441\u0442\u044B\u043C** `errors`. \u041D\u0435\u043F\u0443\u0441\u0442\u043E\u0439 `errors` / `status:"error"` /\n  top-level `error` \u2014 \u0440\u0435\u0430\u043B\u044C\u043D\u0430\u044F \u043E\u0448\u0438\u0431\u043A\u0430.\n- REST-\u044D\u043D\u0434\u043F\u043E\u0438\u043D\u0442\u044B (`/rest/*.json`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 \u0438\u043D\u0430\u0447\u0435: `{ "result": \u2026, "next", "total", "time" }` \u2014 \u0431\u0435\u0437 `errors`.\n\n---\n\n## 3. \u0422\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 \u0438 \u043A\u043E\u043D\u0432\u0435\u043D\u0446\u0438\u0438 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432 (\u0440\u0430\u0437\u043B\u0438\u0447\u0430\u044E\u0442\u0441\u044F \u043F\u043E \u043C\u0435\u0442\u043E\u0434\u0443!)\n\n\u041C\u043E\u0441\u0442 \u0448\u043B\u0451\u0442 `application/x-www-form-urlencoded` \u0441\u043E **\u0441\u0432\u0435\u0436\u0438\u043C `sessid`** \u0432 \u0442\u0435\u043B\u0435; \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u043E\u0441\u0442\u044C \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\u0441\u044F\nPHP-\u0441\u0442\u0438\u043B\u0435\u043C (`filter[STATUS]=2`, `select[0]=ID`). \u041E\u0431\u044A\u0435\u043A\u0442 \u0432 `params` \u0440\u0435\u043A\u0443\u0440\u0441\u0438\u0432\u043D\u043E \u0440\u0430\u0437\u0432\u043E\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044F \u0432 \u0442\u0430\u043A\u0438\u0435 \u043A\u043B\u044E\u0447\u0438.\n\n| \u041C\u0435\u0442\u043E\u0434 (action / endpoint) | \u0422\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 | \u0413\u0434\u0435 `select`/`filter`/`order` | \u041F\u0430\u0433\u0438\u043D\u0430\u0446\u0438\u044F |\n|---|---|---|---|\n| `tasks.task.list` | ajax, \u0444\u043E\u0440\u043C\u0430 | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `filter{}`, `order{}` | `start` (\u0441\u0434\u0432\u0438\u0433, \u0448\u0430\u0433 50) |\n| `tasks.task.get` | ajax, \u0444\u043E\u0440\u043C\u0430 | \u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C: `taskId`, `select[]` | \u2014 |\n| `socialnetwork.api.workgroup.list` | ajax, \u0444\u043E\u0440\u043C\u0430 | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `order{}`, `filter{}` | (nav \u2014 \u043D\u0435 \u043F\u0440\u043E\u0432\u0435\u0440\u0435\u043D\u043E) |\n| `socialnetwork.api.workgroup.get` | ajax, \u0444\u043E\u0440\u043C\u0430 | **\u043E\u0431\u0451\u0440\u043D\u0443\u0442\u043E**: `params[groupId]`, `params[select][]` | \u2014 |\n| `im.v2.Chat.Message.list` | ajax, \u0444\u043E\u0440\u043C\u0430 | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `limit`, `filter[lastId]` | `filter[lastId]` + `limit` |\n| `im.recent.list` (`/rest/im.recent.list.json`) | rest, \u0444\u043E\u0440\u043C\u0430 | \u043F\u043B\u043E\u0441\u043A\u043E: `LIMIT`, `SKIP_OPENLINES`, `UNREAD_ONLY`, \u2026 | `LIMIT` |\n\n\u26A0\uFE0F **`tasks.v2.*` (\u043D\u0430\u043F\u0440. `tasks.v2.Task.get`) \u0448\u043B\u0451\u0442 JSON-\u0442\u0435\u043B\u043E** (`{"task":{"id":N}}`), \u0430 \u043C\u043E\u0441\u0442 \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\n\u0444\u043E\u0440\u043C\u0443 \u2014 **\u043D\u0435 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 `tasks.v2.*`**, \u0431\u0435\u0440\u0438 \u043A\u043B\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043A\u0438\u0435 `tasks.task.*`. \u041C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 `im.v2.*` \u043F\u0440\u0438 \u044D\u0442\u043E\u043C\n\u043F\u0440\u0438\u043D\u0438\u043C\u0430\u0435\u0442 \u043E\u0431\u044B\u0447\u043D\u0443\u044E \u0444\u043E\u0440\u043C\u0443 (\u044D\u0442\u043E \u0440\u0430\u0437\u043D\u044B\u0435 \u043F\u043E\u0434\u0441\u0438\u0441\u0442\u0435\u043C\u044B, \u043D\u0435\u0441\u043C\u043E\u0442\u0440\u044F \u043D\u0430 \u043E\u0431\u0449\u0438\u0439 \u043F\u0440\u0435\u0444\u0438\u043A\u0441 \xABv2\xBB).\n\nCSRF: \u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u044B \u0442\u0440\u0435\u0431\u0443\u044E\u0442 `sessid` \u0432 \u0442\u0435\u043B\u0435 \u2014 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0435 \u043F\u043E\u0434\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 \u0441\u0432\u0435\u0436\u0438\u0439 `BX.bitrix_sessid()`\n\u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438. \u041E\u0442\u0432\u0435\u0442 `invalid_csrf`/`invalid_authentication` = \u0441\u0435\u0441\u0441\u0438\u044F \u043F\u0440\u043E\u0442\u0443\u0445\u043B\u0430 (\u043F\u0435\u0440\u0435\u043B\u043E\u0433\u0438\u043D\u044C\u0441\u044F \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435).\n\n---\n\n## 4. \u0422\u0440\u0438\u0430\u0434\u0430: \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u2192 action \u2192 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B\n\n| \u0418\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 | \u041A\u0430\u0442\u0430\u043B\u043E\u0433 (`actions.json`) | action / endpoint | \u041A\u043B\u044E\u0447\u0435\u0432\u044B\u0435 params |\n|---|---|---|---|\n| `bitrix_tasks_list` | `tasks.list` | `tasks.task.list` | `filter{RESPONSIBLE_ID,REAL_STATUS,GROUP_ID,\u2026}`, `select[]`, `order{}`, `start` |\n| `bitrix_task_get` | `task.get` | `tasks.task.get` | `taskId`, `select[]` |\n| `bitrix_projects_list` | `projects.list` | `socialnetwork.api.workgroup.list` | `select[]`, `order{}`, `filter{}` |\n| `bitrix_project_get` | `projects.get` | `socialnetwork.api.workgroup.get` | `params[groupId]`, `params[select][]` |\n| `bitrix_chats_recent` | `chats.recent` | `/rest/im.recent.list.json` | `LIMIT`, `UNREAD_ONLY`, `SKIP_OPENLINES` |\n| `bitrix_chat_messages` | `chat.messages` | `im.v2.Chat.Message.list` | `chatId`, `limit`, `filter[lastId]` |\n\n---\n\n## 5. \u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E\u043B\u0435\u0439\n\n**\u0417\u0430\u0434\u0430\u0447\u0430** (`tasks.task.*`): `ID`, `TITLE`, `DESCRIPTION`, `STATUS`, `REAL_STATUS`, `RESPONSIBLE_ID`,\n`CREATED_BY`, `CREATED_DATE`, `CHANGED_DATE`, `DEADLINE`, `CLOSED_DATE`, `PRIORITY`, `GROUP_ID`,\n`TAGS`, `TIME_ESTIMATE`, `UF_*`. \u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u0430\u0434\u044B\u0432\u0430\u0435\u0442 \u043E\u0431\u044A\u0435\u043A\u0442\u044B `group`, `responsible`, `creator`, `action`.\n\n\u0421\u0442\u0430\u0442\u0443\u0441\u044B \u0437\u0430\u0434\u0430\u0447\u0438 (`STATUS`): `1` \u041D\u043E\u0432\u0430\u044F \xB7 `2` \u0416\u0434\u0451\u0442 \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \xB7 `3` \u0412\u044B\u043F\u043E\u043B\u043D\u044F\u0435\u0442\u0441\u044F \xB7 `4` \u0416\u0434\u0451\u0442 \u043A\u043E\u043D\u0442\u0440\u043E\u043B\u044F \xB7\n`5` \u0417\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0430 \xB7 `6` \u041E\u0442\u043B\u043E\u0436\u0435\u043D\u0430 \xB7 `7` \u041E\u0442\u043A\u043B\u043E\u043D\u0435\u043D\u0430.\n\n**\u0413\u0440\u0443\u043F\u043F\u0430/\u043F\u0440\u043E\u0435\u043A\u0442 \u2014 \u0441\u043F\u0438\u0441\u043E\u043A** (`workgroup.list`, camelCase \u0432 \u043E\u0442\u0432\u0435\u0442\u0435): `ID`, `NAME`, `DESCRIPTION`,\n`NUMBER_OF_MEMBERS`, `OWNER_ID`, `DATE_CREATE`, `PROJECT` (Y/N), `TYPE`.\n**\u0413\u0440\u0443\u043F\u043F\u0430 \u2014 \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430** (`workgroup.get`): \u043F\u043B\u044E\u0441 `OWNER_DATA`, `SUBJECT_DATA`, `MEMBERS[]`,\n`MODERATOR_MEMBERS[]`, `CHAT_ID`, `DIALOG_ID`, `IMAGE_ID`, UF-\u043F\u043E\u043B\u044F.\n\n**\u041D\u0435\u0434\u0430\u0432\u043D\u0438\u0439 \u0447\u0430\u0442** (`im.recent.list`): `chat_id`, `title`, `type`, `message{id,text,date,author_id}`,\n`last_id`, `unread`, `pinned`, `user{\u2026}`, `chat{\u2026}`.\n**\u0421\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0435** (`im.v2.Chat.Message.list`): `id`, `chatId`, `authorId`, `date`, `text`, `params`, `viewed`.\n\u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043D\u0435\u0441\u0451\u0442 `users[]` (\u0443\u0447\u0430\u0441\u0442\u043D\u0438\u043A\u0438), `additionalMessages[]`, `hasPrevPage`/`hasNextPage`.\n\n---\n\n## 6. \u041F\u0440\u0438\u043C\u0435\u0440\u044B \u0442\u043E\u0447\u043D\u044B\u0445 \u0432\u044B\u0431\u043E\u0440\u043E\u043A\n\n```jsonc\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044B\u0435 \u0437\u0430\u0434\u0430\u0447\u0438 \u043E\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043D\u043D\u043E\u0433\u043E 55, \u043F\u043E \u0434\u0435\u0434\u043B\u0430\u0439\u043D\u0443, \u0432\u0442\u043E\u0440\u0430\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430\nbitrix_tasks_list { "params": { "filter": {"RESPONSIBLE_ID":55,"REAL_STATUS":2},\n                                "order": {"DEADLINE":"asc"}, "start": 50 } }\n\n// \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0437\u0430\u0434\u0430\u0447\u0438 \u0441 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u043D\u044B\u043C \u043D\u0430\u0431\u043E\u0440\u043E\u043C \u043F\u043E\u043B\u0435\u0439\nbitrix_task_get { "taskId": 4229, "params": { "select": ["ID","TITLE","DESCRIPTION","TAGS","TIME_ESTIMATE"] } }\n\n// \u043F\u0440\u043E\u0435\u043A\u0442\u044B, \u043E\u0442\u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u043F\u043E \u0434\u0430\u0442\u0435 \u0441\u043E\u0437\u0434\u0430\u043D\u0438\u044F\nbitrix_projects_list { "params": { "order": {"DATE_CREATE":"desc"} } }\n\n// \u043F\u043E\u043B\u043D\u0430\u044F \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0433\u0440\u0443\u043F\u043F\u044B\nbitrix_project_get { "groupId": 15 }\n\n// \u0433\u043B\u0443\u0431\u0436\u0435 \u0432 \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u0447\u0430\u0442\u0430\nbitrix_chat_messages { "chatId": 485, "limit": 50, "beforeId": 1936695 }\n```\n\n---\n\n## 7. \u041A\u0430\u043A \u0440\u0430\u0441\u0448\u0438\u0440\u0438\u0442\u044C (\u043D\u043E\u0432\u044B\u0439 \u0434\u043E\u043C\u0435\u043D: \u043A\u0430\u043B\u0435\u043D\u0434\u0430\u0440\u044C, \u0434\u0438\u0441\u043A, CRM, \u2026)\n\n1. \u0421\u043D\u0438\u043C\u0438 \u0440\u0435\u0430\u043B\u044C\u043D\u044B\u0435 \u0432\u044B\u0437\u043E\u0432\u044B (`docs/reconnaissance.md` \u2014 \u0430\u0432\u0442\u043E-\u0437\u0430\u043F\u0438\u0441\u044C `bun run capture` \u0438\u043B\u0438 HAR).\n2. \u041E\u043F\u0440\u0435\u0434\u0435\u043B\u0438 \u0442\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 \u0438 \u0444\u043E\u0440\u043C\u0443 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432 \u043F\u043E \u0440\u0430\u0437\u0434\u0435\u043B\u0443 3 (\u0441\u0432\u0435\u0440\u044C\u0441\u044F \u0441 `sampleParams` \u0438\u0437 \u0447\u0435\u0440\u043D\u043E\u0432\u0438\u043A\u0430).\n3. \u0414\u043E\u0431\u0430\u0432\u044C \u0437\u0430\u043F\u0438\u0441\u044C \u0432 `actions.json` (\u0442\u043E\u043B\u044C\u043A\u043E read-only). \u041F\u0440\u043E\u0432\u0435\u0440\u044C \u0447\u0435\u0440\u0435\u0437 `bitrix_call { name, params }`.\n4. \u0415\u0441\u043B\u0438 \u0443\u0434\u043E\u0431\u043D\u043E \u2014 \u043E\u0431\u0435\u0440\u043D\u0438 \u0432 \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0439 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u0432 `src/tools/register.ts` (\u0441 \u0434\u0435\u0444\u043E\u043B\u0442\u043D\u044B\u043C `select`).\n\n> `actions.json` \u2014 \u0434\u0430\u043D\u043D\u044B\u0435 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u0433\u043E \u043F\u043E\u0440\u0442\u0430\u043B\u0430 (gitignored). \u042D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B (`api-notes.md`) \u2014 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0438\u043C\u044B\u0435\n> \u0437\u043D\u0430\u043D\u0438\u044F \u043E \u0441\u0430\u043C\u043E\u043C API; \u0434\u0435\u0440\u0436\u0438 \u0435\u0433\u043E \u0432 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u043E\u043C \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0438 \u043F\u0440\u0438 \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u0438 \u043D\u043E\u0432\u044B\u0445 \u043C\u0435\u0442\u043E\u0434\u043E\u0432.\n' ? '# Bitrix24 API notes (reverse-engineered)\n\n\u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0435\u043C\u0443 API Bitrix24, \u0434\u043E\u0431\u044B\u0442\u044B\u0439 **\u0436\u0438\u0432\u044B\u043C \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C** (\u0443 \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0438\u0445 ajax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u043E\u0432\n\u043D\u0435\u0442 \u043F\u0443\u0431\u043B\u0438\u0447\u043D\u043E\u0439 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u0438). \u041F\u0440\u0435\u0434\u043D\u0430\u0437\u043D\u0430\u0447\u0435\u043D \u0434\u043B\u044F \u043B\u044E\u0431\u043E\u0433\u043E \u0418\u0418-\u0430\u0433\u0435\u043D\u0442\u0430 \u0438\u043B\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043E\u0442\u0447\u0438\u043A\u0430, \u043A\u043E\u0442\u043E\u0440\u044B\u0439 \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442\n\u044D\u0442\u0438 \u043C\u0435\u0442\u043E\u0434\u044B \u0447\u0435\u0440\u0435\u0437 \u043C\u043E\u0441\u0442 (`bitrix_call` / \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B) \u0438\u043B\u0438 \u0440\u0430\u0441\u0448\u0438\u0440\u044F\u0435\u0442 \u043A\u0430\u0442\u0430\u043B\u043E\u0433.\n\n\u041D\u0430\u0431\u043B\u044E\u0434\u0435\u043D\u0438\u044F \u0441\u043D\u044F\u0442\u044B \u043D\u0430 \u043F\u043E\u0440\u0442\u0430\u043B\u0435 `example.bitrix24.ru` (\u043E\u0431\u043B\u0430\u043A\u043E, \u043C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 **im.v2**, \u0437\u0430\u0434\u0430\u0447\u0438 \u0432 \u0440\u0435\u0436\u0438\u043C\u0435\n**scrum-\u0431\u043E\u0440\u0434\u0430**). \u0418\u043C\u0435\u043D\u0430 \u043F\u043E\u043B\u0435\u0439 \u0438 \u043A\u043E\u043D\u0432\u0435\u043D\u0446\u0438\u0438 \u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442\u043D\u044B \u0434\u043B\u044F \u043E\u0431\u043B\u0430\u0447\u043D\u043E\u0433\u043E Bitrix24, \u043D\u043E \u043F\u0440\u0438 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0435 \u043D\u0430 \u0434\u0440\u0443\u0433\u043E\u0439\n\u043F\u043E\u0440\u0442\u0430\u043B \u0441\u0432\u0435\u0440\u044F\u0439\u0441\u044F \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C (`docs/reconnaissance.md`).\n\n---\n\n## 1. \u041A\u0430\u043A \u0432\u044B\u0437\u044B\u0432\u0430\u0442\u044C\n\n- **\u0422\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B** (`bitrix_tasks_list`, `bitrix_task_get`, `bitrix_projects_list`,\n  `bitrix_project_get`, `bitrix_chats_recent`, `bitrix_chat_messages`) \u2014 \u0441 \u0440\u0430\u0437\u0443\u043C\u043D\u044B\u043C\u0438 \u0434\u0435\u0444\u043E\u043B\u0442\u0430\u043C\u0438.\n  \u0422\u043E\u0447\u043D\u0430\u044F \u0432\u044B\u0431\u043E\u0440\u043A\u0430 \u2014 \u0447\u0435\u0440\u0435\u0437 \u043E\u043F\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u044B\u0439 \u0430\u0440\u0433\u0443\u043C\u0435\u043D\u0442 **`params`** (\u043D\u0430\u0442\u0438\u0432\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 Bitrix), \u043E\u043D \u043C\u0435\u0440\u0436\u0438\u0442\u0441\u044F\n  **\u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u043C** \u0438 \u043F\u0435\u0440\u0435\u043A\u0440\u044B\u0432\u0430\u0435\u0442 \u0434\u0435\u0444\u043E\u043B\u0442\u044B. \u041F\u043E\u0434\u0441\u043A\u0430\u0437\u043A\u0438 \u043F\u043E \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u0430\u043C \u0435\u0441\u0442\u044C \u0432 \u043E\u043F\u0438\u0441\u0430\u043D\u0438\u0438 \u043A\u0430\u0436\u0434\u043E\u0433\u043E \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u0430.\n- **`bitrix_call { name, params }`** \u2014 \u0443\u043D\u0438\u0432\u0435\u0440\u0441\u0430\u043B\u044C\u043D\u044B\u0439 \u0432\u044B\u0437\u043E\u0432 \u043B\u044E\u0431\u043E\u0433\u043E \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u043E\u0433\u043E \u0438\u043C\u0435\u043D\u0438 \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430\n  (`actions.json`). \u0422\u043E\u0442 \u0436\u0435 `params`-\u043C\u0435\u0445\u0430\u043D\u0438\u0437\u043C.\n- **`bitrix_help`** \u2014 \u044D\u0442\u043E\u0442 \u0436\u0435 \u0433\u0430\u0439\u0434, \u043E\u0442\u0434\u0430\u0451\u0442\u0441\u044F \u0447\u0435\u0440\u0435\u0437 MCP (\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 + resource `bitrix://api-notes`),\n  \u0447\u0442\u043E\u0431\u044B \u043B\u044E\u0431\u043E\u0439 \u0430\u0433\u0435\u043D\u0442 \u0440\u0430\u0437\u043E\u0431\u0440\u0430\u043B\u0441\u044F \u0431\u0435\u0437 \u0434\u043E\u0441\u0442\u0443\u043F\u0430 \u043A \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u044E. \u0418\u0441\u0442\u043E\u0447\u043D\u0438\u043A \u2014 **\u044D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B** (`docs/api-notes.md`).\n- \u0412\u0441\u0451 **read-only**: \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0435 \u0432\u044B\u0437\u043E\u0432\u044B (`\u2026add/update/delete/set/complete/\u2026`) \u043E\u0442\u0432\u0435\u0440\u0433\u0430\u044E\u0442\u0441\u044F \u043F\u0440\u0438 \u0437\u0430\u0433\u0440\u0443\u0437\u043A\u0435 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430.\n\n---\n\n## 2. \u0424\u043E\u0440\u043C\u0430\u0442 \u043E\u0442\u0432\u0435\u0442\u0430 (\u0432\u0430\u0436\u043D\u043E!)\n\nAjax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u044B (`/bitrix/services/main/ajax.php`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 HTTP 200 \u0441 \u043A\u043E\u043D\u0432\u0435\u0440\u0442\u043E\u043C:\n\n```jsonc\n{ "status": "success" | "error",\n  "data": { ... },\n  "errors": [] }          // \u041F\u0423\u0421\u0422\u041E\u0419 \u043C\u0430\u0441\u0441\u0438\u0432 \u043F\u0440\u0438 \u0443\u0441\u043F\u0435\u0445\u0435! (\u0432 JS [] \u2014 truthy)\n```\n\n- \u0423\u0441\u043F\u0435\u0445 \u043E\u043F\u0440\u0435\u0434\u0435\u043B\u044F\u0435\u0442\u0441\u044F `status:"success"` \u0438/\u0438\u043B\u0438 **\u043F\u0443\u0441\u0442\u044B\u043C** `errors`. \u041D\u0435\u043F\u0443\u0441\u0442\u043E\u0439 `errors` / `status:"error"` /\n  top-level `error` \u2014 \u0440\u0435\u0430\u043B\u044C\u043D\u0430\u044F \u043E\u0448\u0438\u0431\u043A\u0430.\n- REST-\u044D\u043D\u0434\u043F\u043E\u0438\u043D\u0442\u044B (`/rest/*.json`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 \u0438\u043D\u0430\u0447\u0435: `{ "result": \u2026, "next", "total", "time" }` \u2014 \u0431\u0435\u0437 `errors`.\n\n---\n\n## 3. \u0422\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 \u0438 \u043A\u043E\u043D\u0432\u0435\u043D\u0446\u0438\u0438 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432 (\u0440\u0430\u0437\u043B\u0438\u0447\u0430\u044E\u0442\u0441\u044F \u043F\u043E \u043C\u0435\u0442\u043E\u0434\u0443!)\n\n\u041C\u043E\u0441\u0442 \u0448\u043B\u0451\u0442 `application/x-www-form-urlencoded` \u0441\u043E **\u0441\u0432\u0435\u0436\u0438\u043C `sessid`** \u0432 \u0442\u0435\u043B\u0435; \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u043E\u0441\u0442\u044C \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\u0441\u044F\nPHP-\u0441\u0442\u0438\u043B\u0435\u043C (`filter[STATUS]=2`, `select[0]=ID`). \u041E\u0431\u044A\u0435\u043A\u0442 \u0432 `params` \u0440\u0435\u043A\u0443\u0440\u0441\u0438\u0432\u043D\u043E \u0440\u0430\u0437\u0432\u043E\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044F \u0432 \u0442\u0430\u043A\u0438\u0435 \u043A\u043B\u044E\u0447\u0438.\n\n| \u041C\u0435\u0442\u043E\u0434 (action / endpoint) | \u0422\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 | \u0413\u0434\u0435 `select`/`filter`/`order` | \u041F\u0430\u0433\u0438\u043D\u0430\u0446\u0438\u044F |\n|---|---|---|---|\n| `tasks.task.list` | ajax, \u0444\u043E\u0440\u043C\u0430 | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `filter{}`, `order{}` | `start` (\u0441\u0434\u0432\u0438\u0433, \u0448\u0430\u0433 50) |\n| `tasks.task.get` | ajax, \u0444\u043E\u0440\u043C\u0430 | \u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C: `taskId`, `select[]` | \u2014 |\n| `socialnetwork.api.workgroup.list` | ajax, \u0444\u043E\u0440\u043C\u0430 | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `order{}`, `filter{}` | (nav \u2014 \u043D\u0435 \u043F\u0440\u043E\u0432\u0435\u0440\u0435\u043D\u043E) |\n| `socialnetwork.api.workgroup.get` | ajax, \u0444\u043E\u0440\u043C\u0430 | **\u043E\u0431\u0451\u0440\u043D\u0443\u0442\u043E**: `params[groupId]`, `params[select][]` | \u2014 |\n| `im.v2.Chat.Message.list` | ajax, \u0444\u043E\u0440\u043C\u0430 | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `limit`, `filter[lastId]` | `filter[lastId]` + `limit` |\n| `im.recent.list` (`/rest/im.recent.list.json`) | rest, \u0444\u043E\u0440\u043C\u0430 | \u043F\u043B\u043E\u0441\u043A\u043E: `LIMIT`, `SKIP_OPENLINES`, `UNREAD_ONLY`, \u2026 | `LIMIT` |\n\n\u26A0\uFE0F **`tasks.v2.*` (\u043D\u0430\u043F\u0440. `tasks.v2.Task.get`) \u0448\u043B\u0451\u0442 JSON-\u0442\u0435\u043B\u043E** (`{"task":{"id":N}}`), \u0430 \u043C\u043E\u0441\u0442 \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\n\u0444\u043E\u0440\u043C\u0443 \u2014 **\u043D\u0435 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 `tasks.v2.*`**, \u0431\u0435\u0440\u0438 \u043A\u043B\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043A\u0438\u0435 `tasks.task.*`. \u041C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 `im.v2.*` \u043F\u0440\u0438 \u044D\u0442\u043E\u043C\n\u043F\u0440\u0438\u043D\u0438\u043C\u0430\u0435\u0442 \u043E\u0431\u044B\u0447\u043D\u0443\u044E \u0444\u043E\u0440\u043C\u0443 (\u044D\u0442\u043E \u0440\u0430\u0437\u043D\u044B\u0435 \u043F\u043E\u0434\u0441\u0438\u0441\u0442\u0435\u043C\u044B, \u043D\u0435\u0441\u043C\u043E\u0442\u0440\u044F \u043D\u0430 \u043E\u0431\u0449\u0438\u0439 \u043F\u0440\u0435\u0444\u0438\u043A\u0441 \xABv2\xBB).\n\nCSRF: \u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u044B \u0442\u0440\u0435\u0431\u0443\u044E\u0442 `sessid` \u0432 \u0442\u0435\u043B\u0435 \u2014 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u0438\u0435 \u043F\u043E\u0434\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 \u0441\u0432\u0435\u0436\u0438\u0439 `BX.bitrix_sessid()`\n\u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438. \u041E\u0442\u0432\u0435\u0442 `invalid_csrf`/`invalid_authentication` = \u0441\u0435\u0441\u0441\u0438\u044F \u043F\u0440\u043E\u0442\u0443\u0445\u043B\u0430 (\u043F\u0435\u0440\u0435\u043B\u043E\u0433\u0438\u043D\u044C\u0441\u044F \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435).\n\n---\n\n## 4. \u0422\u0440\u0438\u0430\u0434\u0430: \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u2192 action \u2192 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B\n\n| \u0418\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 | \u041A\u0430\u0442\u0430\u043B\u043E\u0433 (`actions.json`) | action / endpoint | \u041A\u043B\u044E\u0447\u0435\u0432\u044B\u0435 params |\n|---|---|---|---|\n| `bitrix_tasks_list` | `tasks.list` | `tasks.task.list` | `filter{RESPONSIBLE_ID,REAL_STATUS,GROUP_ID,\u2026}`, `select[]`, `order{}`, `start` |\n| `bitrix_task_get` | `task.get` | `tasks.task.get` | `taskId`, `select[]` |\n| `bitrix_projects_list` | `projects.list` | `socialnetwork.api.workgroup.list` | `select[]`, `order{}`, `filter{}` |\n| `bitrix_project_get` | `projects.get` | `socialnetwork.api.workgroup.get` | `params[groupId]`, `params[select][]` |\n| `bitrix_chats_recent` | `chats.recent` | `/rest/im.recent.list.json` | `LIMIT`, `UNREAD_ONLY`, `SKIP_OPENLINES` |\n| `bitrix_chat_messages` | `chat.messages` | `im.v2.Chat.Message.list` | `chatId`, `limit`, `filter[lastId]` |\n\n---\n\n## 5. \u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E\u043B\u0435\u0439\n\n**\u0417\u0430\u0434\u0430\u0447\u0430** (`tasks.task.*`): `ID`, `TITLE`, `DESCRIPTION`, `STATUS`, `REAL_STATUS`, `RESPONSIBLE_ID`,\n`CREATED_BY`, `CREATED_DATE`, `CHANGED_DATE`, `DEADLINE`, `CLOSED_DATE`, `PRIORITY`, `GROUP_ID`,\n`TAGS`, `TIME_ESTIMATE`, `UF_*`. \u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u0430\u0434\u044B\u0432\u0430\u0435\u0442 \u043E\u0431\u044A\u0435\u043A\u0442\u044B `group`, `responsible`, `creator`, `action`.\n\n\u0421\u0442\u0430\u0442\u0443\u0441\u044B \u0437\u0430\u0434\u0430\u0447\u0438 (`STATUS`): `1` \u041D\u043E\u0432\u0430\u044F \xB7 `2` \u0416\u0434\u0451\u0442 \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \xB7 `3` \u0412\u044B\u043F\u043E\u043B\u043D\u044F\u0435\u0442\u0441\u044F \xB7 `4` \u0416\u0434\u0451\u0442 \u043A\u043E\u043D\u0442\u0440\u043E\u043B\u044F \xB7\n`5` \u0417\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0430 \xB7 `6` \u041E\u0442\u043B\u043E\u0436\u0435\u043D\u0430 \xB7 `7` \u041E\u0442\u043A\u043B\u043E\u043D\u0435\u043D\u0430.\n\n**\u0413\u0440\u0443\u043F\u043F\u0430/\u043F\u0440\u043E\u0435\u043A\u0442 \u2014 \u0441\u043F\u0438\u0441\u043E\u043A** (`workgroup.list`, camelCase \u0432 \u043E\u0442\u0432\u0435\u0442\u0435): `ID`, `NAME`, `DESCRIPTION`,\n`NUMBER_OF_MEMBERS`, `OWNER_ID`, `DATE_CREATE`, `PROJECT` (Y/N), `TYPE`.\n**\u0413\u0440\u0443\u043F\u043F\u0430 \u2014 \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430** (`workgroup.get`): \u043F\u043B\u044E\u0441 `OWNER_DATA`, `SUBJECT_DATA`, `MEMBERS[]`,\n`MODERATOR_MEMBERS[]`, `CHAT_ID`, `DIALOG_ID`, `IMAGE_ID`, UF-\u043F\u043E\u043B\u044F.\n\n**\u041D\u0435\u0434\u0430\u0432\u043D\u0438\u0439 \u0447\u0430\u0442** (`im.recent.list`): `chat_id`, `title`, `type`, `message{id,text,date,author_id}`,\n`last_id`, `unread`, `pinned`, `user{\u2026}`, `chat{\u2026}`.\n**\u0421\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0435** (`im.v2.Chat.Message.list`): `id`, `chatId`, `authorId`, `date`, `text`, `params`, `viewed`.\n\u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043D\u0435\u0441\u0451\u0442 `users[]` (\u0443\u0447\u0430\u0441\u0442\u043D\u0438\u043A\u0438), `additionalMessages[]`, `hasPrevPage`/`hasNextPage`.\n\n---\n\n## 6. \u041F\u0440\u0438\u043C\u0435\u0440\u044B \u0442\u043E\u0447\u043D\u044B\u0445 \u0432\u044B\u0431\u043E\u0440\u043E\u043A\n\n```jsonc\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044B\u0435 \u0437\u0430\u0434\u0430\u0447\u0438 \u043E\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043D\u043D\u043E\u0433\u043E 55, \u043F\u043E \u0434\u0435\u0434\u043B\u0430\u0439\u043D\u0443, \u0432\u0442\u043E\u0440\u0430\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430\nbitrix_tasks_list { "params": { "filter": {"RESPONSIBLE_ID":55,"REAL_STATUS":2},\n                                "order": {"DEADLINE":"asc"}, "start": 50 } }\n\n// \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0437\u0430\u0434\u0430\u0447\u0438 \u0441 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u043D\u044B\u043C \u043D\u0430\u0431\u043E\u0440\u043E\u043C \u043F\u043E\u043B\u0435\u0439\nbitrix_task_get { "taskId": 4229, "params": { "select": ["ID","TITLE","DESCRIPTION","TAGS","TIME_ESTIMATE"] } }\n\n// \u043F\u0440\u043E\u0435\u043A\u0442\u044B, \u043E\u0442\u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u043F\u043E \u0434\u0430\u0442\u0435 \u0441\u043E\u0437\u0434\u0430\u043D\u0438\u044F\nbitrix_projects_list { "params": { "order": {"DATE_CREATE":"desc"} } }\n\n// \u043F\u043E\u043B\u043D\u0430\u044F \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0433\u0440\u0443\u043F\u043F\u044B\nbitrix_project_get { "groupId": 15 }\n\n// \u0433\u043B\u0443\u0431\u0436\u0435 \u0432 \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u0447\u0430\u0442\u0430\nbitrix_chat_messages { "chatId": 485, "limit": 50, "beforeId": 1936695 }\n```\n\n---\n\n## 7. \u041A\u0430\u043A \u0440\u0430\u0441\u0448\u0438\u0440\u0438\u0442\u044C (\u043D\u043E\u0432\u044B\u0439 \u0434\u043E\u043C\u0435\u043D: \u043A\u0430\u043B\u0435\u043D\u0434\u0430\u0440\u044C, \u0434\u0438\u0441\u043A, CRM, \u2026)\n\n1. \u0421\u043D\u0438\u043C\u0438 \u0440\u0435\u0430\u043B\u044C\u043D\u044B\u0435 \u0432\u044B\u0437\u043E\u0432\u044B (`docs/reconnaissance.md` \u2014 \u0430\u0432\u0442\u043E-\u0437\u0430\u043F\u0438\u0441\u044C `bun run capture` \u0438\u043B\u0438 HAR).\n2. \u041E\u043F\u0440\u0435\u0434\u0435\u043B\u0438 \u0442\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 \u0438 \u0444\u043E\u0440\u043C\u0443 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432 \u043F\u043E \u0440\u0430\u0437\u0434\u0435\u043B\u0443 3 (\u0441\u0432\u0435\u0440\u044C\u0441\u044F \u0441 `sampleParams` \u0438\u0437 \u0447\u0435\u0440\u043D\u043E\u0432\u0438\u043A\u0430).\n3. \u0414\u043E\u0431\u0430\u0432\u044C \u0437\u0430\u043F\u0438\u0441\u044C \u0432 `actions.json` (\u0442\u043E\u043B\u044C\u043A\u043E read-only). \u041F\u0440\u043E\u0432\u0435\u0440\u044C \u0447\u0435\u0440\u0435\u0437 `bitrix_call { name, params }`.\n4. \u0415\u0441\u043B\u0438 \u0443\u0434\u043E\u0431\u043D\u043E \u2014 \u043E\u0431\u0435\u0440\u043D\u0438 \u0432 \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0439 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u0432 `src/tools/register.ts` (\u0441 \u0434\u0435\u0444\u043E\u043B\u0442\u043D\u044B\u043C `select`).\n\n> `actions.json` \u2014 \u0434\u0430\u043D\u043D\u044B\u0435 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u0433\u043E \u043F\u043E\u0440\u0442\u0430\u043B\u0430 (gitignored). \u042D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B (`api-notes.md`) \u2014 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0438\u043C\u044B\u0435\n> \u0437\u043D\u0430\u043D\u0438\u044F \u043E \u0441\u0430\u043C\u043E\u043C API; \u0434\u0435\u0440\u0436\u0438 \u0435\u0433\u043E \u0432 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u043E\u043C \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0438 \u043F\u0440\u0438 \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u0438 \u043D\u043E\u0432\u044B\u0445 \u043C\u0435\u0442\u043E\u0434\u043E\u0432.\n' : load();
+var HELP = '# Bitrix24 API notes (reverse-engineered)\n\n\u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0435\u043C\u0443 API Bitrix24, \u0434\u043E\u0431\u044B\u0442\u044B\u0439 **\u0436\u0438\u0432\u044B\u043C \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C** (\u0443 \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0438\u0445 ajax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u043E\u0432\n\u043D\u0435\u0442 \u043F\u0443\u0431\u043B\u0438\u0447\u043D\u043E\u0439 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u0438). \u041F\u0440\u0435\u0434\u043D\u0430\u0437\u043D\u0430\u0447\u0435\u043D \u0434\u043B\u044F \u043B\u044E\u0431\u043E\u0433\u043E \u0418\u0418-\u0430\u0433\u0435\u043D\u0442\u0430 \u0438\u043B\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043E\u0442\u0447\u0438\u043A\u0430, \u043A\u043E\u0442\u043E\u0440\u044B\u0439 \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442\n\u044D\u0442\u0438 \u043C\u0435\u0442\u043E\u0434\u044B \u0447\u0435\u0440\u0435\u0437 \u043C\u043E\u0441\u0442 (`bitrix_call` / \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B) \u0438\u043B\u0438 \u0440\u0430\u0441\u0448\u0438\u0440\u044F\u0435\u0442 \u043A\u0430\u0442\u0430\u043B\u043E\u0433.\n\n\u041D\u0430\u0431\u043B\u044E\u0434\u0435\u043D\u0438\u044F \u0441\u043D\u044F\u0442\u044B \u043D\u0430 \u043F\u043E\u0440\u0442\u0430\u043B\u0435 `example.bitrix24.ru` (\u043E\u0431\u043B\u0430\u043A\u043E, \u043C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 **im.v2**, \u0437\u0430\u0434\u0430\u0447\u0438 \u0432 \u0440\u0435\u0436\u0438\u043C\u0435\n**scrum-\u0431\u043E\u0440\u0434\u0430**). \u0418\u043C\u0435\u043D\u0430 \u043F\u043E\u043B\u0435\u0439 \u0438 \u043A\u043E\u043D\u0432\u0435\u043D\u0446\u0438\u0438 \u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442\u043D\u044B \u0434\u043B\u044F \u043E\u0431\u043B\u0430\u0447\u043D\u043E\u0433\u043E Bitrix24, \u043D\u043E \u043F\u0440\u0438 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0435 \u043D\u0430 \u0434\u0440\u0443\u0433\u043E\u0439\n\u043F\u043E\u0440\u0442\u0430\u043B \u0441\u0432\u0435\u0440\u044F\u0439\u0441\u044F \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C (`docs/reconnaissance.md`).\n\n---\n\n## 1. \u041A\u0430\u043A \u0432\u044B\u0437\u044B\u0432\u0430\u0442\u044C\n\n- **`bitrix_call { name, params }`** \u2014 \u0443\u043D\u0438\u0432\u0435\u0440\u0441\u0430\u043B\u044C\u043D\u044B\u0439 \u0432\u044B\u0437\u043E\u0432 \u043B\u044E\u0431\u043E\u0433\u043E \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u043E\u0433\u043E \u0438\u043C\u0435\u043D\u0438 \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430\n  (`actions.json`). `params` \u2014 \u043D\u0430\u0442\u0438\u0432\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 Bitrix (\u0441\u043C. \u0440\u0430\u0437\u0434\u0435\u043B 3). \u041A\u0430\u0442\u0430\u043B\u043E\u0433 \u043C\u043E\u0436\u0435\u0442 \u0432\u043A\u043B\u044E\u0447\u0430\u0442\u044C\n  \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0435 \u0432\u044B\u0437\u043E\u0432\u044B; allowlist (`actions.json`) \u2014 \u0435\u0434\u0438\u043D\u0441\u0442\u0432\u0435\u043D\u043D\u0430\u044F \u0433\u0440\u0430\u043D\u0438\u0446\u0430, \u043D\u0435 \u0440\u0435\u0436\u0438\u043C \u0447\u0442\u0435\u043D\u0438\u044F.\n- **\u0422\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B** \u2014 \u043E\u0431\u0451\u0440\u0442\u043A\u0438 \u0441 \u0440\u0430\u0437\u0443\u043C\u043D\u044B\u043C\u0438 \u0434\u0435\u0444\u043E\u043B\u0442\u0430\u043C\u0438 \u043D\u0430\u0434 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u043E\u043C. \u0422\u043E\u0447\u043D\u0430\u044F \u0432\u044B\u0431\u043E\u0440\u043A\u0430 \u2014 \u0447\u0435\u0440\u0435\u0437\n  \u043E\u043F\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u044B\u0439 `params`, \u043E\u043D \u043C\u0435\u0440\u0436\u0438\u0442\u0441\u044F **\u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u043C** \u0438 \u043F\u0435\u0440\u0435\u043A\u0440\u044B\u0432\u0430\u0435\u0442 \u0434\u0435\u0444\u043E\u043B\u0442\u044B. \u0420\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u044E\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E \u0442\u0435,\n  \u0447\u044C\u0451 \u0438\u043C\u044F \u0435\u0441\u0442\u044C \u0432 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0435 (`actions.json`); \u0438\u043D\u0430\u0447\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u043F\u0440\u043E\u043F\u0443\u0441\u043A\u0430\u0435\u0442\u0441\u044F. \u0422\u0435\u043A\u0443\u0449\u0438\u0439 \u043D\u0430\u0431\u043E\u0440:\n  - \u0417\u0430\u0434\u0430\u0447\u0438: `bitrix_tasks_list`, `bitrix_task_get`, `bitrix_task_get_v2` (v2/JSON),\n    `bitrix_task_scrum_info`, `bitrix_task_files`, `bitrix_task_views_count`,\n    `bitrix_task_subtasks` (\u043F\u043E\u0434\u0437\u0430\u0434\u0430\u0447\u0438), `bitrix_task_related` (\u0441\u0432\u044F\u0437\u0430\u043D\u043D\u044B\u0435).\n  - \u041F\u0440\u043E\u0435\u043A\u0442\u044B: `bitrix_projects_list`, `bitrix_project_get`.\n  - \u0427\u0430\u0442\u044B: `bitrix_chats_recent`, `bitrix_recent_load` (\u043D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u043F\u043E \u0441\u0435\u043A\u0446\u0438\u0438 \u2014 \u0432 \u0442.\u0447. `tasksTask` =\n    \u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447), `bitrix_recent_tail` (\u043B\u0438\u0441\u0442\u0430\u0442\u044C \u043D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u0432\u0433\u043B\u0443\u0431\u044C), `bitrix_chat_load` (\u043E\u0442\u043A\u0440\u044B\u0442\u044C \u043F\u043E\n    `dialogId`/`chatId`), `bitrix_chat_messages`, `bitrix_chat_history` (\u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0432\u0433\u043B\u0443\u0431\u044C \u043F\u043E `beforeId`),\n    `bitrix_chat_get_dialog_id` (dialogId \u043F\u043E externalId), `bitrix_chat_mark_read` (\u26A0 \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439),\n    `bitrix_chat_read_all` (\u26A0 \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439).\n  - \u041B\u044E\u0434\u0438/\u043F\u043E\u0438\u0441\u043A: `bitrix_user_get` (\u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u044E\u0437\u0435\u0440\u0430), `bitrix_entity_selector` (\u0437\u0430\u0433\u0440\u0443\u0437\u043A\u0430 \u0441\u0435\u043B\u0435\u043A\u0442\u043E\u0440\u0430),\n    `bitrix_entity_search` (\u0442\u0435\u043A\u0441\u0442\u043E\u0432\u044B\u0439 \u043F\u043E\u0438\u0441\u043A \u0447\u0430\u0442\u043E\u0432/\u0441\u0443\u0449\u043D\u043E\u0441\u0442\u0435\u0439 \u0447\u0435\u0440\u0435\u0437 `ui.entityselector.doSearch`).\n\n  \u041B\u044E\u0431\u043E\u0435 \u0438\u043C\u044F \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0432\u0441\u0435\u0433\u0434\u0430 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u043E \u0438 \u043D\u0430\u043F\u0440\u044F\u043C\u0443\u044E \u0447\u0435\u0440\u0435\u0437 `bitrix_call { name, params }`.\n- **`bitrix_help`** \u2014 \u044D\u0442\u043E\u0442 \u0436\u0435 \u0433\u0430\u0439\u0434, \u043E\u0442\u0434\u0430\u0451\u0442\u0441\u044F \u0447\u0435\u0440\u0435\u0437 MCP (\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 + resource `bitrix://api-notes`).\n  \u0418\u0441\u0442\u043E\u0447\u043D\u0438\u043A \u2014 **\u044D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B** (`docs/api-notes.md`).\n\n\u041F\u043E\u043B\u043D\u044B\u0439 \u0441\u043F\u0438\u0441\u043E\u043A \u0438\u043C\u0451\u043D \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u043E\u0442\u0434\u0430\u0451\u0442 `bitrix_call` \u0432 \u0441\u0432\u043E\u0451\u043C \u043E\u043F\u0438\u0441\u0430\u043D\u0438\u0438 (`deps.catalog.names()`).\n\n---\n\n## 2. \u0424\u043E\u0440\u043C\u0430\u0442 \u043E\u0442\u0432\u0435\u0442\u0430 (\u0432\u0430\u0436\u043D\u043E!)\n\nAjax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u044B (`/bitrix/services/main/ajax.php`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 HTTP 200 \u0441 \u043A\u043E\u043D\u0432\u0435\u0440\u0442\u043E\u043C:\n\n```jsonc\n{ "status": "success" | "error",\n  "data": { ... },\n  "errors": [] }          // \u041F\u0423\u0421\u0422\u041E\u0419 \u043C\u0430\u0441\u0441\u0438\u0432 \u043F\u0440\u0438 \u0443\u0441\u043F\u0435\u0445\u0435! (\u0432 JS [] \u2014 truthy)\n```\n\n- \u0423\u0441\u043F\u0435\u0445 \u043E\u043F\u0440\u0435\u0434\u0435\u043B\u044F\u0435\u0442\u0441\u044F `status:"success"` \u0438/\u0438\u043B\u0438 **\u043F\u0443\u0441\u0442\u044B\u043C** `errors`. \u041D\u0435\u043F\u0443\u0441\u0442\u043E\u0439 `errors` / `status:"error"` /\n  top-level `error` \u2014 \u0440\u0435\u0430\u043B\u044C\u043D\u0430\u044F \u043E\u0448\u0438\u0431\u043A\u0430 (\u043C\u043E\u0441\u0442 \u043C\u0430\u043F\u043F\u0438\u0442 \u044D\u0442\u043E \u0432 `ok:false`).\n- REST-\u044D\u043D\u0434\u043F\u043E\u0438\u043D\u0442\u044B (`/rest/*.json`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 \u0438\u043D\u0430\u0447\u0435: `{ "result": \u2026, "next", "total", "time" }` \u2014 \u0431\u0435\u0437 `errors`.\n\n---\n\n## 3. \u0422\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442: form vs json (\u0440\u0430\u0437\u043B\u0438\u0447\u0430\u0435\u0442\u0441\u044F \u043F\u043E \u043C\u0435\u0442\u043E\u0434\u0443!)\n\n\u0423 \u043A\u0430\u0436\u0434\u043E\u0439 \u0437\u0430\u043F\u0438\u0441\u0438 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0435\u0441\u0442\u044C **`bodyType`** \u2014 \u043A\u0430\u043A \u043C\u043E\u0441\u0442 \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442 \u0442\u0435\u043B\u043E:\n\n- **`bodyType: "form"`** (\u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E) \u2014 `application/x-www-form-urlencoded`; \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u043E\u0441\u0442\u044C \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\u0441\u044F\n  PHP-\u0441\u0442\u0438\u043B\u0435\u043C (`filter[STATUS]=2`, `select[0]=ID`). \u041E\u0431\u044A\u0435\u043A\u0442 \u0432 `params` \u0440\u0435\u043A\u0443\u0440\u0441\u0438\u0432\u043D\u043E \u0440\u0430\u0437\u0432\u043E\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044F \u0432 \u0442\u0430\u043A\u0438\u0435\n  \u043A\u043B\u044E\u0447\u0438. \u041A\u043B\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043A\u0438\u0435 `tasks.task.*`, \u043C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 `im.v2.*`, REST \u2014 \u0432\u0441\u0451 \u044D\u0442\u043E \u0444\u043E\u0440\u043C\u0430.\n- **`bodyType: "json"`** \u2014 \u0442\u0435\u043B\u043E \u0443\u0445\u043E\u0434\u0438\u0442 \u043A\u0430\u043A `JSON.stringify(params)` \u0441 `Content-Type: application/json`.\n  \u0422\u0430\u043A \u0440\u0430\u0431\u043E\u0442\u0430\u044E\u0442 **`tasks.v2.*`** (\u043D\u0430\u043F\u0440. `tasks.v2.Task.get` \u0436\u0434\u0451\u0442 `{"task":{"id":N}}`) \u0438 `ui.entityselector.*`.\n  `params` \u043F\u0440\u0438 \u044D\u0442\u043E\u043C \u0441\u043E\u0445\u0440\u0430\u043D\u044F\u0435\u0442 \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u0443\u044E \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0443 \u043A\u0430\u043A \u0435\u0441\u0442\u044C (\u043D\u0435 \u0440\u0430\u0437\u0432\u043E\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044F \u0432 bracket-\u043A\u043B\u044E\u0447\u0438).\n\n> \u0418\u0441\u0442\u043E\u0440\u0438\u0447\u0435\u0441\u043A\u0430\u044F \u0437\u0430\u043C\u0435\u0442\u043A\u0430: \u0440\u0430\u043D\u044C\u0448\u0435 \u043C\u043E\u0441\u0442 \u0443\u043C\u0435\u043B \u0442\u043E\u043B\u044C\u043A\u043E \u0444\u043E\u0440\u043C\u0443, \u0438 `tasks.v2.*` \u0431\u044B\u043B\u0438 \u043D\u0435\u043F\u0440\u0438\u0433\u043E\u0434\u043D\u044B. \u0422\u0435\u043F\u0435\u0440\u044C\n> \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0430\u043D\u044B \u2014 \u0432 \u0437\u0430\u043F\u0438\u0441\u0438 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0441\u0442\u0430\u0432\u044C `"bodyType": "json"`, \u0438 \u043C\u043E\u0441\u0442 \u043E\u0442\u043F\u0440\u0430\u0432\u0438\u0442 \u0438\u0445 \u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E.\n\n**CSRF / sessid:** \u043C\u043E\u0441\u0442 \u0432\u0441\u0435\u0433\u0434\u0430 \u0448\u043B\u0451\u0442 \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043E\u043A **`X-Bitrix-Csrf-Token: <sessid>`** (\u0441\u0432\u0435\u0436\u0438\u0439\n`BX.bitrix_sessid()`). Form-\u0442\u0435\u043B\u0430 \u0434\u043E\u043F\u043E\u043B\u043D\u0438\u0442\u0435\u043B\u044C\u043D\u043E \u043D\u0435\u0441\u0443\u0442 `sessid` \u043F\u043E\u043B\u0435\u043C \u0432 \u0442\u0435\u043B\u0435 (legacy REST \u044D\u0442\u043E \u0442\u0440\u0435\u0431\u0443\u0435\u0442);\nJSON-\u0442\u0435\u043B\u0430 \u043D\u0435\u0441\u0443\u0442 sessid **\u0442\u043E\u043B\u044C\u043A\u043E** \u0432 \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043A\u0435. \u041E\u0442\u0432\u0435\u0442 `invalid_csrf`/`invalid_authentication` = \u0441\u0435\u0441\u0441\u0438\u044F\n\u043F\u0440\u043E\u0442\u0443\u0445\u043B\u0430 (\u043F\u0435\u0440\u0435\u043B\u043E\u0433\u0438\u043D\u044C\u0441\u044F \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435).\n\n| \u041C\u0435\u0442\u043E\u0434 (action / endpoint) | bodyType | \u0413\u0434\u0435 `select`/`filter`/`order` | \u041F\u0430\u0433\u0438\u043D\u0430\u0446\u0438\u044F |\n|---|---|---|---|\n| `tasks.task.list` | form | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `filter{}`, `order{}` | `start` (\u0441\u0434\u0432\u0438\u0433, \u0448\u0430\u0433 50) |\n| `tasks.task.get` | form | \u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C: `taskId`, `select[]` | \u2014 |\n| `tasks.v2.Task.get` | **json** | `{"task": {"id": N}}` | \u2014 |\n| `tasks.v2.Scrum.getTaskInfo` | **json** | `{"taskId": N}` | \u2014 |\n| `tasks.v2.File.listObjects` | **json** | `{"ids": [N,\u2026]}` | \u2014 |\n| `tasks.v2.Task.View.User.count` | **json** | `{"task": {"id": N}}` | \u2014 |\n| `tasks.v2.Task.Relation.Child.list` | **json** | `{"taskId": N, "withIds":true, "navigation":{"size":N}}` | `navigation` |\n| `tasks.v2.Task.Relation.Related.list` | **json** | `{"taskId": N, \u2026}` (\u043A\u0430\u043A Child) | `navigation` |\n| `socialnetwork.api.workgroup.list` | form | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `order{}`, `filter{}` | (nav \u2014 \u043D\u0435 \u043F\u0440\u043E\u0432\u0435\u0440\u0435\u043D\u043E) |\n| `socialnetwork.api.workgroup.get` | form | **\u043E\u0431\u0451\u0440\u043D\u0443\u0442\u043E**: `params[groupId]`, `params[select][]` | \u2014 |\n| `/rest/im.recent.list.json` | form (rest) | \u043F\u043B\u043E\u0441\u043A\u043E: `LIMIT`, `SKIP_OPENLINES`, `UNREAD_ONLY`, \u2026 | `LIMIT` |\n| `/rest/im.user.get.json` | form (rest) | \u043F\u043B\u043E\u0441\u043A\u043E: `ID` | \u2014 |\n| `im.v2.Recent.load` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `limit`, `filter[recentSection]`, `filter[unread]`, `filter[parentId]` | `im.v2.Recent.tail` |\n| `im.v2.Recent.tail` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `limit`, `filter[lastMessageDate]` (\u043A\u0443\u0440\u0441\u043E\u0440), `filter[recentSection]` | `filter[lastMessageDate]` |\n| `im.v2.Chat.load` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `dialogId`\\|`chatId`, `messageLimit` | \u2014 |\n| `im.v2.Chat.getDialogId` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `externalId` | \u2014 |\n| `im.v2.Chat.Message.list` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `limit` | \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u044F\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430 \u2014 \u043D\u0430\u0437\u0430\u0434 **\u043D\u0435 \u043B\u0438\u0441\u0442\u0430\u0435\u0442**, \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 `.tail` |\n| `im.v2.Chat.Message.tail` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `limit`, `filter[lastId]`, `order[id]` | **\u0441\u043C. \u0440\u0430\u0437\u0434\u0435\u043B 6** |\n| `im.v2.Chat.Message.read` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `ids[]`, `actionUuid` | \u2014 (\u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439) |\n| `im.v2.Chat.readAll` | form | \u0431\u0435\u0437 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432 | \u2014 (\u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439) |\n| `ui.entityselector.load` | **json** | `{"dialog": {entities,preselectedItems,\u2026}}` | \u2014 |\n| `ui.entityselector.doSearch` | **json** | `{"dialog": {\u2026}, "searchQuery": {"query": "...", "queryWords": ["..."]}}` | \u2014 |\n\n---\n\n## 4. \u041A\u0430\u0442\u0430\u043B\u043E\u0433: \u0438\u043C\u044F \u2192 action \u2192 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B\n\n| \u0418\u043C\u044F (`actions.json`) | action / endpoint | bodyType | \u041A\u043B\u044E\u0447\u0435\u0432\u044B\u0435 params |\n|---|---|---|---|\n| `tasks.list` | `tasks.task.list` | form | `filter{RESPONSIBLE_ID,REAL_STATUS,GROUP_ID,\u2026}`, `select[]`, `order{}`, `start` |\n| `task.get` | `tasks.task.get` | form | `taskId`, `select[]` |\n| `task.v2.get` | `tasks.v2.Task.get` | json | `task.id` (id \u0437\u0430\u0434\u0430\u0447\u0438) |\n| `task.scrum.info` | `tasks.v2.Scrum.getTaskInfo` | json | `taskId` |\n| `task.files` | `tasks.v2.File.listObjects` | json | `ids` (\u043C\u0430\u0441\u0441\u0438\u0432 id) |\n| `task.views.count` | `tasks.v2.Task.View.User.count` | json | `task.id` (id \u0437\u0430\u0434\u0430\u0447\u0438) |\n| `task.subtasks` | `tasks.v2.Task.Relation.Child.list` | json | `taskId`, `navigation{size}` |\n| `task.related` | `tasks.v2.Task.Relation.Related.list` | json | `taskId`, `navigation{size}` |\n| `projects.list` | `socialnetwork.api.workgroup.list` | form | `select[]`, `order{}`, `filter{}` |\n| `projects.get` | `socialnetwork.api.workgroup.get` | form | `params[groupId]`, `params[select][]` |\n| `chats.recent` | `/rest/im.recent.list.json` | form | `LIMIT`, `UNREAD_ONLY`, `SKIP_OPENLINES` |\n| `recent.load` | `im.v2.Recent.load` | form | `filter[recentSection]` (`tasksTask`/`collab`/\u2026), `limit`, `filter[unread]` |\n| `recent.tail` | `im.v2.Recent.tail` | form | `filter[lastMessageDate]`, `filter[recentSection]`, `limit` |\n| `chat.load` | `im.v2.Chat.load` | form | `dialogId`\\|`chatId`, `messageLimit` |\n| `chat.dialogId` | `im.v2.Chat.getDialogId` | form | `externalId` (\u043D\u0430\u043F\u0440. `"sg"+groupId`) |\n| `chat.messages` | `im.v2.Chat.Message.list` | form | `chatId`, `limit` (\u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u0435; \u0432\u0433\u043B\u0443\u0431\u044C \u2014 `chat.messages.tail`) |\n| `chat.messages.tail` | `im.v2.Chat.Message.tail` | form | `chatId`, `filter[lastId]`, `order[id]`, `limit` |\n| `chat.message.read` | `im.v2.Chat.Message.read` | form | `chatId`, `ids[0]`, `actionUuid` |\n| `chat.read.all` | `im.v2.Chat.readAll` | form | \u2014 (\u26A0 \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439) |\n| `im.user.get` | `/rest/im.user.get.json` | form | `ID` |\n| `entityselector.load` | `ui.entityselector.load` | json | `dialog` (\u043E\u0431\u044A\u0435\u043A\u0442) |\n| `entityselector.search` | `ui.entityselector.doSearch` | json | `dialog`, `searchQuery{query,queryWords}` |\n\n---\n\n## 5. \u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E\u043B\u0435\u0439\n\n**\u0417\u0430\u0434\u0430\u0447\u0430** (`tasks.task.*`): `ID`, `TITLE`, `DESCRIPTION`, `STATUS`, `REAL_STATUS`, `RESPONSIBLE_ID`,\n`CREATED_BY`, `CREATED_DATE`, `CHANGED_DATE`, `DEADLINE`, `CLOSED_DATE`, `PRIORITY`, `GROUP_ID`,\n`TAGS`, `TIME_ESTIMATE`, `UF_*`. \u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u0430\u0434\u044B\u0432\u0430\u0435\u0442 \u043E\u0431\u044A\u0435\u043A\u0442\u044B `group`, `responsible`, `creator`, `action`.\n\n\u0421\u0442\u0430\u0442\u0443\u0441\u044B \u0437\u0430\u0434\u0430\u0447\u0438 (`STATUS`): `1` \u041D\u043E\u0432\u0430\u044F \xB7 `2` \u0416\u0434\u0451\u0442 \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \xB7 `3` \u0412\u044B\u043F\u043E\u043B\u043D\u044F\u0435\u0442\u0441\u044F \xB7 `4` \u0416\u0434\u0451\u0442 \u043A\u043E\u043D\u0442\u0440\u043E\u043B\u044F \xB7\n`5` \u0417\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0430 \xB7 `6` \u041E\u0442\u043B\u043E\u0436\u0435\u043D\u0430 \xB7 `7` \u041E\u0442\u043A\u043B\u043E\u043D\u0435\u043D\u0430.\n\n**\u0417\u0430\u0434\u0430\u0447\u0430 v2** (`tasks.v2.*`): id \u0437\u0430\u0434\u0430\u0447\u0438 \u043F\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0441\u044F \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u043E \u2014 **`{"task": {"id": N}}`** (\u0443 `Task.get` \u0438\n`Task.View.User.count`), \u0430 \u0443 `Scrum.getTaskInfo` \u0438 `Relation.*` \u2014 \u043F\u043B\u043E\u0441\u043A\u043E `{"taskId": N}`. \u042D\u0442\u043E \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u0430\u044F\n\u043F\u043E\u0434\u0441\u0438\u0441\u0442\u0435\u043C\u0430 scrum-\u0431\u043E\u0440\u0434\u0430; \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0443 \u043E\u0442\u0432\u0435\u0442\u0430 \u0441\u0432\u0435\u0440\u044C \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C \u2014 \u0432 \u0437\u0430\u0445\u0432\u0430\u0442\u0435 \u0432\u0438\u0434\u043D\u044B \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B \u0437\u0430\u043F\u0440\u043E\u0441\u0430.\n\n**\u0413\u0440\u0443\u043F\u043F\u0430/\u043F\u0440\u043E\u0435\u043A\u0442 \u2014 \u0441\u043F\u0438\u0441\u043E\u043A** (`workgroup.list`, camelCase \u0432 \u043E\u0442\u0432\u0435\u0442\u0435): `ID`, `NAME`, `DESCRIPTION`,\n`NUMBER_OF_MEMBERS`, `OWNER_ID`, `DATE_CREATE`, `PROJECT` (Y/N), `TYPE`.\n**\u0413\u0440\u0443\u043F\u043F\u0430 \u2014 \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430** (`workgroup.get`): \u043F\u043B\u044E\u0441 `OWNER_DATA`, `SUBJECT_DATA`, `MEMBERS[]`,\n`MODERATOR_MEMBERS[]`, `CHAT_ID`, `DIALOG_ID`, `IMAGE_ID`, UF-\u043F\u043E\u043B\u044F.\n\n**\u041D\u0435\u0434\u0430\u0432\u043D\u0438\u0439 \u0447\u0430\u0442** (`im.recent.list`): `chat_id`, `title`, `type`, `message{id,text,date,author_id}`,\n`last_id`, `unread`, `pinned`, `user{\u2026}`, `chat{\u2026}`.\n**\u041D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u043F\u043E \u0441\u0435\u043A\u0446\u0438\u0438** (`im.v2.Recent.load`): \u0444\u0438\u043B\u044C\u0442\u0440 `filter[recentSection]` \u2014 `default` (\u043E\u0431\u044B\u0447\u043D\u044B\u0435\n\u0434\u0438\u0430\u043B\u043E\u0433\u0438), **`tasksTask` (\u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447)**, `collab`/`collabDefault` (\u043A\u043E\u043B\u043B\u0430\u0431\u044B). \u041B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u0432\u0433\u043B\u0443\u0431\u044C \u2014\n`im.v2.Recent.tail` \u0441 \u043A\u0443\u0440\u0441\u043E\u0440\u043E\u043C `filter[lastMessageDate]` (ISO-\u0434\u0430\u0442\u0430 \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0435\u0433\u043E \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u0430 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B).\n**\u041A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u044E\u0437\u0435\u0440\u0430** (`im.user.get`): `id`, `name`, `first_name`, `last_name`, `avatar`, `work_position`,\n`gender`, `status`, `online` \u2014 \u0440\u0435\u0437\u043E\u043B\u0432 \u0430\u0432\u0442\u043E\u0440\u0430 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F (`authorId`) \u0432 \u0438\u043C\u044F.\n**\u0421\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0435** (`im.v2.Chat.Message.*`): `id`, `chatId`, `authorId`, `date`, `text`, `params`, `viewed`.\n\u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043D\u0435\u0441\u0451\u0442 `users[]` (\u0443\u0447\u0430\u0441\u0442\u043D\u0438\u043A\u0438), `additionalMessages[]`, `hasPrevPage`/`hasNextPage`.\n`chatId` \u0431\u0435\u0440\u0451\u0442\u0441\u044F \u0438\u0437 `im.recent.list` (`chat_id`) \u0438\u043B\u0438 \u0438\u0437 `workgroup.get` (`CHAT_ID`/`DIALOG_ID`).\n\n**\u0410\u0434\u0440\u0435\u0441\u0430\u0446\u0438\u044F \u0447\u0430\u0442\u0430 (`chat.load`): `dialogId` vs `chatId`.** `chat.load` \u043F\u0440\u0438\u043D\u0438\u043C\u0430\u0435\u0442 \u043B\u044E\u0431\u043E\u0439 \u0438\u0437 \u0434\u0432\u0443\u0445:\n- `dialogId` = **ID \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F** (\u0447\u0438\u0441\u043B\u043E, \u043D\u0430\u043F\u0440. `11`) \u2192 **\u043B\u0438\u0447\u043D\u044B\u0439 \u0447\u0430\u0442 1-\u043D\u0430-1** \u0441 \u044D\u0442\u0438\u043C \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u043C.\n- `dialogId` = **`"chat"+CHAT_ID`** (\u043D\u0430\u043F\u0440. `"chat7111"`) \u2192 **\u0433\u0440\u0443\u043F\u043F\u043E\u0432\u043E\u0439 \u0447\u0430\u0442** (\u043F\u0440\u043E\u0435\u043A\u0442\u0430/\u0437\u0430\u0434\u0430\u0447\u0438/\u043A\u0430\u043D\u0430\u043B\u0430).\n- `chatId` = \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0439 `CHAT_ID` \u2014 \u0442\u043E \u0436\u0435, \u0447\u0442\u043E \u0433\u0440\u0443\u043F\u043F\u043E\u0432\u043E\u0439 `dialogId`, \u043D\u043E \u0431\u0435\u0437 \u043F\u0440\u0435\u0444\u0438\u043A\u0441\u0430.\n\n\u041E\u0442\u0432\u0435\u0442 `chat.load` \u0432\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0439 `chatId` \u2014 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 \u0435\u0433\u043E \u0434\u0430\u043B\u044C\u0448\u0435 \u0434\u043B\u044F `chat.messages` /\n`chat.messages.tail` (\u043B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u0432\u0433\u043B\u0443\u0431\u044C) \u0438 `chat.message.read` (\u044D\u0442\u0438 \u0442\u0440\u0438 \u0440\u0430\u0431\u043E\u0442\u0430\u044E\u0442 \u043F\u043E `chatId`, \u043D\u0435 \u043F\u043E `dialogId`).\n\n---\n\n## 6. \u041F\u0440\u0438\u043C\u0435\u0440\u044B \u0432\u044B\u0437\u043E\u0432\u043E\u0432\n\n```jsonc\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044B\u0435 \u0437\u0430\u0434\u0430\u0447\u0438 \u043E\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043D\u043D\u043E\u0433\u043E 55, \u043F\u043E \u0434\u0435\u0434\u043B\u0430\u0439\u043D\u0443, \u0432\u0442\u043E\u0440\u0430\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430\nbitrix_tasks_list { "params": { "filter": {"RESPONSIBLE_ID":55,"REAL_STATUS":2},\n                                "order": {"DEADLINE":"asc"}, "start": 50 } }\n\n// \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0437\u0430\u0434\u0430\u0447\u0438 \u0441 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u043D\u044B\u043C \u043D\u0430\u0431\u043E\u0440\u043E\u043C \u043F\u043E\u043B\u0435\u0439\nbitrix_task_get { "taskId": 4229, "params": { "select": ["ID","TITLE","DESCRIPTION","TAGS","TIME_ESTIMATE"] } }\n\n// \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0437\u0430\u0434\u0430\u0447\u0438 \u0447\u0435\u0440\u0435\u0437 v2-\u043F\u043E\u0434\u0441\u0438\u0441\u0442\u0435\u043C\u0443 (JSON-\u0442\u0435\u043B\u043E; id \u0432\u043B\u043E\u0436\u0435\u043D \u0432 task)\nbitrix_task_get_v2 { "taskId": 4229 }                       // \u2192 { "task": { "id": 4229 } }\nbitrix_call { "name": "task.v2.get", "params": { "task": { "id": 4229 } } }\n\n// \u0444\u0430\u0439\u043B\u044B \u0437\u0430\u0434\u0430\u0447\u0438 \u0438 \u0441\u0447\u0451\u0442\u0447\u0438\u043A \u043F\u0440\u043E\u0441\u043C\u043E\u0442\u0440\u043E\u0432 (v2, JSON-\u0442\u0435\u043B\u043E); \u043F\u043E\u0434\u0437\u0430\u0434\u0430\u0447\u0438/\u0441\u0432\u044F\u0437\u0430\u043D\u043D\u044B\u0435\nbitrix_call { "name": "task.files", "params": { "ids": [4229] } }\nbitrix_call { "name": "task.views.count", "params": { "task": { "id": 4229 } } }\nbitrix_task_subtasks { "taskId": 4229 }\nbitrix_task_related  { "taskId": 4229 }\n\n// \u043F\u0440\u043E\u0435\u043A\u0442\u044B \u043F\u043E \u0434\u0430\u0442\u0435 \u0441\u043E\u0437\u0434\u0430\u043D\u0438\u044F; \u043F\u043E\u043B\u043D\u0430\u044F \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0433\u0440\u0443\u043F\u043F\u044B\nbitrix_projects_list { "params": { "order": {"DATE_CREATE":"desc"} } }\nbitrix_project_get { "groupId": 15 }\n\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044C \u0447\u0430\u0442 (\u043F\u0435\u0440\u0432\u044B\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F)\nbitrix_chat_load { "chatId": 485, "messageLimit": 50 }\n\n// \u041B\u0418\u0421\u0422\u0410\u041D\u0418\u0415 \u0418\u0421\u0422\u041E\u0420\u0418\u0418 \u0412\u0413\u041B\u0423\u0411\u042C (\u0441\u0442\u0430\u0440\u044B\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F): beforeId = \u043C\u0438\u043D\u0438\u043C\u0430\u043B\u044C\u043D\u044B\u0439 id \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F\n// \u0438\u0437 \u0442\u0435\u043A\u0443\u0449\u0435\u0439 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B. \u041F\u043E\u0432\u0442\u043E\u0440\u044F\u0439, \u0443\u043C\u0435\u043D\u044C\u0448\u0430\u044F beforeId, \u0434\u043E \u043D\u0430\u0447\u0430\u043B\u0430 \u0438\u0441\u0442\u043E\u0440\u0438\u0438 (order DESC \u2014 \u0434\u0435\u0444\u043E\u043B\u0442).\nbitrix_chat_history { "chatId": 485, "beforeId": 1861279 }\n\n// \u043F\u043E\u043C\u0435\u0442\u0438\u0442\u044C \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u043D\u043D\u044B\u043C\u0438 (\u041C\u0423\u0422\u0418\u0420\u0423\u042E\u0429\u0418\u0419). actionUuid \u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044F \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438.\nbitrix_chat_mark_read { "chatId": 40271, "ids": [1884131] }\n```\n\n### 6.1. \u0421\u0446\u0435\u043D\u0430\u0440\u0438\u0439: \u0447\u0430\u0442 \u0441 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u044B\u043C \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u043C\n\n\u041B\u0438\u0447\u043D\u044B\u0439 \u0447\u0430\u0442 1-\u043D\u0430-1 \u0430\u0434\u0440\u0435\u0441\u0443\u0435\u0442\u0441\u044F `dialogId` = **ID \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F**. Id \u0431\u0435\u0440\u0451\u0442\u0441\u044F \u0438\u0437 \u0437\u0430\u0434\u0430\u0447\u0438\n(`RESPONSIBLE_ID`/`CREATED_BY`), \u0438\u0437 `bitrix_chats_recent`, \u043B\u0438\u0431\u043E \u0440\u0435\u0437\u043E\u043B\u0432\u0438\u0442\u0441\u044F \u043F\u043E\u0438\u0441\u043A\u043E\u043C (\xA76.3).\n\n```jsonc\n// 1) \u043E\u0442\u043A\u0440\u044B\u0442\u044C \u043B\u0438\u0447\u043D\u044B\u0439 \u0447\u0430\u0442 \u0441 \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u043C 11 \u2192 \u0432 \u043E\u0442\u0432\u0435\u0442\u0435 \u0431\u0443\u0434\u0435\u0442 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0439 chatId\nbitrix_chat_load { "dialogId": 11 }\n// 2) \u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0435\u0433\u043E \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u0432\u0433\u043B\u0443\u0431\u044C \u043F\u043E chatId \u0438\u0437 \u043E\u0442\u0432\u0435\u0442\u0430 \u0448\u0430\u0433\u0430 1\nbitrix_chat_history { "chatId": 485, "beforeId": 1861279 }\n```\n\n### 6.2. \u0421\u0446\u0435\u043D\u0430\u0440\u0438\u0439: \u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0435 (\u0447\u0430\u0442) \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u0439 \u0437\u0430\u0434\u0430\u0447\u0438\n\n\u0423 \u043A\u0430\u0436\u0434\u043E\u0439 \u0437\u0430\u0434\u0430\u0447\u0438 \u0435\u0441\u0442\u044C \u0441\u0432\u043E\u0439 im-\u0447\u0430\u0442-\u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0435. \u0414\u0432\u0430 \u043F\u0443\u0442\u0438 \u043D\u0430\u0439\u0442\u0438 \u0435\u0433\u043E `chatId`:\n\n**\u0410. \u0427\u0435\u0440\u0435\u0437 \u0441\u043F\u0438\u0441\u043E\u043A \u0447\u0430\u0442\u043E\u0432 \u0437\u0430\u0434\u0430\u0447 (\u043F\u0440\u044F\u043C\u043E\u0439).** `im.v2.Recent.load` \u0441 \u0441\u0435\u043A\u0446\u0438\u0435\u0439 `tasksTask` \u043E\u0442\u0434\u0430\u0451\u0442 \u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447\n(\u0432 `bitrix_chats_recent` / `/rest/im.recent.list` \u0438\u0445 \u041D\u0415\u0422). \u041B\u0438\u0441\u0442\u0430\u0442\u044C \u0432\u0433\u043B\u0443\u0431\u044C \u2014 `bitrix_recent_tail`.\n\n```jsonc\nbitrix_recent_load { "section": "tasksTask" }           // \u2192 \u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447 \u0441 chatId/dialogId\nbitrix_recent_tail { "section": "tasksTask", "lastMessageDate": "2026-06-29T17:25:38+03:00" }\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044C \u043D\u0430\u0439\u0434\u0435\u043D\u043D\u044B\u0439 \u0447\u0430\u0442 \u0438 \u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0438\u0441\u0442\u043E\u0440\u0438\u044E\nbitrix_chat_load    { "dialogId": "chat38849" }         // \u0438\u043B\u0438 { "chatId": 38849 }\nbitrix_chat_history { "chatId": 38849, "beforeId": 1722353 }\n```\n\n**\u0411. \u041F\u043E\u0438\u0441\u043A\u043E\u043C \u043F\u043E \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u044E \u0437\u0430\u0434\u0430\u0447\u0438** \u2014 `bitrix_entity_search` \u0441 \u0441\u0435\u043A\u0446\u0438\u0435\u0439 `tasksTask`:\n\n```jsonc\nbitrix_entity_search { "query": "\u0442\u0440\u0435\u043A\u0435\u0440", "section": "tasksTask" }\n```\n\n**\u0427\u0430\u0442 \u041F\u0420\u041E\u0415\u041A\u0422\u0410 \u0437\u0430\u0434\u0430\u0447\u0438** (\u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0435 \u0433\u0440\u0443\u043F\u043F\u044B, \u043D\u0435 \u0441\u0430\u043C\u043E\u0439 \u0437\u0430\u0434\u0430\u0447\u0438) \u2014 \u0447\u0435\u0440\u0435\u0437 `GROUP_ID`:\n\n```jsonc\nbitrix_task_get    { "taskId": 4229, "params": { "select": ["ID","GROUP_ID"] } }\nbitrix_project_get { "groupId": 15 }                    // \u043E\u0442\u0434\u0430\u0451\u0442 CHAT_ID / DIALOG_ID\nbitrix_chat_load   { "dialogId": "chat7111" }\nbitrix_chat_get_dialog_id { "externalId": "sg15" }      // \u043B\u0438\u0431\u043E \u0440\u0435\u0437\u043E\u043B\u0432 dialogId \u0441\u043E\u0446\u0433\u0440\u0443\u043F\u043F\u044B \u043D\u0430\u043F\u0440\u044F\u043C\u0443\u044E\n```\n\n### 6.3. \u0421\u0446\u0435\u043D\u0430\u0440\u0438\u0439: \u043F\u043E\u0438\u0441\u043A \u0447\u0430\u0442\u0430 / \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F\n\n\u0422\u0435\u043A\u0441\u0442\u043E\u0432\u044B\u0439 \u043F\u043E\u0438\u0441\u043A \u2014 `bitrix_entity_search` (\u043E\u0431\u0451\u0440\u0442\u043A\u0430 \u043D\u0430\u0434 `ui.entityselector.doSearch`): \u0441\u0430\u043C \u0441\u043E\u0431\u0438\u0440\u0430\u0435\u0442\n\u0434\u0438\u0430\u043B\u043E\u0433 `IM_CHAT_SEARCH` \u0438 `searchQuery` \u0438\u0437 \u0441\u0442\u0440\u043E\u043A\u0438:\n\n```jsonc\nbitrix_entity_search { "query": "\u0434\u043C\u0438\u0442\u0440\u0438\u0439" }                        // \u0441\u0440\u0435\u0434\u0438 \u0432\u0441\u0435\u0445 \u0447\u0430\u0442\u043E\u0432/\u0434\u0438\u0430\u043B\u043E\u0433\u043E\u0432\nbitrix_entity_search { "query": "\u0442\u0440\u0435\u043A\u0435\u0440", "section": "tasksTask" } // \u0441\u0440\u0435\u0434\u0438 \u0447\u0430\u0442\u043E\u0432 \u0437\u0430\u0434\u0430\u0447\n```\n\n\u0411\u044B\u0441\u0442\u0440\u044B\u0439 \u043F\u0443\u0442\u044C \u0431\u0435\u0437 \u043F\u043E\u0438\u0441\u043A\u0430 \u2014 \u043D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u0447\u0430\u0442\u044B \u0438 \u0444\u0438\u043B\u044C\u0442\u0440\u0430\u0446\u0438\u044F \u043D\u0430 \u0441\u0442\u043E\u0440\u043E\u043D\u0435 \u0430\u0433\u0435\u043D\u0442\u0430; \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0430\u0432\u0442\u043E\u0440\u0430 \u043F\u043E id:\n\n```jsonc\nbitrix_chats_recent { }                        // \u0441\u043E\u043F\u043E\u0441\u0442\u0430\u0432\u044C \u043F\u043E title / user\nbitrix_recent_load  { "section": "tasksTask" }\nbitrix_user_get     { "userId": 11 }           // \u0440\u0435\u0437\u043E\u043B\u0432 authorId \u2192 \u0438\u043C\u044F\n```\n\n### 6.4. \u041B\u0435\u0433\u0430\u0441\u0438-\u043A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 \u0437\u0430\u0434\u0430\u0447\u0438 (HTML-\u043F\u043E\u0434\u0434\u043E\u043C\u0435\u043D \u2014 \u043F\u043E\u043A\u0430 \u041D\u0415 \u0432 \u043C\u043E\u0441\u0442\u0435)\n\n\u0423 \u0437\u0430\u0434\u0430\u0447 \u0434\u0432\u0430 \u043D\u0435\u0437\u0430\u0432\u0438\u0441\u0438\u043C\u044B\u0445 \u0444\u0438\u0434\u0430 \u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u044F:\n- **im.v2-\u0447\u0430\u0442** \u2014 \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u043D\u044B\u0439 JSON, \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044F \u0443\u0436\u0435 \u0441\u0435\u0439\u0447\u0430\u0441 (\xA76.2); \u043E\u0431\u044B\u0447\u043D\u043E \u044D\u0442\u043E\u0433\u043E \u0434\u043E\u0441\u0442\u0430\u0442\u043E\u0447\u043D\u043E.\n- **\u0424\u043E\u0440\u0443\u043C\u043D\u044B\u0435 \u043B\u0435\u0433\u0430\u0441\u0438-\u043A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438** \u2014 \u0440\u0435\u043D\u0434\u0435\u0440\u044F\u0442\u0441\u044F \u043A\u0430\u043A **HTML** \u0432 side-slider\'\u0435. \u042D\u0442\u043E \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u044B\u0439\n  \xABHTML-\u043F\u043E\u0434\u0434\u043E\u043C\u0435\u043D\xBB \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0435\u0433\u043E API, \u043A\u043E\u0442\u043E\u0440\u044B\u0439 **\u0442\u0435\u043A\u0443\u0449\u0438\u0439 \u043C\u043E\u0441\u0442 \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442** (\u0431\u043B\u043E\u043A\u0435\u0440\u044B \u043D\u0438\u0436\u0435).\n\n**\u041A\u0430\u043A \u0433\u0440\u0443\u0437\u044F\u0442\u0441\u044F (\u0440\u0435\u0432\u0435\u0440\u0441).** \u041F\u0435\u0440\u0432\u0430\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430 \u2014 GET HTML-\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B iframe (\u0441\u0435\u0440\u0432\u0435\u0440 \u0442\u0443\u0442 \u0436\u0435 \u043C\u0438\u043D\u0442\u0438\u0442 \u043F\u043E\u0434\u043F\u0438\u0441\u044C):\n\n```\nGET /task/comments/<taskId>/?IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER   \u2192 HTML (\u043A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 + signedParameters)\n```\n\n\u041B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u2014 POST \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u043D\u043E\u0433\u043E ajax (\u0444\u043E\u0440\u043C\u0430, \u043E\u0442\u0434\u0430\u0451\u0442 HTML-\u0444\u0440\u0430\u0433\u043C\u0435\u043D\u0442):\n\n```\nPOST /bitrix/services/main/ajax.php?mode=class&c=bitrix:forum.comments&action=navigateComment\nform: AJAX_POST=Y, ENTITY_XML_ID=TASK_<taskId>, taskId=<taskId>, MODE=LIST,\n      FILTER[<ID]=<\u043A\u0443\u0440\u0441\u043E\u0440: id, \u0414\u041E \u043A\u043E\u0442\u043E\u0440\u043E\u0433\u043E \u0433\u0440\u0443\u0437\u0438\u0442\u044C \u0441\u0442\u0430\u0440\u044B\u0435>, PAGEN_1=1,\n      signedParameters=<\u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043D\u043D\u044B\u0439 blob>, IFRAME=Y, IFRAME_TYPE=SIDE_SLIDER\nheaders: bx-ajax: true, x-bitrix-site-id: s1 (\u043F\u043B\u044E\u0441 \u043E\u0431\u044B\u0447\u043D\u044B\u0439 X-Bitrix-Csrf-Token)\n```\n\n`signedParameters` \u2014 base64 PHP-\u043C\u0430\u0441\u0441\u0438\u0432\u0430 + HMAC-\u043F\u043E\u0434\u043F\u0438\u0441\u044C \u0441\u0435\u0440\u0432\u0435\u0440\u0430; \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\n`FORUM_ID, ENTITY_TYPE=TK, ENTITY_ID=<taskId>, ENTITY_XML_ID=TASK_<taskId>, \u2026`. **\u041F\u043E\u0434\u0434\u0435\u043B\u0430\u0442\u044C \u043D\u0435\u043B\u044C\u0437\u044F** \u2014\n\u0431\u0435\u0440\u0451\u0442\u0441\u044F \u0438\u0437 HTML \u043F\u0435\u0440\u0432\u043E\u0439 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B.\n\n**\u041F\u043E\u0447\u0435\u043C\u0443 \u043F\u043E\u043A\u0430 \u043D\u0435 \u0432 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0435 (3 \u0431\u043B\u043E\u043A\u0435\u0440\u0430):**\n1. \u041C\u043E\u0441\u0442 \u043F\u0430\u0440\u0441\u0438\u0442 \u043E\u0442\u0432\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u043A\u0430\u043A JSON (`extension/src/connector.ts` \u2192 `resp.json()`) \u2014 HTML \u0431\u0440\u043E\u0441\u0438\u0442 \u0438\u0441\u043A\u043B\u044E\u0447\u0435\u043D\u0438\u0435.\n2. Path-\u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440 \u0432 URL (`/task/comments/<taskId>/`) \u2014 \u0437\u0430\u043F\u0438\u0441\u0438 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0441\u0442\u0430\u0442\u0438\u0447\u043D\u044B, \u0448\u0430\u0431\u043B\u043E\u043D\u043E\u0432 \u043F\u0443\u0442\u0438 \u043D\u0435\u0442.\n3. `signedParameters` + \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043A\u0438 `bx-ajax`/`x-bitrix-site-id` \u2014 \u043D\u0443\u0436\u0435\u043D \u043F\u0440\u0435\u0434\u0432\u0430\u0440\u0438\u0442\u0435\u043B\u044C\u043D\u044B\u0439 GET HTML-\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B.\n\n**\u0427\u0442\u043E\u0431\u044B \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0438\u0442\u044C** (\u0431\u0443\u0434\u0443\u0449\u0430\u044F \u0440\u0430\u0431\u043E\u0442\u0430): \u043D\u0430\u0443\u0447\u0438\u0442\u044C \u043C\u043E\u0441\u0442 \u0432\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044C text/HTML \u043F\u0440\u0438 \u043D\u0435-JSON \u043E\u0442\u0432\u0435\u0442\u0435 \u0438\n\u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0430\u0442\u044C path-\u0448\u0430\u0431\u043B\u043E\u043D \u044D\u043D\u0434\u043F\u043E\u0438\u043D\u0442\u0430; \u0437\u0430\u0442\u0435\u043C \u043E\u0431\u0451\u0440\u0442\u043A\u0430 `bitrix_task_comments { taskId }` (GET \u043F\u0435\u0440\u0432\u043E\u0439\n\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B), \u0430 \u043B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u2014 \u0447\u0435\u0440\u0435\u0437 `navigateComment` \u0441 \u0432\u044B\u043F\u0430\u0440\u0441\u0435\u043D\u043D\u044B\u043C `signedParameters`.\n\n> \u0422\u043E\u0442 \u0436\u0435 HTML-\u043F\u043E\u0434\u0434\u043E\u043C\u0435\u043D: **\u0434\u0435\u0442\u0430\u043B\u0438 \u0437\u0432\u043E\u043D\u043A\u0430** \u2014 `GET /call/detail/<callId>?IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER`\n> (\u043E\u0442\u0434\u0430\u0451\u0442 HTML). \u041E\u0433\u0440\u0430\u043D\u0438\u0447\u0435\u043D\u0438\u044F \u0438\u0434\u0435\u043D\u0442\u0438\u0447\u043D\u044B.\n\n---\n\n## 7. \u041A\u0430\u043A \u0440\u0430\u0441\u0448\u0438\u0440\u0438\u0442\u044C (\u043D\u043E\u0432\u044B\u0439 \u0434\u043E\u043C\u0435\u043D: \u043A\u0430\u043B\u0435\u043D\u0434\u0430\u0440\u044C, \u0434\u0438\u0441\u043A, CRM, \u2026)\n\n1. \u0421\u043D\u0438\u043C\u0438 \u0440\u0435\u0430\u043B\u044C\u043D\u044B\u0435 \u0432\u044B\u0437\u043E\u0432\u044B (`docs/reconnaissance.md` \u2014 \u0430\u0432\u0442\u043E-\u0437\u0430\u043F\u0438\u0441\u044C `bun run capture` \u0438\u043B\u0438 HAR \u2192\n   `bun run catalog:draft`). \u0427\u0435\u0440\u043D\u043E\u0432\u0438\u043A `actions.draft.json` \u043D\u0430\u043A\u0430\u043F\u043B\u0438\u0432\u0430\u0435\u0442 **\u0432\u0441\u0435 \u0443\u043D\u0438\u043A\u0430\u043B\u044C\u043D\u044B\u0435 \u043A\u043E\u043C\u0431\u0438\u043D\u0430\u0446\u0438\u0438\n   \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432** \u043D\u0430 \u044D\u043A\u0448\u0435\u043D \u0438 \u043F\u0440\u043E\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 `bodyType` (form/json) \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438.\n2. \u041E\u043F\u0440\u0435\u0434\u0435\u043B\u0438 \u0442\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 \u043F\u043E \u0440\u0430\u0437\u0434\u0435\u043B\u0443 3: \u0435\u0441\u043B\u0438 \u0447\u0435\u0440\u043D\u043E\u0432\u0438\u043A \u043F\u043E\u043A\u0430\u0437\u0430\u043B `"bodyType": "json"` \u2014 \u043F\u0435\u0440\u0435\u043D\u0435\u0441\u0438 \u0435\u0433\u043E \u0432 \u0437\u0430\u043F\u0438\u0441\u044C.\n3. \u0414\u043E\u0431\u0430\u0432\u044C \u0437\u0430\u043F\u0438\u0441\u044C \u0432 `actions.json` (\u043C\u043E\u0436\u0435\u0442 \u0431\u044B\u0442\u044C \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0435\u0439 \u2014 \u043A\u0430\u0442\u0430\u043B\u043E\u0433 \u044D\u0442\u043E \u0434\u043E\u043F\u0443\u0441\u043A\u0430\u0435\u0442). \u041F\u0440\u043E\u0432\u0435\u0440\u044C \u0447\u0435\u0440\u0435\u0437\n   `bitrix_call { name, params }`.\n4. \u0415\u0441\u043B\u0438 \u0443\u0434\u043E\u0431\u043D\u043E \u2014 \u043E\u0431\u0435\u0440\u043D\u0438 \u0432 \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0439 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u0432 `src/tools/register.ts` (\u0441 \u0434\u0435\u0444\u043E\u043B\u0442\u043D\u044B\u043C `select`).\n\n> `actions.json` / `actions.draft.json` \u2014 \u0434\u0430\u043D\u043D\u044B\u0435 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u0433\u043E \u043F\u043E\u0440\u0442\u0430\u043B\u0430 (gitignored). \u042D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B\n> (`api-notes.md`) \u2014 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0438\u043C\u044B\u0435 \u0437\u043D\u0430\u043D\u0438\u044F \u043E \u0441\u0430\u043C\u043E\u043C API; \u0434\u0435\u0440\u0436\u0438 \u0435\u0433\u043E \u0432 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u043E\u043C \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0438 \u043F\u0440\u0438 \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u0438\n> \u043D\u043E\u0432\u044B\u0445 \u043C\u0435\u0442\u043E\u0434\u043E\u0432.\n' ? '# Bitrix24 API notes (reverse-engineered)\n\n\u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0435\u043C\u0443 API Bitrix24, \u0434\u043E\u0431\u044B\u0442\u044B\u0439 **\u0436\u0438\u0432\u044B\u043C \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C** (\u0443 \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0438\u0445 ajax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u043E\u0432\n\u043D\u0435\u0442 \u043F\u0443\u0431\u043B\u0438\u0447\u043D\u043E\u0439 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u0438). \u041F\u0440\u0435\u0434\u043D\u0430\u0437\u043D\u0430\u0447\u0435\u043D \u0434\u043B\u044F \u043B\u044E\u0431\u043E\u0433\u043E \u0418\u0418-\u0430\u0433\u0435\u043D\u0442\u0430 \u0438\u043B\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043E\u0442\u0447\u0438\u043A\u0430, \u043A\u043E\u0442\u043E\u0440\u044B\u0439 \u0432\u044B\u0437\u044B\u0432\u0430\u0435\u0442\n\u044D\u0442\u0438 \u043C\u0435\u0442\u043E\u0434\u044B \u0447\u0435\u0440\u0435\u0437 \u043C\u043E\u0441\u0442 (`bitrix_call` / \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B) \u0438\u043B\u0438 \u0440\u0430\u0441\u0448\u0438\u0440\u044F\u0435\u0442 \u043A\u0430\u0442\u0430\u043B\u043E\u0433.\n\n\u041D\u0430\u0431\u043B\u044E\u0434\u0435\u043D\u0438\u044F \u0441\u043D\u044F\u0442\u044B \u043D\u0430 \u043F\u043E\u0440\u0442\u0430\u043B\u0435 `example.bitrix24.ru` (\u043E\u0431\u043B\u0430\u043A\u043E, \u043C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 **im.v2**, \u0437\u0430\u0434\u0430\u0447\u0438 \u0432 \u0440\u0435\u0436\u0438\u043C\u0435\n**scrum-\u0431\u043E\u0440\u0434\u0430**). \u0418\u043C\u0435\u043D\u0430 \u043F\u043E\u043B\u0435\u0439 \u0438 \u043A\u043E\u043D\u0432\u0435\u043D\u0446\u0438\u0438 \u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442\u043D\u044B \u0434\u043B\u044F \u043E\u0431\u043B\u0430\u0447\u043D\u043E\u0433\u043E Bitrix24, \u043D\u043E \u043F\u0440\u0438 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0435 \u043D\u0430 \u0434\u0440\u0443\u0433\u043E\u0439\n\u043F\u043E\u0440\u0442\u0430\u043B \u0441\u0432\u0435\u0440\u044F\u0439\u0441\u044F \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C (`docs/reconnaissance.md`).\n\n---\n\n## 1. \u041A\u0430\u043A \u0432\u044B\u0437\u044B\u0432\u0430\u0442\u044C\n\n- **`bitrix_call { name, params }`** \u2014 \u0443\u043D\u0438\u0432\u0435\u0440\u0441\u0430\u043B\u044C\u043D\u044B\u0439 \u0432\u044B\u0437\u043E\u0432 \u043B\u044E\u0431\u043E\u0433\u043E \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u043E\u0433\u043E \u0438\u043C\u0435\u043D\u0438 \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430\n  (`actions.json`). `params` \u2014 \u043D\u0430\u0442\u0438\u0432\u043D\u044B\u0439 \u0444\u043E\u0440\u043C\u0430\u0442 Bitrix (\u0441\u043C. \u0440\u0430\u0437\u0434\u0435\u043B 3). \u041A\u0430\u0442\u0430\u043B\u043E\u0433 \u043C\u043E\u0436\u0435\u0442 \u0432\u043A\u043B\u044E\u0447\u0430\u0442\u044C\n  \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0435 \u0432\u044B\u0437\u043E\u0432\u044B; allowlist (`actions.json`) \u2014 \u0435\u0434\u0438\u043D\u0441\u0442\u0432\u0435\u043D\u043D\u0430\u044F \u0433\u0440\u0430\u043D\u0438\u0446\u0430, \u043D\u0435 \u0440\u0435\u0436\u0438\u043C \u0447\u0442\u0435\u043D\u0438\u044F.\n- **\u0422\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B** \u2014 \u043E\u0431\u0451\u0440\u0442\u043A\u0438 \u0441 \u0440\u0430\u0437\u0443\u043C\u043D\u044B\u043C\u0438 \u0434\u0435\u0444\u043E\u043B\u0442\u0430\u043C\u0438 \u043D\u0430\u0434 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u043E\u043C. \u0422\u043E\u0447\u043D\u0430\u044F \u0432\u044B\u0431\u043E\u0440\u043A\u0430 \u2014 \u0447\u0435\u0440\u0435\u0437\n  \u043E\u043F\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u044B\u0439 `params`, \u043E\u043D \u043C\u0435\u0440\u0436\u0438\u0442\u0441\u044F **\u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u043C** \u0438 \u043F\u0435\u0440\u0435\u043A\u0440\u044B\u0432\u0430\u0435\u0442 \u0434\u0435\u0444\u043E\u043B\u0442\u044B. \u0420\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u044E\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E \u0442\u0435,\n  \u0447\u044C\u0451 \u0438\u043C\u044F \u0435\u0441\u0442\u044C \u0432 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0435 (`actions.json`); \u0438\u043D\u0430\u0447\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u043F\u0440\u043E\u043F\u0443\u0441\u043A\u0430\u0435\u0442\u0441\u044F. \u0422\u0435\u043A\u0443\u0449\u0438\u0439 \u043D\u0430\u0431\u043E\u0440:\n  - \u0417\u0430\u0434\u0430\u0447\u0438: `bitrix_tasks_list`, `bitrix_task_get`, `bitrix_task_get_v2` (v2/JSON),\n    `bitrix_task_scrum_info`, `bitrix_task_files`, `bitrix_task_views_count`,\n    `bitrix_task_subtasks` (\u043F\u043E\u0434\u0437\u0430\u0434\u0430\u0447\u0438), `bitrix_task_related` (\u0441\u0432\u044F\u0437\u0430\u043D\u043D\u044B\u0435).\n  - \u041F\u0440\u043E\u0435\u043A\u0442\u044B: `bitrix_projects_list`, `bitrix_project_get`.\n  - \u0427\u0430\u0442\u044B: `bitrix_chats_recent`, `bitrix_recent_load` (\u043D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u043F\u043E \u0441\u0435\u043A\u0446\u0438\u0438 \u2014 \u0432 \u0442.\u0447. `tasksTask` =\n    \u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447), `bitrix_recent_tail` (\u043B\u0438\u0441\u0442\u0430\u0442\u044C \u043D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u0432\u0433\u043B\u0443\u0431\u044C), `bitrix_chat_load` (\u043E\u0442\u043A\u0440\u044B\u0442\u044C \u043F\u043E\n    `dialogId`/`chatId`), `bitrix_chat_messages`, `bitrix_chat_history` (\u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0432\u0433\u043B\u0443\u0431\u044C \u043F\u043E `beforeId`),\n    `bitrix_chat_get_dialog_id` (dialogId \u043F\u043E externalId), `bitrix_chat_mark_read` (\u26A0 \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439),\n    `bitrix_chat_read_all` (\u26A0 \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439).\n  - \u041B\u044E\u0434\u0438/\u043F\u043E\u0438\u0441\u043A: `bitrix_user_get` (\u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u044E\u0437\u0435\u0440\u0430), `bitrix_entity_selector` (\u0437\u0430\u0433\u0440\u0443\u0437\u043A\u0430 \u0441\u0435\u043B\u0435\u043A\u0442\u043E\u0440\u0430),\n    `bitrix_entity_search` (\u0442\u0435\u043A\u0441\u0442\u043E\u0432\u044B\u0439 \u043F\u043E\u0438\u0441\u043A \u0447\u0430\u0442\u043E\u0432/\u0441\u0443\u0449\u043D\u043E\u0441\u0442\u0435\u0439 \u0447\u0435\u0440\u0435\u0437 `ui.entityselector.doSearch`).\n\n  \u041B\u044E\u0431\u043E\u0435 \u0438\u043C\u044F \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0432\u0441\u0435\u0433\u0434\u0430 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u043E \u0438 \u043D\u0430\u043F\u0440\u044F\u043C\u0443\u044E \u0447\u0435\u0440\u0435\u0437 `bitrix_call { name, params }`.\n- **`bitrix_help`** \u2014 \u044D\u0442\u043E\u0442 \u0436\u0435 \u0433\u0430\u0439\u0434, \u043E\u0442\u0434\u0430\u0451\u0442\u0441\u044F \u0447\u0435\u0440\u0435\u0437 MCP (\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 + resource `bitrix://api-notes`).\n  \u0418\u0441\u0442\u043E\u0447\u043D\u0438\u043A \u2014 **\u044D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B** (`docs/api-notes.md`).\n\n\u041F\u043E\u043B\u043D\u044B\u0439 \u0441\u043F\u0438\u0441\u043E\u043A \u0438\u043C\u0451\u043D \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u043E\u0442\u0434\u0430\u0451\u0442 `bitrix_call` \u0432 \u0441\u0432\u043E\u0451\u043C \u043E\u043F\u0438\u0441\u0430\u043D\u0438\u0438 (`deps.catalog.names()`).\n\n---\n\n## 2. \u0424\u043E\u0440\u043C\u0430\u0442 \u043E\u0442\u0432\u0435\u0442\u0430 (\u0432\u0430\u0436\u043D\u043E!)\n\nAjax-\u043A\u043E\u043D\u0442\u0440\u043E\u043B\u043B\u0435\u0440\u044B (`/bitrix/services/main/ajax.php`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 HTTP 200 \u0441 \u043A\u043E\u043D\u0432\u0435\u0440\u0442\u043E\u043C:\n\n```jsonc\n{ "status": "success" | "error",\n  "data": { ... },\n  "errors": [] }          // \u041F\u0423\u0421\u0422\u041E\u0419 \u043C\u0430\u0441\u0441\u0438\u0432 \u043F\u0440\u0438 \u0443\u0441\u043F\u0435\u0445\u0435! (\u0432 JS [] \u2014 truthy)\n```\n\n- \u0423\u0441\u043F\u0435\u0445 \u043E\u043F\u0440\u0435\u0434\u0435\u043B\u044F\u0435\u0442\u0441\u044F `status:"success"` \u0438/\u0438\u043B\u0438 **\u043F\u0443\u0441\u0442\u044B\u043C** `errors`. \u041D\u0435\u043F\u0443\u0441\u0442\u043E\u0439 `errors` / `status:"error"` /\n  top-level `error` \u2014 \u0440\u0435\u0430\u043B\u044C\u043D\u0430\u044F \u043E\u0448\u0438\u0431\u043A\u0430 (\u043C\u043E\u0441\u0442 \u043C\u0430\u043F\u043F\u0438\u0442 \u044D\u0442\u043E \u0432 `ok:false`).\n- REST-\u044D\u043D\u0434\u043F\u043E\u0438\u043D\u0442\u044B (`/rest/*.json`) \u043E\u0442\u0432\u0435\u0447\u0430\u044E\u0442 \u0438\u043D\u0430\u0447\u0435: `{ "result": \u2026, "next", "total", "time" }` \u2014 \u0431\u0435\u0437 `errors`.\n\n---\n\n## 3. \u0422\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442: form vs json (\u0440\u0430\u0437\u043B\u0438\u0447\u0430\u0435\u0442\u0441\u044F \u043F\u043E \u043C\u0435\u0442\u043E\u0434\u0443!)\n\n\u0423 \u043A\u0430\u0436\u0434\u043E\u0439 \u0437\u0430\u043F\u0438\u0441\u0438 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0435\u0441\u0442\u044C **`bodyType`** \u2014 \u043A\u0430\u043A \u043C\u043E\u0441\u0442 \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442 \u0442\u0435\u043B\u043E:\n\n- **`bodyType: "form"`** (\u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E) \u2014 `application/x-www-form-urlencoded`; \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u043E\u0441\u0442\u044C \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\u0441\u044F\n  PHP-\u0441\u0442\u0438\u043B\u0435\u043C (`filter[STATUS]=2`, `select[0]=ID`). \u041E\u0431\u044A\u0435\u043A\u0442 \u0432 `params` \u0440\u0435\u043A\u0443\u0440\u0441\u0438\u0432\u043D\u043E \u0440\u0430\u0437\u0432\u043E\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044F \u0432 \u0442\u0430\u043A\u0438\u0435\n  \u043A\u043B\u044E\u0447\u0438. \u041A\u043B\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043A\u0438\u0435 `tasks.task.*`, \u043C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440 `im.v2.*`, REST \u2014 \u0432\u0441\u0451 \u044D\u0442\u043E \u0444\u043E\u0440\u043C\u0430.\n- **`bodyType: "json"`** \u2014 \u0442\u0435\u043B\u043E \u0443\u0445\u043E\u0434\u0438\u0442 \u043A\u0430\u043A `JSON.stringify(params)` \u0441 `Content-Type: application/json`.\n  \u0422\u0430\u043A \u0440\u0430\u0431\u043E\u0442\u0430\u044E\u0442 **`tasks.v2.*`** (\u043D\u0430\u043F\u0440. `tasks.v2.Task.get` \u0436\u0434\u0451\u0442 `{"task":{"id":N}}`) \u0438 `ui.entityselector.*`.\n  `params` \u043F\u0440\u0438 \u044D\u0442\u043E\u043C \u0441\u043E\u0445\u0440\u0430\u043D\u044F\u0435\u0442 \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u0443\u044E \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0443 \u043A\u0430\u043A \u0435\u0441\u0442\u044C (\u043D\u0435 \u0440\u0430\u0437\u0432\u043E\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044F \u0432 bracket-\u043A\u043B\u044E\u0447\u0438).\n\n> \u0418\u0441\u0442\u043E\u0440\u0438\u0447\u0435\u0441\u043A\u0430\u044F \u0437\u0430\u043C\u0435\u0442\u043A\u0430: \u0440\u0430\u043D\u044C\u0448\u0435 \u043C\u043E\u0441\u0442 \u0443\u043C\u0435\u043B \u0442\u043E\u043B\u044C\u043A\u043E \u0444\u043E\u0440\u043C\u0443, \u0438 `tasks.v2.*` \u0431\u044B\u043B\u0438 \u043D\u0435\u043F\u0440\u0438\u0433\u043E\u0434\u043D\u044B. \u0422\u0435\u043F\u0435\u0440\u044C\n> \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0430\u043D\u044B \u2014 \u0432 \u0437\u0430\u043F\u0438\u0441\u0438 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0441\u0442\u0430\u0432\u044C `"bodyType": "json"`, \u0438 \u043C\u043E\u0441\u0442 \u043E\u0442\u043F\u0440\u0430\u0432\u0438\u0442 \u0438\u0445 \u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u043E.\n\n**CSRF / sessid:** \u043C\u043E\u0441\u0442 \u0432\u0441\u0435\u0433\u0434\u0430 \u0448\u043B\u0451\u0442 \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043E\u043A **`X-Bitrix-Csrf-Token: <sessid>`** (\u0441\u0432\u0435\u0436\u0438\u0439\n`BX.bitrix_sessid()`). Form-\u0442\u0435\u043B\u0430 \u0434\u043E\u043F\u043E\u043B\u043D\u0438\u0442\u0435\u043B\u044C\u043D\u043E \u043D\u0435\u0441\u0443\u0442 `sessid` \u043F\u043E\u043B\u0435\u043C \u0432 \u0442\u0435\u043B\u0435 (legacy REST \u044D\u0442\u043E \u0442\u0440\u0435\u0431\u0443\u0435\u0442);\nJSON-\u0442\u0435\u043B\u0430 \u043D\u0435\u0441\u0443\u0442 sessid **\u0442\u043E\u043B\u044C\u043A\u043E** \u0432 \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043A\u0435. \u041E\u0442\u0432\u0435\u0442 `invalid_csrf`/`invalid_authentication` = \u0441\u0435\u0441\u0441\u0438\u044F\n\u043F\u0440\u043E\u0442\u0443\u0445\u043B\u0430 (\u043F\u0435\u0440\u0435\u043B\u043E\u0433\u0438\u043D\u044C\u0441\u044F \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435).\n\n| \u041C\u0435\u0442\u043E\u0434 (action / endpoint) | bodyType | \u0413\u0434\u0435 `select`/`filter`/`order` | \u041F\u0430\u0433\u0438\u043D\u0430\u0446\u0438\u044F |\n|---|---|---|---|\n| `tasks.task.list` | form | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `filter{}`, `order{}` | `start` (\u0441\u0434\u0432\u0438\u0433, \u0448\u0430\u0433 50) |\n| `tasks.task.get` | form | \u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C: `taskId`, `select[]` | \u2014 |\n| `tasks.v2.Task.get` | **json** | `{"task": {"id": N}}` | \u2014 |\n| `tasks.v2.Scrum.getTaskInfo` | **json** | `{"taskId": N}` | \u2014 |\n| `tasks.v2.File.listObjects` | **json** | `{"ids": [N,\u2026]}` | \u2014 |\n| `tasks.v2.Task.View.User.count` | **json** | `{"task": {"id": N}}` | \u2014 |\n| `tasks.v2.Task.Relation.Child.list` | **json** | `{"taskId": N, "withIds":true, "navigation":{"size":N}}` | `navigation` |\n| `tasks.v2.Task.Relation.Related.list` | **json** | `{"taskId": N, \u2026}` (\u043A\u0430\u043A Child) | `navigation` |\n| `socialnetwork.api.workgroup.list` | form | **\u0432\u0435\u0440\u0445\u043D\u0438\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C**: `select[]`, `order{}`, `filter{}` | (nav \u2014 \u043D\u0435 \u043F\u0440\u043E\u0432\u0435\u0440\u0435\u043D\u043E) |\n| `socialnetwork.api.workgroup.get` | form | **\u043E\u0431\u0451\u0440\u043D\u0443\u0442\u043E**: `params[groupId]`, `params[select][]` | \u2014 |\n| `/rest/im.recent.list.json` | form (rest) | \u043F\u043B\u043E\u0441\u043A\u043E: `LIMIT`, `SKIP_OPENLINES`, `UNREAD_ONLY`, \u2026 | `LIMIT` |\n| `/rest/im.user.get.json` | form (rest) | \u043F\u043B\u043E\u0441\u043A\u043E: `ID` | \u2014 |\n| `im.v2.Recent.load` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `limit`, `filter[recentSection]`, `filter[unread]`, `filter[parentId]` | `im.v2.Recent.tail` |\n| `im.v2.Recent.tail` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `limit`, `filter[lastMessageDate]` (\u043A\u0443\u0440\u0441\u043E\u0440), `filter[recentSection]` | `filter[lastMessageDate]` |\n| `im.v2.Chat.load` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `dialogId`\\|`chatId`, `messageLimit` | \u2014 |\n| `im.v2.Chat.getDialogId` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `externalId` | \u2014 |\n| `im.v2.Chat.Message.list` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `limit` | \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u044F\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430 \u2014 \u043D\u0430\u0437\u0430\u0434 **\u043D\u0435 \u043B\u0438\u0441\u0442\u0430\u0435\u0442**, \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 `.tail` |\n| `im.v2.Chat.Message.tail` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `limit`, `filter[lastId]`, `order[id]` | **\u0441\u043C. \u0440\u0430\u0437\u0434\u0435\u043B 6** |\n| `im.v2.Chat.Message.read` | form | \u043F\u043B\u043E\u0441\u043A\u043E: `chatId`, `ids[]`, `actionUuid` | \u2014 (\u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439) |\n| `im.v2.Chat.readAll` | form | \u0431\u0435\u0437 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432 | \u2014 (\u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439) |\n| `ui.entityselector.load` | **json** | `{"dialog": {entities,preselectedItems,\u2026}}` | \u2014 |\n| `ui.entityselector.doSearch` | **json** | `{"dialog": {\u2026}, "searchQuery": {"query": "...", "queryWords": ["..."]}}` | \u2014 |\n\n---\n\n## 4. \u041A\u0430\u0442\u0430\u043B\u043E\u0433: \u0438\u043C\u044F \u2192 action \u2192 \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B\n\n| \u0418\u043C\u044F (`actions.json`) | action / endpoint | bodyType | \u041A\u043B\u044E\u0447\u0435\u0432\u044B\u0435 params |\n|---|---|---|---|\n| `tasks.list` | `tasks.task.list` | form | `filter{RESPONSIBLE_ID,REAL_STATUS,GROUP_ID,\u2026}`, `select[]`, `order{}`, `start` |\n| `task.get` | `tasks.task.get` | form | `taskId`, `select[]` |\n| `task.v2.get` | `tasks.v2.Task.get` | json | `task.id` (id \u0437\u0430\u0434\u0430\u0447\u0438) |\n| `task.scrum.info` | `tasks.v2.Scrum.getTaskInfo` | json | `taskId` |\n| `task.files` | `tasks.v2.File.listObjects` | json | `ids` (\u043C\u0430\u0441\u0441\u0438\u0432 id) |\n| `task.views.count` | `tasks.v2.Task.View.User.count` | json | `task.id` (id \u0437\u0430\u0434\u0430\u0447\u0438) |\n| `task.subtasks` | `tasks.v2.Task.Relation.Child.list` | json | `taskId`, `navigation{size}` |\n| `task.related` | `tasks.v2.Task.Relation.Related.list` | json | `taskId`, `navigation{size}` |\n| `projects.list` | `socialnetwork.api.workgroup.list` | form | `select[]`, `order{}`, `filter{}` |\n| `projects.get` | `socialnetwork.api.workgroup.get` | form | `params[groupId]`, `params[select][]` |\n| `chats.recent` | `/rest/im.recent.list.json` | form | `LIMIT`, `UNREAD_ONLY`, `SKIP_OPENLINES` |\n| `recent.load` | `im.v2.Recent.load` | form | `filter[recentSection]` (`tasksTask`/`collab`/\u2026), `limit`, `filter[unread]` |\n| `recent.tail` | `im.v2.Recent.tail` | form | `filter[lastMessageDate]`, `filter[recentSection]`, `limit` |\n| `chat.load` | `im.v2.Chat.load` | form | `dialogId`\\|`chatId`, `messageLimit` |\n| `chat.dialogId` | `im.v2.Chat.getDialogId` | form | `externalId` (\u043D\u0430\u043F\u0440. `"sg"+groupId`) |\n| `chat.messages` | `im.v2.Chat.Message.list` | form | `chatId`, `limit` (\u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u0435; \u0432\u0433\u043B\u0443\u0431\u044C \u2014 `chat.messages.tail`) |\n| `chat.messages.tail` | `im.v2.Chat.Message.tail` | form | `chatId`, `filter[lastId]`, `order[id]`, `limit` |\n| `chat.message.read` | `im.v2.Chat.Message.read` | form | `chatId`, `ids[0]`, `actionUuid` |\n| `chat.read.all` | `im.v2.Chat.readAll` | form | \u2014 (\u26A0 \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0439) |\n| `im.user.get` | `/rest/im.user.get.json` | form | `ID` |\n| `entityselector.load` | `ui.entityselector.load` | json | `dialog` (\u043E\u0431\u044A\u0435\u043A\u0442) |\n| `entityselector.search` | `ui.entityselector.doSearch` | json | `dialog`, `searchQuery{query,queryWords}` |\n\n---\n\n## 5. \u0421\u043F\u0440\u0430\u0432\u043E\u0447\u043D\u0438\u043A \u043F\u043E\u043B\u0435\u0439\n\n**\u0417\u0430\u0434\u0430\u0447\u0430** (`tasks.task.*`): `ID`, `TITLE`, `DESCRIPTION`, `STATUS`, `REAL_STATUS`, `RESPONSIBLE_ID`,\n`CREATED_BY`, `CREATED_DATE`, `CHANGED_DATE`, `DEADLINE`, `CLOSED_DATE`, `PRIORITY`, `GROUP_ID`,\n`TAGS`, `TIME_ESTIMATE`, `UF_*`. \u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043F\u043E\u0434\u043A\u043B\u0430\u0434\u044B\u0432\u0430\u0435\u0442 \u043E\u0431\u044A\u0435\u043A\u0442\u044B `group`, `responsible`, `creator`, `action`.\n\n\u0421\u0442\u0430\u0442\u0443\u0441\u044B \u0437\u0430\u0434\u0430\u0447\u0438 (`STATUS`): `1` \u041D\u043E\u0432\u0430\u044F \xB7 `2` \u0416\u0434\u0451\u0442 \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \xB7 `3` \u0412\u044B\u043F\u043E\u043B\u043D\u044F\u0435\u0442\u0441\u044F \xB7 `4` \u0416\u0434\u0451\u0442 \u043A\u043E\u043D\u0442\u0440\u043E\u043B\u044F \xB7\n`5` \u0417\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0430 \xB7 `6` \u041E\u0442\u043B\u043E\u0436\u0435\u043D\u0430 \xB7 `7` \u041E\u0442\u043A\u043B\u043E\u043D\u0435\u043D\u0430.\n\n**\u0417\u0430\u0434\u0430\u0447\u0430 v2** (`tasks.v2.*`): id \u0437\u0430\u0434\u0430\u0447\u0438 \u043F\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0441\u044F \u0432\u043B\u043E\u0436\u0435\u043D\u043D\u043E \u2014 **`{"task": {"id": N}}`** (\u0443 `Task.get` \u0438\n`Task.View.User.count`), \u0430 \u0443 `Scrum.getTaskInfo` \u0438 `Relation.*` \u2014 \u043F\u043B\u043E\u0441\u043A\u043E `{"taskId": N}`. \u042D\u0442\u043E \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u0430\u044F\n\u043F\u043E\u0434\u0441\u0438\u0441\u0442\u0435\u043C\u0430 scrum-\u0431\u043E\u0440\u0434\u0430; \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0443 \u043E\u0442\u0432\u0435\u0442\u0430 \u0441\u0432\u0435\u0440\u044C \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C \u2014 \u0432 \u0437\u0430\u0445\u0432\u0430\u0442\u0435 \u0432\u0438\u0434\u043D\u044B \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B \u0437\u0430\u043F\u0440\u043E\u0441\u0430.\n\n**\u0413\u0440\u0443\u043F\u043F\u0430/\u043F\u0440\u043E\u0435\u043A\u0442 \u2014 \u0441\u043F\u0438\u0441\u043E\u043A** (`workgroup.list`, camelCase \u0432 \u043E\u0442\u0432\u0435\u0442\u0435): `ID`, `NAME`, `DESCRIPTION`,\n`NUMBER_OF_MEMBERS`, `OWNER_ID`, `DATE_CREATE`, `PROJECT` (Y/N), `TYPE`.\n**\u0413\u0440\u0443\u043F\u043F\u0430 \u2014 \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430** (`workgroup.get`): \u043F\u043B\u044E\u0441 `OWNER_DATA`, `SUBJECT_DATA`, `MEMBERS[]`,\n`MODERATOR_MEMBERS[]`, `CHAT_ID`, `DIALOG_ID`, `IMAGE_ID`, UF-\u043F\u043E\u043B\u044F.\n\n**\u041D\u0435\u0434\u0430\u0432\u043D\u0438\u0439 \u0447\u0430\u0442** (`im.recent.list`): `chat_id`, `title`, `type`, `message{id,text,date,author_id}`,\n`last_id`, `unread`, `pinned`, `user{\u2026}`, `chat{\u2026}`.\n**\u041D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u043F\u043E \u0441\u0435\u043A\u0446\u0438\u0438** (`im.v2.Recent.load`): \u0444\u0438\u043B\u044C\u0442\u0440 `filter[recentSection]` \u2014 `default` (\u043E\u0431\u044B\u0447\u043D\u044B\u0435\n\u0434\u0438\u0430\u043B\u043E\u0433\u0438), **`tasksTask` (\u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447)**, `collab`/`collabDefault` (\u043A\u043E\u043B\u043B\u0430\u0431\u044B). \u041B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u0432\u0433\u043B\u0443\u0431\u044C \u2014\n`im.v2.Recent.tail` \u0441 \u043A\u0443\u0440\u0441\u043E\u0440\u043E\u043C `filter[lastMessageDate]` (ISO-\u0434\u0430\u0442\u0430 \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0435\u0433\u043E \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u0430 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B).\n**\u041A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u044E\u0437\u0435\u0440\u0430** (`im.user.get`): `id`, `name`, `first_name`, `last_name`, `avatar`, `work_position`,\n`gender`, `status`, `online` \u2014 \u0440\u0435\u0437\u043E\u043B\u0432 \u0430\u0432\u0442\u043E\u0440\u0430 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F (`authorId`) \u0432 \u0438\u043C\u044F.\n**\u0421\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0435** (`im.v2.Chat.Message.*`): `id`, `chatId`, `authorId`, `date`, `text`, `params`, `viewed`.\n\u041E\u0442\u0432\u0435\u0442 \u0442\u0430\u043A\u0436\u0435 \u043D\u0435\u0441\u0451\u0442 `users[]` (\u0443\u0447\u0430\u0441\u0442\u043D\u0438\u043A\u0438), `additionalMessages[]`, `hasPrevPage`/`hasNextPage`.\n`chatId` \u0431\u0435\u0440\u0451\u0442\u0441\u044F \u0438\u0437 `im.recent.list` (`chat_id`) \u0438\u043B\u0438 \u0438\u0437 `workgroup.get` (`CHAT_ID`/`DIALOG_ID`).\n\n**\u0410\u0434\u0440\u0435\u0441\u0430\u0446\u0438\u044F \u0447\u0430\u0442\u0430 (`chat.load`): `dialogId` vs `chatId`.** `chat.load` \u043F\u0440\u0438\u043D\u0438\u043C\u0430\u0435\u0442 \u043B\u044E\u0431\u043E\u0439 \u0438\u0437 \u0434\u0432\u0443\u0445:\n- `dialogId` = **ID \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F** (\u0447\u0438\u0441\u043B\u043E, \u043D\u0430\u043F\u0440. `11`) \u2192 **\u043B\u0438\u0447\u043D\u044B\u0439 \u0447\u0430\u0442 1-\u043D\u0430-1** \u0441 \u044D\u0442\u0438\u043C \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u043C.\n- `dialogId` = **`"chat"+CHAT_ID`** (\u043D\u0430\u043F\u0440. `"chat7111"`) \u2192 **\u0433\u0440\u0443\u043F\u043F\u043E\u0432\u043E\u0439 \u0447\u0430\u0442** (\u043F\u0440\u043E\u0435\u043A\u0442\u0430/\u0437\u0430\u0434\u0430\u0447\u0438/\u043A\u0430\u043D\u0430\u043B\u0430).\n- `chatId` = \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0439 `CHAT_ID` \u2014 \u0442\u043E \u0436\u0435, \u0447\u0442\u043E \u0433\u0440\u0443\u043F\u043F\u043E\u0432\u043E\u0439 `dialogId`, \u043D\u043E \u0431\u0435\u0437 \u043F\u0440\u0435\u0444\u0438\u043A\u0441\u0430.\n\n\u041E\u0442\u0432\u0435\u0442 `chat.load` \u0432\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0439 `chatId` \u2014 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 \u0435\u0433\u043E \u0434\u0430\u043B\u044C\u0448\u0435 \u0434\u043B\u044F `chat.messages` /\n`chat.messages.tail` (\u043B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u0432\u0433\u043B\u0443\u0431\u044C) \u0438 `chat.message.read` (\u044D\u0442\u0438 \u0442\u0440\u0438 \u0440\u0430\u0431\u043E\u0442\u0430\u044E\u0442 \u043F\u043E `chatId`, \u043D\u0435 \u043F\u043E `dialogId`).\n\n---\n\n## 6. \u041F\u0440\u0438\u043C\u0435\u0440\u044B \u0432\u044B\u0437\u043E\u0432\u043E\u0432\n\n```jsonc\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044B\u0435 \u0437\u0430\u0434\u0430\u0447\u0438 \u043E\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0435\u043D\u043D\u043E\u0433\u043E 55, \u043F\u043E \u0434\u0435\u0434\u043B\u0430\u0439\u043D\u0443, \u0432\u0442\u043E\u0440\u0430\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430\nbitrix_tasks_list { "params": { "filter": {"RESPONSIBLE_ID":55,"REAL_STATUS":2},\n                                "order": {"DEADLINE":"asc"}, "start": 50 } }\n\n// \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0437\u0430\u0434\u0430\u0447\u0438 \u0441 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043D\u043D\u044B\u043C \u043D\u0430\u0431\u043E\u0440\u043E\u043C \u043F\u043E\u043B\u0435\u0439\nbitrix_task_get { "taskId": 4229, "params": { "select": ["ID","TITLE","DESCRIPTION","TAGS","TIME_ESTIMATE"] } }\n\n// \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0437\u0430\u0434\u0430\u0447\u0438 \u0447\u0435\u0440\u0435\u0437 v2-\u043F\u043E\u0434\u0441\u0438\u0441\u0442\u0435\u043C\u0443 (JSON-\u0442\u0435\u043B\u043E; id \u0432\u043B\u043E\u0436\u0435\u043D \u0432 task)\nbitrix_task_get_v2 { "taskId": 4229 }                       // \u2192 { "task": { "id": 4229 } }\nbitrix_call { "name": "task.v2.get", "params": { "task": { "id": 4229 } } }\n\n// \u0444\u0430\u0439\u043B\u044B \u0437\u0430\u0434\u0430\u0447\u0438 \u0438 \u0441\u0447\u0451\u0442\u0447\u0438\u043A \u043F\u0440\u043E\u0441\u043C\u043E\u0442\u0440\u043E\u0432 (v2, JSON-\u0442\u0435\u043B\u043E); \u043F\u043E\u0434\u0437\u0430\u0434\u0430\u0447\u0438/\u0441\u0432\u044F\u0437\u0430\u043D\u043D\u044B\u0435\nbitrix_call { "name": "task.files", "params": { "ids": [4229] } }\nbitrix_call { "name": "task.views.count", "params": { "task": { "id": 4229 } } }\nbitrix_task_subtasks { "taskId": 4229 }\nbitrix_task_related  { "taskId": 4229 }\n\n// \u043F\u0440\u043E\u0435\u043A\u0442\u044B \u043F\u043E \u0434\u0430\u0442\u0435 \u0441\u043E\u0437\u0434\u0430\u043D\u0438\u044F; \u043F\u043E\u043B\u043D\u0430\u044F \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0433\u0440\u0443\u043F\u043F\u044B\nbitrix_projects_list { "params": { "order": {"DATE_CREATE":"desc"} } }\nbitrix_project_get { "groupId": 15 }\n\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044C \u0447\u0430\u0442 (\u043F\u0435\u0440\u0432\u044B\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F)\nbitrix_chat_load { "chatId": 485, "messageLimit": 50 }\n\n// \u041B\u0418\u0421\u0422\u0410\u041D\u0418\u0415 \u0418\u0421\u0422\u041E\u0420\u0418\u0418 \u0412\u0413\u041B\u0423\u0411\u042C (\u0441\u0442\u0430\u0440\u044B\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F): beforeId = \u043C\u0438\u043D\u0438\u043C\u0430\u043B\u044C\u043D\u044B\u0439 id \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F\n// \u0438\u0437 \u0442\u0435\u043A\u0443\u0449\u0435\u0439 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B. \u041F\u043E\u0432\u0442\u043E\u0440\u044F\u0439, \u0443\u043C\u0435\u043D\u044C\u0448\u0430\u044F beforeId, \u0434\u043E \u043D\u0430\u0447\u0430\u043B\u0430 \u0438\u0441\u0442\u043E\u0440\u0438\u0438 (order DESC \u2014 \u0434\u0435\u0444\u043E\u043B\u0442).\nbitrix_chat_history { "chatId": 485, "beforeId": 1861279 }\n\n// \u043F\u043E\u043C\u0435\u0442\u0438\u0442\u044C \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u043D\u043D\u044B\u043C\u0438 (\u041C\u0423\u0422\u0418\u0420\u0423\u042E\u0429\u0418\u0419). actionUuid \u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044F \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438.\nbitrix_chat_mark_read { "chatId": 40271, "ids": [1884131] }\n```\n\n### 6.1. \u0421\u0446\u0435\u043D\u0430\u0440\u0438\u0439: \u0447\u0430\u0442 \u0441 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u044B\u043C \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u043C\n\n\u041B\u0438\u0447\u043D\u044B\u0439 \u0447\u0430\u0442 1-\u043D\u0430-1 \u0430\u0434\u0440\u0435\u0441\u0443\u0435\u0442\u0441\u044F `dialogId` = **ID \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F**. Id \u0431\u0435\u0440\u0451\u0442\u0441\u044F \u0438\u0437 \u0437\u0430\u0434\u0430\u0447\u0438\n(`RESPONSIBLE_ID`/`CREATED_BY`), \u0438\u0437 `bitrix_chats_recent`, \u043B\u0438\u0431\u043E \u0440\u0435\u0437\u043E\u043B\u0432\u0438\u0442\u0441\u044F \u043F\u043E\u0438\u0441\u043A\u043E\u043C (\xA76.3).\n\n```jsonc\n// 1) \u043E\u0442\u043A\u0440\u044B\u0442\u044C \u043B\u0438\u0447\u043D\u044B\u0439 \u0447\u0430\u0442 \u0441 \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u043C 11 \u2192 \u0432 \u043E\u0442\u0432\u0435\u0442\u0435 \u0431\u0443\u0434\u0435\u0442 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0439 chatId\nbitrix_chat_load { "dialogId": 11 }\n// 2) \u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0435\u0433\u043E \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u0432\u0433\u043B\u0443\u0431\u044C \u043F\u043E chatId \u0438\u0437 \u043E\u0442\u0432\u0435\u0442\u0430 \u0448\u0430\u0433\u0430 1\nbitrix_chat_history { "chatId": 485, "beforeId": 1861279 }\n```\n\n### 6.2. \u0421\u0446\u0435\u043D\u0430\u0440\u0438\u0439: \u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0435 (\u0447\u0430\u0442) \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u0439 \u0437\u0430\u0434\u0430\u0447\u0438\n\n\u0423 \u043A\u0430\u0436\u0434\u043E\u0439 \u0437\u0430\u0434\u0430\u0447\u0438 \u0435\u0441\u0442\u044C \u0441\u0432\u043E\u0439 im-\u0447\u0430\u0442-\u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0435. \u0414\u0432\u0430 \u043F\u0443\u0442\u0438 \u043D\u0430\u0439\u0442\u0438 \u0435\u0433\u043E `chatId`:\n\n**\u0410. \u0427\u0435\u0440\u0435\u0437 \u0441\u043F\u0438\u0441\u043E\u043A \u0447\u0430\u0442\u043E\u0432 \u0437\u0430\u0434\u0430\u0447 (\u043F\u0440\u044F\u043C\u043E\u0439).** `im.v2.Recent.load` \u0441 \u0441\u0435\u043A\u0446\u0438\u0435\u0439 `tasksTask` \u043E\u0442\u0434\u0430\u0451\u0442 \u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447\n(\u0432 `bitrix_chats_recent` / `/rest/im.recent.list` \u0438\u0445 \u041D\u0415\u0422). \u041B\u0438\u0441\u0442\u0430\u0442\u044C \u0432\u0433\u043B\u0443\u0431\u044C \u2014 `bitrix_recent_tail`.\n\n```jsonc\nbitrix_recent_load { "section": "tasksTask" }           // \u2192 \u0447\u0430\u0442\u044B \u0437\u0430\u0434\u0430\u0447 \u0441 chatId/dialogId\nbitrix_recent_tail { "section": "tasksTask", "lastMessageDate": "2026-06-29T17:25:38+03:00" }\n// \u043E\u0442\u043A\u0440\u044B\u0442\u044C \u043D\u0430\u0439\u0434\u0435\u043D\u043D\u044B\u0439 \u0447\u0430\u0442 \u0438 \u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0438\u0441\u0442\u043E\u0440\u0438\u044E\nbitrix_chat_load    { "dialogId": "chat38849" }         // \u0438\u043B\u0438 { "chatId": 38849 }\nbitrix_chat_history { "chatId": 38849, "beforeId": 1722353 }\n```\n\n**\u0411. \u041F\u043E\u0438\u0441\u043A\u043E\u043C \u043F\u043E \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u044E \u0437\u0430\u0434\u0430\u0447\u0438** \u2014 `bitrix_entity_search` \u0441 \u0441\u0435\u043A\u0446\u0438\u0435\u0439 `tasksTask`:\n\n```jsonc\nbitrix_entity_search { "query": "\u0442\u0440\u0435\u043A\u0435\u0440", "section": "tasksTask" }\n```\n\n**\u0427\u0430\u0442 \u041F\u0420\u041E\u0415\u041A\u0422\u0410 \u0437\u0430\u0434\u0430\u0447\u0438** (\u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0435 \u0433\u0440\u0443\u043F\u043F\u044B, \u043D\u0435 \u0441\u0430\u043C\u043E\u0439 \u0437\u0430\u0434\u0430\u0447\u0438) \u2014 \u0447\u0435\u0440\u0435\u0437 `GROUP_ID`:\n\n```jsonc\nbitrix_task_get    { "taskId": 4229, "params": { "select": ["ID","GROUP_ID"] } }\nbitrix_project_get { "groupId": 15 }                    // \u043E\u0442\u0434\u0430\u0451\u0442 CHAT_ID / DIALOG_ID\nbitrix_chat_load   { "dialogId": "chat7111" }\nbitrix_chat_get_dialog_id { "externalId": "sg15" }      // \u043B\u0438\u0431\u043E \u0440\u0435\u0437\u043E\u043B\u0432 dialogId \u0441\u043E\u0446\u0433\u0440\u0443\u043F\u043F\u044B \u043D\u0430\u043F\u0440\u044F\u043C\u0443\u044E\n```\n\n### 6.3. \u0421\u0446\u0435\u043D\u0430\u0440\u0438\u0439: \u043F\u043E\u0438\u0441\u043A \u0447\u0430\u0442\u0430 / \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F\n\n\u0422\u0435\u043A\u0441\u0442\u043E\u0432\u044B\u0439 \u043F\u043E\u0438\u0441\u043A \u2014 `bitrix_entity_search` (\u043E\u0431\u0451\u0440\u0442\u043A\u0430 \u043D\u0430\u0434 `ui.entityselector.doSearch`): \u0441\u0430\u043C \u0441\u043E\u0431\u0438\u0440\u0430\u0435\u0442\n\u0434\u0438\u0430\u043B\u043E\u0433 `IM_CHAT_SEARCH` \u0438 `searchQuery` \u0438\u0437 \u0441\u0442\u0440\u043E\u043A\u0438:\n\n```jsonc\nbitrix_entity_search { "query": "\u0434\u043C\u0438\u0442\u0440\u0438\u0439" }                        // \u0441\u0440\u0435\u0434\u0438 \u0432\u0441\u0435\u0445 \u0447\u0430\u0442\u043E\u0432/\u0434\u0438\u0430\u043B\u043E\u0433\u043E\u0432\nbitrix_entity_search { "query": "\u0442\u0440\u0435\u043A\u0435\u0440", "section": "tasksTask" } // \u0441\u0440\u0435\u0434\u0438 \u0447\u0430\u0442\u043E\u0432 \u0437\u0430\u0434\u0430\u0447\n```\n\n\u0411\u044B\u0441\u0442\u0440\u044B\u0439 \u043F\u0443\u0442\u044C \u0431\u0435\u0437 \u043F\u043E\u0438\u0441\u043A\u0430 \u2014 \u043D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u0447\u0430\u0442\u044B \u0438 \u0444\u0438\u043B\u044C\u0442\u0440\u0430\u0446\u0438\u044F \u043D\u0430 \u0441\u0442\u043E\u0440\u043E\u043D\u0435 \u0430\u0433\u0435\u043D\u0442\u0430; \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0430\u0432\u0442\u043E\u0440\u0430 \u043F\u043E id:\n\n```jsonc\nbitrix_chats_recent { }                        // \u0441\u043E\u043F\u043E\u0441\u0442\u0430\u0432\u044C \u043F\u043E title / user\nbitrix_recent_load  { "section": "tasksTask" }\nbitrix_user_get     { "userId": 11 }           // \u0440\u0435\u0437\u043E\u043B\u0432 authorId \u2192 \u0438\u043C\u044F\n```\n\n### 6.4. \u041B\u0435\u0433\u0430\u0441\u0438-\u043A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 \u0437\u0430\u0434\u0430\u0447\u0438 (HTML-\u043F\u043E\u0434\u0434\u043E\u043C\u0435\u043D \u2014 \u043F\u043E\u043A\u0430 \u041D\u0415 \u0432 \u043C\u043E\u0441\u0442\u0435)\n\n\u0423 \u0437\u0430\u0434\u0430\u0447 \u0434\u0432\u0430 \u043D\u0435\u0437\u0430\u0432\u0438\u0441\u0438\u043C\u044B\u0445 \u0444\u0438\u0434\u0430 \u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u044F:\n- **im.v2-\u0447\u0430\u0442** \u2014 \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u043D\u044B\u0439 JSON, \u0447\u0438\u0442\u0430\u0435\u0442\u0441\u044F \u0443\u0436\u0435 \u0441\u0435\u0439\u0447\u0430\u0441 (\xA76.2); \u043E\u0431\u044B\u0447\u043D\u043E \u044D\u0442\u043E\u0433\u043E \u0434\u043E\u0441\u0442\u0430\u0442\u043E\u0447\u043D\u043E.\n- **\u0424\u043E\u0440\u0443\u043C\u043D\u044B\u0435 \u043B\u0435\u0433\u0430\u0441\u0438-\u043A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438** \u2014 \u0440\u0435\u043D\u0434\u0435\u0440\u044F\u0442\u0441\u044F \u043A\u0430\u043A **HTML** \u0432 side-slider\'\u0435. \u042D\u0442\u043E \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u044B\u0439\n  \xABHTML-\u043F\u043E\u0434\u0434\u043E\u043C\u0435\u043D\xBB \u0432\u043D\u0443\u0442\u0440\u0435\u043D\u043D\u0435\u0433\u043E API, \u043A\u043E\u0442\u043E\u0440\u044B\u0439 **\u0442\u0435\u043A\u0443\u0449\u0438\u0439 \u043C\u043E\u0441\u0442 \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442** (\u0431\u043B\u043E\u043A\u0435\u0440\u044B \u043D\u0438\u0436\u0435).\n\n**\u041A\u0430\u043A \u0433\u0440\u0443\u0437\u044F\u0442\u0441\u044F (\u0440\u0435\u0432\u0435\u0440\u0441).** \u041F\u0435\u0440\u0432\u0430\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430 \u2014 GET HTML-\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B iframe (\u0441\u0435\u0440\u0432\u0435\u0440 \u0442\u0443\u0442 \u0436\u0435 \u043C\u0438\u043D\u0442\u0438\u0442 \u043F\u043E\u0434\u043F\u0438\u0441\u044C):\n\n```\nGET /task/comments/<taskId>/?IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER   \u2192 HTML (\u043A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 + signedParameters)\n```\n\n\u041B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u2014 POST \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u043D\u043E\u0433\u043E ajax (\u0444\u043E\u0440\u043C\u0430, \u043E\u0442\u0434\u0430\u0451\u0442 HTML-\u0444\u0440\u0430\u0433\u043C\u0435\u043D\u0442):\n\n```\nPOST /bitrix/services/main/ajax.php?mode=class&c=bitrix:forum.comments&action=navigateComment\nform: AJAX_POST=Y, ENTITY_XML_ID=TASK_<taskId>, taskId=<taskId>, MODE=LIST,\n      FILTER[<ID]=<\u043A\u0443\u0440\u0441\u043E\u0440: id, \u0414\u041E \u043A\u043E\u0442\u043E\u0440\u043E\u0433\u043E \u0433\u0440\u0443\u0437\u0438\u0442\u044C \u0441\u0442\u0430\u0440\u044B\u0435>, PAGEN_1=1,\n      signedParameters=<\u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043D\u043D\u044B\u0439 blob>, IFRAME=Y, IFRAME_TYPE=SIDE_SLIDER\nheaders: bx-ajax: true, x-bitrix-site-id: s1 (\u043F\u043B\u044E\u0441 \u043E\u0431\u044B\u0447\u043D\u044B\u0439 X-Bitrix-Csrf-Token)\n```\n\n`signedParameters` \u2014 base64 PHP-\u043C\u0430\u0441\u0441\u0438\u0432\u0430 + HMAC-\u043F\u043E\u0434\u043F\u0438\u0441\u044C \u0441\u0435\u0440\u0432\u0435\u0440\u0430; \u043A\u043E\u0434\u0438\u0440\u0443\u0435\u0442\n`FORUM_ID, ENTITY_TYPE=TK, ENTITY_ID=<taskId>, ENTITY_XML_ID=TASK_<taskId>, \u2026`. **\u041F\u043E\u0434\u0434\u0435\u043B\u0430\u0442\u044C \u043D\u0435\u043B\u044C\u0437\u044F** \u2014\n\u0431\u0435\u0440\u0451\u0442\u0441\u044F \u0438\u0437 HTML \u043F\u0435\u0440\u0432\u043E\u0439 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B.\n\n**\u041F\u043E\u0447\u0435\u043C\u0443 \u043F\u043E\u043A\u0430 \u043D\u0435 \u0432 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0435 (3 \u0431\u043B\u043E\u043A\u0435\u0440\u0430):**\n1. \u041C\u043E\u0441\u0442 \u043F\u0430\u0440\u0441\u0438\u0442 \u043E\u0442\u0432\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u043A\u0430\u043A JSON (`extension/src/connector.ts` \u2192 `resp.json()`) \u2014 HTML \u0431\u0440\u043E\u0441\u0438\u0442 \u0438\u0441\u043A\u043B\u044E\u0447\u0435\u043D\u0438\u0435.\n2. Path-\u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440 \u0432 URL (`/task/comments/<taskId>/`) \u2014 \u0437\u0430\u043F\u0438\u0441\u0438 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u0441\u0442\u0430\u0442\u0438\u0447\u043D\u044B, \u0448\u0430\u0431\u043B\u043E\u043D\u043E\u0432 \u043F\u0443\u0442\u0438 \u043D\u0435\u0442.\n3. `signedParameters` + \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043A\u0438 `bx-ajax`/`x-bitrix-site-id` \u2014 \u043D\u0443\u0436\u0435\u043D \u043F\u0440\u0435\u0434\u0432\u0430\u0440\u0438\u0442\u0435\u043B\u044C\u043D\u044B\u0439 GET HTML-\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B.\n\n**\u0427\u0442\u043E\u0431\u044B \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0438\u0442\u044C** (\u0431\u0443\u0434\u0443\u0449\u0430\u044F \u0440\u0430\u0431\u043E\u0442\u0430): \u043D\u0430\u0443\u0447\u0438\u0442\u044C \u043C\u043E\u0441\u0442 \u0432\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044C text/HTML \u043F\u0440\u0438 \u043D\u0435-JSON \u043E\u0442\u0432\u0435\u0442\u0435 \u0438\n\u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0430\u0442\u044C path-\u0448\u0430\u0431\u043B\u043E\u043D \u044D\u043D\u0434\u043F\u043E\u0438\u043D\u0442\u0430; \u0437\u0430\u0442\u0435\u043C \u043E\u0431\u0451\u0440\u0442\u043A\u0430 `bitrix_task_comments { taskId }` (GET \u043F\u0435\u0440\u0432\u043E\u0439\n\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B), \u0430 \u043B\u0438\u0441\u0442\u0430\u043D\u0438\u0435 \u2014 \u0447\u0435\u0440\u0435\u0437 `navigateComment` \u0441 \u0432\u044B\u043F\u0430\u0440\u0441\u0435\u043D\u043D\u044B\u043C `signedParameters`.\n\n> \u0422\u043E\u0442 \u0436\u0435 HTML-\u043F\u043E\u0434\u0434\u043E\u043C\u0435\u043D: **\u0434\u0435\u0442\u0430\u043B\u0438 \u0437\u0432\u043E\u043D\u043A\u0430** \u2014 `GET /call/detail/<callId>?IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER`\n> (\u043E\u0442\u0434\u0430\u0451\u0442 HTML). \u041E\u0433\u0440\u0430\u043D\u0438\u0447\u0435\u043D\u0438\u044F \u0438\u0434\u0435\u043D\u0442\u0438\u0447\u043D\u044B.\n\n---\n\n## 7. \u041A\u0430\u043A \u0440\u0430\u0441\u0448\u0438\u0440\u0438\u0442\u044C (\u043D\u043E\u0432\u044B\u0439 \u0434\u043E\u043C\u0435\u043D: \u043A\u0430\u043B\u0435\u043D\u0434\u0430\u0440\u044C, \u0434\u0438\u0441\u043A, CRM, \u2026)\n\n1. \u0421\u043D\u0438\u043C\u0438 \u0440\u0435\u0430\u043B\u044C\u043D\u044B\u0435 \u0432\u044B\u0437\u043E\u0432\u044B (`docs/reconnaissance.md` \u2014 \u0430\u0432\u0442\u043E-\u0437\u0430\u043F\u0438\u0441\u044C `bun run capture` \u0438\u043B\u0438 HAR \u2192\n   `bun run catalog:draft`). \u0427\u0435\u0440\u043D\u043E\u0432\u0438\u043A `actions.draft.json` \u043D\u0430\u043A\u0430\u043F\u043B\u0438\u0432\u0430\u0435\u0442 **\u0432\u0441\u0435 \u0443\u043D\u0438\u043A\u0430\u043B\u044C\u043D\u044B\u0435 \u043A\u043E\u043C\u0431\u0438\u043D\u0430\u0446\u0438\u0438\n   \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432** \u043D\u0430 \u044D\u043A\u0448\u0435\u043D \u0438 \u043F\u0440\u043E\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 `bodyType` (form/json) \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438.\n2. \u041E\u043F\u0440\u0435\u0434\u0435\u043B\u0438 \u0442\u0440\u0430\u043D\u0441\u043F\u043E\u0440\u0442 \u043F\u043E \u0440\u0430\u0437\u0434\u0435\u043B\u0443 3: \u0435\u0441\u043B\u0438 \u0447\u0435\u0440\u043D\u043E\u0432\u0438\u043A \u043F\u043E\u043A\u0430\u0437\u0430\u043B `"bodyType": "json"` \u2014 \u043F\u0435\u0440\u0435\u043D\u0435\u0441\u0438 \u0435\u0433\u043E \u0432 \u0437\u0430\u043F\u0438\u0441\u044C.\n3. \u0414\u043E\u0431\u0430\u0432\u044C \u0437\u0430\u043F\u0438\u0441\u044C \u0432 `actions.json` (\u043C\u043E\u0436\u0435\u0442 \u0431\u044B\u0442\u044C \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0435\u0439 \u2014 \u043A\u0430\u0442\u0430\u043B\u043E\u0433 \u044D\u0442\u043E \u0434\u043E\u043F\u0443\u0441\u043A\u0430\u0435\u0442). \u041F\u0440\u043E\u0432\u0435\u0440\u044C \u0447\u0435\u0440\u0435\u0437\n   `bitrix_call { name, params }`.\n4. \u0415\u0441\u043B\u0438 \u0443\u0434\u043E\u0431\u043D\u043E \u2014 \u043E\u0431\u0435\u0440\u043D\u0438 \u0432 \u0442\u0438\u043F\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0439 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u0432 `src/tools/register.ts` (\u0441 \u0434\u0435\u0444\u043E\u043B\u0442\u043D\u044B\u043C `select`).\n\n> `actions.json` / `actions.draft.json` \u2014 \u0434\u0430\u043D\u043D\u044B\u0435 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u043E\u0433\u043E \u043F\u043E\u0440\u0442\u0430\u043B\u0430 (gitignored). \u042D\u0442\u043E\u0442 \u0444\u0430\u0439\u043B\n> (`api-notes.md`) \u2014 \u043F\u0435\u0440\u0435\u043D\u043E\u0441\u0438\u043C\u044B\u0435 \u0437\u043D\u0430\u043D\u0438\u044F \u043E \u0441\u0430\u043C\u043E\u043C API; \u0434\u0435\u0440\u0436\u0438 \u0435\u0433\u043E \u0432 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u043E\u043C \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0438 \u043F\u0440\u0438 \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u0438\n> \u043D\u043E\u0432\u044B\u0445 \u043C\u0435\u0442\u043E\u0434\u043E\u0432.\n' : load();
 // src/tools/register.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
 function ok(data) {
   return { content: [{ type: "text", text: JSON.stringify(data) }] };
 }
@@ -25372,7 +25339,7 @@ function registerTools(server, deps) {
   server.registerTool(
     "bitrix_call",
     {
-      description: "\u0412\u044B\u0437\u0432\u0430\u0442\u044C \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u044B\u0439 Bitrix24-\u0432\u044B\u0437\u043E\u0432 \u043F\u043E \u0438\u043C\u0435\u043D\u0438 \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 (read-only). \u0414\u0430\u043D\u043D\u044B\u0435 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u044B \u043D\u0430 \u043C\u043E\u043C\u0435\u043D\u0442 \u0437\u0430\u043F\u0440\u043E\u0441\u0430. \u0418\u043C\u0435\u043D\u0430: " + deps.catalog.names().join(", "),
+      description: "\u0412\u044B\u0437\u0432\u0430\u0442\u044C \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u044B\u0439 Bitrix24-\u0432\u044B\u0437\u043E\u0432 \u043F\u043E \u0438\u043C\u0435\u043D\u0438 \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 (\u0432\u043A\u043B\u044E\u0447\u0430\u044F \u043C\u0443\u0442\u0438\u0440\u0443\u044E\u0449\u0438\u0435 \u2014 \u043A\u0430\u0442\u0430\u043B\u043E\u0433 \u044F\u0432\u043B\u044F\u0435\u0442\u0441\u044F allowlist). \u0414\u0430\u043D\u043D\u044B\u0435 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u044B \u043D\u0430 \u043C\u043E\u043C\u0435\u043D\u0442 \u0437\u0430\u043F\u0440\u043E\u0441\u0430. \u0418\u043C\u0435\u043D\u0430: " + deps.catalog.names().join(", "),
       inputSchema: { name: external_exports.string(), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() }
     },
     async ({ name, params, portal }) => {
@@ -25429,21 +25396,199 @@ function registerTools(server, deps) {
     {
       tool: "bitrix_chat_messages",
       catalogName: "chat.messages",
-      description: "\u0418\u0441\u0442\u043E\u0440\u0438\u044F \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0439 \u0447\u0430\u0442\u0430 \u043F\u043E chatId (\u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E 20 \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u0445; beforeId \u2014 \u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0432\u0433\u043B\u0443\u0431\u044C). chatId \u0438\u0437 bitrix_chats_recent (im.v2).",
+      description: "\u041F\u041E\u0421\u041B\u0415\u0414\u041D\u0418\u0415 N \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0439 \u0447\u0430\u0442\u0430 \u043F\u043E chatId (\u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E 20; im.v2). chatId \u2014 \u0438\u0437 bitrix_chats_recent \u0438\u043B\u0438 \u0438\u0437 \u043E\u0442\u0432\u0435\u0442\u0430 bitrix_chat_load. \u0427\u0442\u043E\u0431\u044B \u043B\u0438\u0441\u0442\u0430\u0442\u044C \u0421\u0422\u0410\u0420\u042B\u0415 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F \u0432\u0433\u043B\u0443\u0431\u044C \u2014 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 bitrix_chat_history: \u044D\u0442\u043E\u0442 \u043C\u0435\u0442\u043E\u0434 (im.v2.Chat.Message.list) \u043E\u0442\u0434\u0430\u0451\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u044E\u044E \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0443 \u0438 \u043D\u0430\u0437\u0430\u0434 \u043F\u043E \u043A\u0443\u0440\u0441\u043E\u0440\u0443 \u041D\u0415 \u043B\u0438\u0441\u0442\u0430\u0435\u0442.",
       inputSchema: {
         chatId: external_exports.union([external_exports.number(), external_exports.string()]),
         limit: external_exports.number().optional(),
-        beforeId: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
         params: external_exports.record(external_exports.unknown()).optional(),
         portal: external_exports.string().optional()
       },
-      // im.v2 param names (this portal's messenger): chatId / limit / filter[lastId]
+      // im.v2.Chat.Message.list returns the latest page only; backward paging lives in
+      // ...Message.tail (bitrix_chat_history). filter[lastId] is not honored here — d22adca7
+      // hit this: beforeId on .list kept returning the same tail. So we don't expose it.
       toParams: (a) => ({
         chatId: a.chatId,
-        limit: a.limit ?? 20,
+        limit: a.limit ?? 20
         // G8: sane default guards against huge histories
-        ...a.beforeId !== void 0 ? { "filter[lastId]": a.beforeId } : {}
       })
+    },
+    {
+      tool: "bitrix_task_get_v2",
+      catalogName: "task.v2.get",
+      description: "\u041A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0437\u0430\u0434\u0430\u0447\u0438 \u0447\u0435\u0440\u0435\u0437 v2-\u043F\u043E\u0434\u0441\u0438\u0441\u0442\u0435\u043C\u0443 scrum-\u0431\u043E\u0440\u0434\u0430 (JSON API). taskId \u2014 id \u0437\u0430\u0434\u0430\u0447\u0438.",
+      inputSchema: { taskId: external_exports.union([external_exports.number(), external_exports.string()]), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      // v2 wraps the id: { task: { id } } — verified by capture (not the flat { task } older notes claimed)
+      toParams: (a) => ({ task: { id: a.taskId } })
+    },
+    {
+      tool: "bitrix_task_scrum_info",
+      catalogName: "task.scrum.info",
+      description: "Scrum-\u0438\u043D\u0444\u043E\u0440\u043C\u0430\u0446\u0438\u044F \u043F\u043E \u0437\u0430\u0434\u0430\u0447\u0435 (\u0441\u043F\u0440\u0438\u043D\u0442, \u044D\u043F\u0438\u043A, story points \u0438 \u0442.\u043F.; JSON API).",
+      inputSchema: { taskId: external_exports.union([external_exports.number(), external_exports.string()]), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ taskId: a.taskId })
+    },
+    {
+      tool: "bitrix_task_files",
+      catalogName: "task.files",
+      description: "\u0424\u0430\u0439\u043B\u044B, \u043F\u0440\u0438\u043A\u0440\u0435\u043F\u043B\u0451\u043D\u043D\u044B\u0435 \u043A \u0437\u0430\u0434\u0430\u0447\u0435(\u0430\u043C) (JSON API). ids \u2014 \u043C\u0430\u0441\u0441\u0438\u0432 id \u0437\u0430\u0434\u0430\u0447.",
+      inputSchema: { ids: external_exports.array(external_exports.union([external_exports.number(), external_exports.string()])).min(1), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ ids: a.ids })
+    },
+    {
+      tool: "bitrix_task_views_count",
+      catalogName: "task.views.count",
+      description: "\u0421\u043A\u043E\u043B\u044C\u043A\u043E \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0435\u0439 \u043F\u0440\u043E\u0441\u043C\u043E\u0442\u0440\u0435\u043B\u0438 \u0437\u0430\u0434\u0430\u0447\u0443 (JSON API).",
+      inputSchema: { taskId: external_exports.union([external_exports.number(), external_exports.string()]), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ task: { id: a.taskId } })
+    },
+    {
+      tool: "bitrix_chat_load",
+      catalogName: "chat.load",
+      description: '\u041E\u0442\u043A\u0440\u044B\u0442\u044C \u0447\u0430\u0442 \u0438 \u043F\u043E\u043B\u0443\u0447\u0438\u0442\u044C \u043F\u0435\u0440\u0432\u044B\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F. \u0410\u0434\u0440\u0435\u0441\u0430\u0446\u0438\u044F: dialogId = ID \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F \u2192 \u041B\u0418\u0427\u041D\u042B\u0419 \u0447\u0430\u0442 1-\u043D\u0430-1; dialogId = "chat"+CHAT_ID (\u0438\u043B\u0438 chatId = CHAT_ID) \u2192 \u0413\u0420\u0423\u041F\u041F\u041E\u0412\u041E\u0419. \u0427\u0430\u0442 \u043F\u043E \u0417\u0410\u0414\u0410\u0427\u0415: bitrix_task_get \u2192 GROUP_ID \u2192 bitrix_project_get \u2192 CHAT_ID. \u041D\u0435 \u0437\u043D\u0430\u0435\u0448\u044C id \u2014 \u043D\u0430\u0439\u0434\u0438 \u0447\u0435\u0440\u0435\u0437 bitrix_chats_recent \u0438\u043B\u0438 bitrix_entity_selector. \u041E\u0442\u0432\u0435\u0442 \u0432\u0435\u0440\u043D\u0451\u0442 \u0447\u0438\u0441\u043B\u043E\u0432\u043E\u0439 chatId \u2014 \u043F\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0439 \u0435\u0433\u043E \u0432 bitrix_chat_history / bitrix_chat_mark_read. messageLimit \u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E 25.',
+      inputSchema: {
+        chatId: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
+        dialogId: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
+        messageLimit: external_exports.number().optional(),
+        params: external_exports.record(external_exports.unknown()).optional(),
+        portal: external_exports.string().optional()
+      },
+      toParams: (a) => ({
+        ...a.chatId !== void 0 ? { chatId: a.chatId } : {},
+        ...a.dialogId !== void 0 ? { dialogId: a.dialogId } : {},
+        ...a.messageLimit !== void 0 ? { messageLimit: a.messageLimit } : {}
+      })
+    },
+    {
+      tool: "bitrix_chat_history",
+      catalogName: "chat.messages.tail",
+      description: "\u041B\u0438\u0441\u0442\u0430\u0442\u044C \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u0447\u0430\u0442\u0430 \u0412\u0413\u041B\u0423\u0411\u042C (\u0441\u0442\u0430\u0440\u044B\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F). beforeId \u2014 \u043C\u0438\u043D\u0438\u043C\u0430\u043B\u044C\u043D\u044B\u0439 id \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F \u0438\u0437 \u0442\u0435\u043A\u0443\u0449\u0435\u0439 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B; \u043F\u043E\u0432\u0442\u043E\u0440\u044F\u0439, \u0443\u043C\u0435\u043D\u044C\u0448\u0430\u044F beforeId, \u0434\u043E \u043D\u0430\u0447\u0430\u043B\u0430 \u0438\u0441\u0442\u043E\u0440\u0438\u0438. limit \u043F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E 25, \u043F\u043E\u0440\u044F\u0434\u043E\u043A \u2014 DESC.",
+      inputSchema: {
+        chatId: external_exports.union([external_exports.number(), external_exports.string()]),
+        beforeId: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
+        limit: external_exports.number().optional(),
+        params: external_exports.record(external_exports.unknown()).optional(),
+        portal: external_exports.string().optional()
+      },
+      toParams: (a) => ({
+        chatId: a.chatId,
+        ...a.beforeId !== void 0 ? { "filter[lastId]": a.beforeId } : {},
+        ...a.limit !== void 0 ? { limit: a.limit } : {}
+      })
+    },
+    {
+      tool: "bitrix_chat_mark_read",
+      catalogName: "chat.message.read",
+      description: "\u26A0 \u041C\u0423\u0422\u0418\u0420\u0423\u042E\u0429\u0418\u0419. \u041F\u043E\u043C\u0435\u0442\u0438\u0442\u044C \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F \u0447\u0430\u0442\u0430 \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u043D\u043D\u044B\u043C\u0438. ids \u2014 \u043C\u0430\u0441\u0441\u0438\u0432 id \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0439; actionUuid \u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044F \u0430\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u0438, \u0435\u0441\u043B\u0438 \u043D\u0435 \u043F\u0435\u0440\u0435\u0434\u0430\u043D.",
+      inputSchema: {
+        chatId: external_exports.union([external_exports.number(), external_exports.string()]),
+        ids: external_exports.array(external_exports.union([external_exports.number(), external_exports.string()])).min(1),
+        actionUuid: external_exports.string().optional(),
+        params: external_exports.record(external_exports.unknown()).optional(),
+        portal: external_exports.string().optional()
+      },
+      toParams: (a) => ({ chatId: a.chatId, ids: a.ids, actionUuid: a.actionUuid ?? randomUUID2() })
+    },
+    {
+      tool: "bitrix_entity_selector",
+      catalogName: "entityselector.load",
+      description: '\u041F\u043E\u0438\u0441\u043A/\u0440\u0435\u0437\u043E\u043B\u0432 \u0441\u0443\u0449\u043D\u043E\u0441\u0442\u0435\u0439 (\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u0438, \u043F\u0440\u043E\u0435\u043A\u0442\u044B, \u0447\u0430\u0442\u044B) \u0447\u0435\u0440\u0435\u0437 entityselector (JSON API). \u041D\u0430\u0439\u0442\u0438 \u0427\u0410\u0422/\u0434\u0438\u0430\u043B\u043E\u0433: dialog={id:"im-chat-search",context:"IM_CHAT_SEARCH",entities:[{id:"im-recent-v2",dynamicLoad:true,dynamicSearch:true}]}. \u041D\u0430\u0439\u0442\u0438 \u041F\u041E\u041B\u042C\u0417\u041E\u0412\u0410\u0422\u0415\u041B\u042F: entities:[{id:"user"}]. \u0421\u0432\u043E\u0431\u043E\u0434\u043D\u044B\u0439 \u0442\u0435\u043A\u0441\u0442\u043E\u0432\u044B\u0439 \u0437\u0430\u043F\u0440\u043E\u0441 \u0441\u0432\u0435\u0440\u044C \u0440\u0435\u0432\u0435\u0440\u0441\u043E\u043C.',
+      inputSchema: { dialog: external_exports.record(external_exports.unknown()), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ dialog: a.dialog })
+    },
+    {
+      tool: "bitrix_recent_load",
+      catalogName: "recent.load",
+      description: '\u041D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u0447\u0430\u0442\u044B \u043F\u043E \u0421\u0415\u041A\u0426\u0418\u0418 (im.v2). section: "tasksTask" \u2014 \u0427\u0410\u0422\u042B \u0417\u0410\u0414\u0410\u0427 (\u043E\u0431\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u044F \u0437\u0430\u0434\u0430\u0447; \u0432 bitrix_chats_recent \u0438\u0445 \u043D\u0435\u0442), "collab"/"collabDefault" \u2014 \u043A\u043E\u043B\u043B\u0430\u0431\u044B, \u0438\u043D\u0430\u0447\u0435 \u043E\u0431\u044B\u0447\u043D\u044B\u0435 \u0434\u0438\u0430\u043B\u043E\u0433\u0438. \u041E\u0442\u0434\u0430\u0451\u0442 chatId/dialogId \u2014 \u0434\u0430\u043B\u044C\u0448\u0435 \u043E\u0442\u043A\u0440\u044B\u0432\u0430\u0439 bitrix_chat_load. \u041B\u0438\u0441\u0442\u0430\u0442\u044C \u0433\u043B\u0443\u0431\u0436\u0435 \u2014 bitrix_recent_tail.',
+      inputSchema: {
+        section: external_exports.string().optional(),
+        limit: external_exports.number().optional(),
+        unread: external_exports.boolean().optional(),
+        parentId: external_exports.union([external_exports.number(), external_exports.string()]).optional(),
+        params: external_exports.record(external_exports.unknown()).optional(),
+        portal: external_exports.string().optional()
+      },
+      toParams: (a) => ({
+        limit: a.limit ?? 50,
+        ...a.section !== void 0 ? { "filter[recentSection]": a.section } : {},
+        ...a.parentId !== void 0 ? { "filter[parentId]": a.parentId } : {},
+        "filter[unread]": a.unread ? "Y" : "N"
+      })
+    },
+    {
+      tool: "bitrix_recent_tail",
+      catalogName: "recent.tail",
+      description: "\u041B\u0438\u0441\u0442\u0430\u0442\u044C \u043D\u0435\u0434\u0430\u0432\u043D\u0438\u0435 \u0412\u0413\u041B\u0423\u0411\u042C (im.v2). lastMessageDate \u2014 ISO-\u0434\u0430\u0442\u0430 \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0435\u0433\u043E \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u0430 \u0442\u0435\u043A\u0443\u0449\u0435\u0439 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B (\u043A\u0443\u0440\u0441\u043E\u0440); section \u2014 \u043A\u0430\u043A \u0432 bitrix_recent_load. \u041F\u043E\u0432\u0442\u043E\u0440\u044F\u0439, \u0441\u0434\u0432\u0438\u0433\u0430\u044F lastMessageDate.",
+      inputSchema: {
+        lastMessageDate: external_exports.string(),
+        section: external_exports.string().optional(),
+        limit: external_exports.number().optional(),
+        unread: external_exports.boolean().optional(),
+        params: external_exports.record(external_exports.unknown()).optional(),
+        portal: external_exports.string().optional()
+      },
+      toParams: (a) => ({
+        limit: a.limit ?? 50,
+        "filter[lastMessageDate]": a.lastMessageDate,
+        ...a.section !== void 0 ? { "filter[recentSection]": a.section } : {},
+        "filter[unread]": a.unread ? "Y" : "N"
+      })
+    },
+    {
+      tool: "bitrix_entity_search",
+      catalogName: "entityselector.search",
+      description: '\u0422\u0415\u041A\u0421\u0422\u041E\u0412\u042B\u0419 \u043F\u043E\u0438\u0441\u043A \u0441\u0443\u0449\u043D\u043E\u0441\u0442\u0435\u0439 \u0447\u0435\u0440\u0435\u0437 entityselector (JSON API). query \u2014 \u0441\u0442\u0440\u043E\u043A\u0430 \u043F\u043E\u0438\u0441\u043A\u0430. \u041F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E \u0438\u0449\u0435\u0442 \u0447\u0430\u0442\u044B/\u0434\u0438\u0430\u043B\u043E\u0433\u0438 (context IM_CHAT_SEARCH); section: "tasksTask" \u2014 \u0441\u0440\u0435\u0434\u0438 \u0447\u0430\u0442\u043E\u0432 \u0437\u0430\u0434\u0430\u0447, "default" \u2014 \u0441\u0440\u0435\u0434\u0438 \u0432\u0441\u0435\u0445. \u0414\u043B\u044F \u0438\u043D\u044B\u0445 \u0441\u0443\u0449\u043D\u043E\u0441\u0442\u0435\u0439 \u043F\u0435\u0440\u0435\u0434\u0430\u0439 \u0441\u0432\u043E\u0439 dialog \u0446\u0435\u043B\u0438\u043A\u043E\u043C.',
+      inputSchema: {
+        query: external_exports.string(),
+        section: external_exports.string().optional(),
+        dialog: external_exports.record(external_exports.unknown()).optional(),
+        params: external_exports.record(external_exports.unknown()).optional(),
+        portal: external_exports.string().optional()
+      },
+      toParams: (a) => ({
+        dialog: a.dialog ?? {
+          id: "im-chat-search",
+          context: "IM_CHAT_SEARCH",
+          entities: [{ id: "im-recent-v2", dynamicLoad: true, dynamicSearch: true, options: { searchRecentSection: a.section ?? "default", parentId: 0 } }],
+          preselectedItems: [],
+          clearUnavailableItems: false
+        },
+        searchQuery: { query: a.query, queryWords: [a.query] }
+      })
+    },
+    {
+      tool: "bitrix_chat_get_dialog_id",
+      catalogName: "chat.dialogId",
+      description: '\u0420\u0435\u0437\u043E\u043B\u0432 dialogId \u0447\u0430\u0442\u0430 \u043F\u043E externalId (im.v2). \u041D\u0430\u043F\u0440. externalId "sg"+<groupId> \u2192 dialogId \u0447\u0430\u0442\u0430 \u0441\u043E\u0446\u0433\u0440\u0443\u043F\u043F\u044B/\u043F\u0440\u043E\u0435\u043A\u0442\u0430. \u0417\u0430\u0442\u0435\u043C \u043E\u0442\u043A\u0440\u044B\u0432\u0430\u0439 \u0447\u0435\u0440\u0435\u0437 bitrix_chat_load.',
+      inputSchema: { externalId: external_exports.string(), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ externalId: a.externalId })
+    },
+    {
+      tool: "bitrix_chat_read_all",
+      catalogName: "chat.read.all",
+      description: "\u26A0 \u041C\u0423\u0422\u0418\u0420\u0423\u042E\u0429\u0418\u0419. \u041F\u043E\u043C\u0435\u0442\u0438\u0442\u044C \u0412\u0421\u0415 \u0447\u0430\u0442\u044B \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u043D\u043D\u044B\u043C\u0438 (im.v2). \u041F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u043E\u0432 \u043D\u0435\u0442.",
+      inputSchema: { params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: () => ({})
+    },
+    {
+      tool: "bitrix_task_subtasks",
+      catalogName: "task.subtasks",
+      description: "\u041F\u043E\u0434\u0437\u0430\u0434\u0430\u0447\u0438 \u0437\u0430\u0434\u0430\u0447\u0438 (v2 relations, JSON API). taskId \u2014 id \u0440\u043E\u0434\u0438\u0442\u0435\u043B\u044F. navigation.size \u0443\u043F\u0440\u0430\u0432\u043B\u044F\u0435\u0442 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0435\u0439.",
+      inputSchema: { taskId: external_exports.union([external_exports.number(), external_exports.string()]), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ taskId: a.taskId, withIds: true, withCompleted: true, withSubTasks: true, navigation: { size: 10 } })
+    },
+    {
+      tool: "bitrix_task_related",
+      catalogName: "task.related",
+      description: "\u0421\u0432\u044F\u0437\u0430\u043D\u043D\u044B\u0435 \u0437\u0430\u0434\u0430\u0447\u0438 (v2 relations, JSON API). taskId \u2014 id \u0437\u0430\u0434\u0430\u0447\u0438.",
+      inputSchema: { taskId: external_exports.union([external_exports.number(), external_exports.string()]), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ taskId: a.taskId, withIds: true, withCompleted: true, withSubTasks: true, navigation: { size: 10 } })
+    },
+    {
+      tool: "bitrix_user_get",
+      catalogName: "im.user.get",
+      description: "\u041A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F \u043C\u0435\u0441\u0441\u0435\u043D\u0434\u0436\u0435\u0440\u0430 \u043F\u043E id (\u0438\u043C\u044F, \u0430\u0432\u0430\u0442\u0430\u0440, \u0441\u0442\u0430\u0442\u0443\u0441). userId \u2014 id \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F.",
+      inputSchema: { userId: external_exports.union([external_exports.number(), external_exports.string()]), params: external_exports.record(external_exports.unknown()).optional(), portal: external_exports.string().optional() },
+      toParams: (a) => ({ ID: a.userId })
     }
   ];
   const available = new Set(deps.catalog.names());
@@ -25596,7 +25741,7 @@ function buildManifest(config2) {
     manifest_version: 3,
     name: "Bitrix24 MCP Bridge",
     version: "0.1.0",
-    description: "\u041E\u0442\u0434\u0430\u0451\u0442 \u0434\u0430\u043D\u043D\u044B\u0435 \u0442\u0435\u043A\u0443\u0449\u0435\u0439 \u0441\u0435\u0441\u0441\u0438\u0438 Bitrix24 \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u043C\u0443 MCP-\u0441\u0435\u0440\u0432\u0435\u0440\u0443 (read-only).",
+    description: "\u041E\u0442\u0434\u0430\u0451\u0442 \u0442\u0435\u043A\u0443\u0449\u0443\u044E \u0441\u0435\u0441\u0441\u0438\u044E Bitrix24 \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u043C\u0443 MCP-\u0441\u0435\u0440\u0432\u0435\u0440\u0443 (\u0447\u0442\u0435\u043D\u0438\u0435 \u0438 \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u0435 \u0432\u044B\u0437\u043E\u0432\u043E\u0432 \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430).",
     host_permissions: matches,
     content_scripts: [
       { matches, js: ["connector.js"], world: "ISOLATED", run_at: "document_idle" },

package/docs/api-notes.md CHANGED Viewed

@@ -12,15 +12,29 @@
 ## 1. Как вызывать
-- **Типизированные инструменты** (`bitrix_tasks_list`, `bitrix_task_get`, `bitrix_projects_list`,
-  `bitrix_project_get`, `bitrix_chats_recent`, `bitrix_chat_messages`) — с разумными дефолтами.
-  Точная выборка — через опциональный аргумент **`params`** (нативный формат Bitrix), он мержится
-  **последним** и перекрывает дефолты. Подсказки по параметрам есть в описании каждого инструмента.
 - **`bitrix_call { name, params }`** — универсальный вызов любого разрешённого имени из каталога
-  (`actions.json`). Тот же `params`-механизм.
-- **`bitrix_help`** — этот же гайд, отдаётся через MCP (инструмент + resource `bitrix://api-notes`),
-  чтобы любой агент разобрался без доступа к репозиторию. Источник — **этот файл** (`docs/api-notes.md`).
-- Всё **read-only**: мутирующие вызовы (`…add/update/delete/set/complete/…`) отвергаются при загрузке каталога.
+  (`actions.json`). `params` — нативный формат Bitrix (см. раздел 3). Каталог может включать
+  мутирующие вызовы; allowlist (`actions.json`) — единственная граница, не режим чтения.
+- **Типизированные инструменты** — обёртки с разумными дефолтами над каталогом. Точная выборка — через
+  опциональный `params`, он мержится **последним** и перекрывает дефолты. Регистрируются только те,
+  чьё имя есть в каталоге (`actions.json`); иначе инструмент пропускается. Текущий набор:
+  - Задачи: `bitrix_tasks_list`, `bitrix_task_get`, `bitrix_task_get_v2` (v2/JSON),
+    `bitrix_task_scrum_info`, `bitrix_task_files`, `bitrix_task_views_count`,
+    `bitrix_task_subtasks` (подзадачи), `bitrix_task_related` (связанные).
+  - Проекты: `bitrix_projects_list`, `bitrix_project_get`.
+  - Чаты: `bitrix_chats_recent`, `bitrix_recent_load` (недавние по секции — в т.ч. `tasksTask` =
+    чаты задач), `bitrix_recent_tail` (листать недавние вглубь), `bitrix_chat_load` (открыть по
+    `dialogId`/`chatId`), `bitrix_chat_messages`, `bitrix_chat_history` (листать вглубь по `beforeId`),
+    `bitrix_chat_get_dialog_id` (dialogId по externalId), `bitrix_chat_mark_read` (⚠ мутирующий),
+    `bitrix_chat_read_all` (⚠ мутирующий).
+  - Люди/поиск: `bitrix_user_get` (карточка юзера), `bitrix_entity_selector` (загрузка селектора),
+    `bitrix_entity_search` (текстовый поиск чатов/сущностей через `ui.entityselector.doSearch`).
+  Любое имя каталога всегда доступно и напрямую через `bitrix_call { name, params }`.
+- **`bitrix_help`** — этот же гайд, отдаётся через MCP (инструмент + resource `bitrix://api-notes`).
+  Источник — **этот файл** (`docs/api-notes.md`).
+Полный список имён каталога отдаёт `bitrix_call` в своём описании (`deps.catalog.names()`).
 ---
@@ -35,44 +49,83 @@ Ajax-контроллеры (`/bitrix/services/main/ajax.php`) отвечают
 ```
 - Успех определяется `status:"success"` и/или **пустым** `errors`. Непустой `errors` / `status:"error"` /
-  top-level `error` — реальная ошибка.
+  top-level `error` — реальная ошибка (мост маппит это в `ok:false`).
 - REST-эндпоинты (`/rest/*.json`) отвечают иначе: `{ "result": …, "next", "total", "time" }` — без `errors`.
 ---
-## 3. Транспорт и конвенции параметров (различаются по методу!)
+## 3. Транспорт: form vs json (различается по методу!)
-Мост шлёт `application/x-www-form-urlencoded` со **свежим `sessid`** в теле; вложенность кодируется
-PHP-стилем (`filter[STATUS]=2`, `select[0]=ID`). Объект в `params` рекурсивно разворачивается в такие ключи.
+У каждой записи каталога есть **`bodyType`** — как мост кодирует тело:
-| Метод (action / endpoint) | Транспорт | Где `select`/`filter`/`order` | Пагинация |
-|---|---|---|---|
-| `tasks.task.list` | ajax, форма | **верхний уровень**: `select[]`, `filter{}`, `order{}` | `start` (сдвиг, шаг 50) |
-| `tasks.task.get` | ajax, форма | верхний уровень: `taskId`, `select[]` | — |
-| `socialnetwork.api.workgroup.list` | ajax, форма | **верхний уровень**: `select[]`, `order{}`, `filter{}` | (nav — не проверено) |
-| `socialnetwork.api.workgroup.get` | ajax, форма | **обёрнуто**: `params[groupId]`, `params[select][]` | — |
-| `im.v2.Chat.Message.list` | ajax, форма | плоско: `chatId`, `limit`, `filter[lastId]` | `filter[lastId]` + `limit` |
-| `im.recent.list` (`/rest/im.recent.list.json`) | rest, форма | плоско: `LIMIT`, `SKIP_OPENLINES`, `UNREAD_ONLY`, … | `LIMIT` |
+- **`bodyType: "form"`** (по умолчанию) — `application/x-www-form-urlencoded`; вложенность кодируется
+  PHP-стилем (`filter[STATUS]=2`, `select[0]=ID`). Объект в `params` рекурсивно разворачивается в такие
+  ключи. Классические `tasks.task.*`, мессенджер `im.v2.*`, REST — всё это форма.
+- **`bodyType: "json"`** — тело уходит как `JSON.stringify(params)` с `Content-Type: application/json`.
+  Так работают **`tasks.v2.*`** (напр. `tasks.v2.Task.get` ждёт `{"task":{"id":N}}`) и `ui.entityselector.*`.
+  `params` при этом сохраняет вложенную структуру как есть (не разворачивается в bracket-ключи).
+> Историческая заметка: раньше мост умел только форму, и `tasks.v2.*` были непригодны. Теперь
+> поддержаны — в записи каталога ставь `"bodyType": "json"`, и мост отправит их корректно.
-⚠️ **`tasks.v2.*` (напр. `tasks.v2.Task.get`) шлёт JSON-тело** (`{"task":{"id":N}}`), а мост кодирует
-форму — **не используй `tasks.v2.*`**, бери классические `tasks.task.*`. Мессенджер `im.v2.*` при этом
-принимает обычную форму (это разные подсистемы, несмотря на общий префикс «v2»).
+**CSRF / sessid:** мост всегда шлёт заголовок **`X-Bitrix-Csrf-Token: <sessid>`** (свежий
+`BX.bitrix_sessid()`). Form-тела дополнительно несут `sessid` полем в теле (legacy REST это требует);
+JSON-тела несут sessid **только** в заголовке. Ответ `invalid_csrf`/`invalid_authentication` = сессия
+протухла (перелогинься в браузере).
-CSRF: контроллеры требуют `sessid` в теле — расширение подставляет свежий `BX.bitrix_sessid()`
-автоматически. Ответ `invalid_csrf`/`invalid_authentication` = сессия протухла (перелогинься в браузере).
+| Метод (action / endpoint) | bodyType | Где `select`/`filter`/`order` | Пагинация |
+|---|---|---|---|
+| `tasks.task.list` | form | **верхний уровень**: `select[]`, `filter{}`, `order{}` | `start` (сдвиг, шаг 50) |
+| `tasks.task.get` | form | верхний уровень: `taskId`, `select[]` | — |
+| `tasks.v2.Task.get` | **json** | `{"task": {"id": N}}` | — |
+| `tasks.v2.Scrum.getTaskInfo` | **json** | `{"taskId": N}` | — |
+| `tasks.v2.File.listObjects` | **json** | `{"ids": [N,…]}` | — |
+| `tasks.v2.Task.View.User.count` | **json** | `{"task": {"id": N}}` | — |
+| `tasks.v2.Task.Relation.Child.list` | **json** | `{"taskId": N, "withIds":true, "navigation":{"size":N}}` | `navigation` |
+| `tasks.v2.Task.Relation.Related.list` | **json** | `{"taskId": N, …}` (как Child) | `navigation` |
+| `socialnetwork.api.workgroup.list` | form | **верхний уровень**: `select[]`, `order{}`, `filter{}` | (nav — не проверено) |
+| `socialnetwork.api.workgroup.get` | form | **обёрнуто**: `params[groupId]`, `params[select][]` | — |
+| `/rest/im.recent.list.json` | form (rest) | плоско: `LIMIT`, `SKIP_OPENLINES`, `UNREAD_ONLY`, … | `LIMIT` |
+| `/rest/im.user.get.json` | form (rest) | плоско: `ID` | — |
+| `im.v2.Recent.load` | form | плоско: `limit`, `filter[recentSection]`, `filter[unread]`, `filter[parentId]` | `im.v2.Recent.tail` |
+| `im.v2.Recent.tail` | form | плоско: `limit`, `filter[lastMessageDate]` (курсор), `filter[recentSection]` | `filter[lastMessageDate]` |
+| `im.v2.Chat.load` | form | плоско: `dialogId`\|`chatId`, `messageLimit` | — |
+| `im.v2.Chat.getDialogId` | form | плоско: `externalId` | — |
+| `im.v2.Chat.Message.list` | form | плоско: `chatId`, `limit` | только последняя страница — назад **не листает**, используй `.tail` |
+| `im.v2.Chat.Message.tail` | form | плоско: `chatId`, `limit`, `filter[lastId]`, `order[id]` | **см. раздел 6** |
+| `im.v2.Chat.Message.read` | form | плоско: `chatId`, `ids[]`, `actionUuid` | — (мутирующий) |
+| `im.v2.Chat.readAll` | form | без параметров | — (мутирующий) |
+| `ui.entityselector.load` | **json** | `{"dialog": {entities,preselectedItems,…}}` | — |
+| `ui.entityselector.doSearch` | **json** | `{"dialog": {…}, "searchQuery": {"query": "...", "queryWords": ["..."]}}` | — |
 ---
-## 4. Триада: инструмент → action → параметры
+## 4. Каталог: имя → action → параметры
-| Инструмент | Каталог (`actions.json`) | action / endpoint | Ключевые params |
+| Имя (`actions.json`) | action / endpoint | bodyType | Ключевые params |
 |---|---|---|---|
-| `bitrix_tasks_list` | `tasks.list` | `tasks.task.list` | `filter{RESPONSIBLE_ID,REAL_STATUS,GROUP_ID,…}`, `select[]`, `order{}`, `start` |
-| `bitrix_task_get` | `task.get` | `tasks.task.get` | `taskId`, `select[]` |
-| `bitrix_projects_list` | `projects.list` | `socialnetwork.api.workgroup.list` | `select[]`, `order{}`, `filter{}` |
-| `bitrix_project_get` | `projects.get` | `socialnetwork.api.workgroup.get` | `params[groupId]`, `params[select][]` |
-| `bitrix_chats_recent` | `chats.recent` | `/rest/im.recent.list.json` | `LIMIT`, `UNREAD_ONLY`, `SKIP_OPENLINES` |
-| `bitrix_chat_messages` | `chat.messages` | `im.v2.Chat.Message.list` | `chatId`, `limit`, `filter[lastId]` |
+| `tasks.list` | `tasks.task.list` | form | `filter{RESPONSIBLE_ID,REAL_STATUS,GROUP_ID,…}`, `select[]`, `order{}`, `start` |
+| `task.get` | `tasks.task.get` | form | `taskId`, `select[]` |
+| `task.v2.get` | `tasks.v2.Task.get` | json | `task.id` (id задачи) |
+| `task.scrum.info` | `tasks.v2.Scrum.getTaskInfo` | json | `taskId` |
+| `task.files` | `tasks.v2.File.listObjects` | json | `ids` (массив id) |
+| `task.views.count` | `tasks.v2.Task.View.User.count` | json | `task.id` (id задачи) |
+| `task.subtasks` | `tasks.v2.Task.Relation.Child.list` | json | `taskId`, `navigation{size}` |
+| `task.related` | `tasks.v2.Task.Relation.Related.list` | json | `taskId`, `navigation{size}` |
+| `projects.list` | `socialnetwork.api.workgroup.list` | form | `select[]`, `order{}`, `filter{}` |
+| `projects.get` | `socialnetwork.api.workgroup.get` | form | `params[groupId]`, `params[select][]` |
+| `chats.recent` | `/rest/im.recent.list.json` | form | `LIMIT`, `UNREAD_ONLY`, `SKIP_OPENLINES` |
+| `recent.load` | `im.v2.Recent.load` | form | `filter[recentSection]` (`tasksTask`/`collab`/…), `limit`, `filter[unread]` |
+| `recent.tail` | `im.v2.Recent.tail` | form | `filter[lastMessageDate]`, `filter[recentSection]`, `limit` |
+| `chat.load` | `im.v2.Chat.load` | form | `dialogId`\|`chatId`, `messageLimit` |
+| `chat.dialogId` | `im.v2.Chat.getDialogId` | form | `externalId` (напр. `"sg"+groupId`) |
+| `chat.messages` | `im.v2.Chat.Message.list` | form | `chatId`, `limit` (последние; вглубь — `chat.messages.tail`) |
+| `chat.messages.tail` | `im.v2.Chat.Message.tail` | form | `chatId`, `filter[lastId]`, `order[id]`, `limit` |
+| `chat.message.read` | `im.v2.Chat.Message.read` | form | `chatId`, `ids[0]`, `actionUuid` |
+| `chat.read.all` | `im.v2.Chat.readAll` | form | — (⚠ мутирующий) |
+| `im.user.get` | `/rest/im.user.get.json` | form | `ID` |
+| `entityselector.load` | `ui.entityselector.load` | json | `dialog` (объект) |
+| `entityselector.search` | `ui.entityselector.doSearch` | json | `dialog`, `searchQuery{query,queryWords}` |
 ---
@@ -85,6 +138,10 @@ CSRF: контроллеры требуют `sessid` в теле — расши
 Статусы задачи (`STATUS`): `1` Новая · `2` Ждёт выполнения · `3` Выполняется · `4` Ждёт контроля ·
 `5` Завершена · `6` Отложена · `7` Отклонена.
+**Задача v2** (`tasks.v2.*`): id задачи передаётся вложенно — **`{"task": {"id": N}}`** (у `Task.get` и
+`Task.View.User.count`), а у `Scrum.getTaskInfo` и `Relation.*` — плоско `{"taskId": N}`. Это отдельная
+подсистема scrum-борда; структуру ответа сверь реверсом — в захвате видны только параметры запроса.
 **Группа/проект — список** (`workgroup.list`, camelCase в ответе): `ID`, `NAME`, `DESCRIPTION`,
 `NUMBER_OF_MEMBERS`, `OWNER_ID`, `DATE_CREATE`, `PROJECT` (Y/N), `TYPE`.
 **Группа — карточка** (`workgroup.get`): плюс `OWNER_DATA`, `SUBJECT_DATA`, `MEMBERS[]`,
@@ -92,12 +149,26 @@ CSRF: контроллеры требуют `sessid` в теле — расши
 **Недавний чат** (`im.recent.list`): `chat_id`, `title`, `type`, `message{id,text,date,author_id}`,
 `last_id`, `unread`, `pinned`, `user{…}`, `chat{…}`.
-**Сообщение** (`im.v2.Chat.Message.list`): `id`, `chatId`, `authorId`, `date`, `text`, `params`, `viewed`.
+**Недавние по секции** (`im.v2.Recent.load`): фильтр `filter[recentSection]` — `default` (обычные
+диалоги), **`tasksTask` (чаты задач)**, `collab`/`collabDefault` (коллабы). Листание вглубь —
+`im.v2.Recent.tail` с курсором `filter[lastMessageDate]` (ISO-дата последнего элемента страницы).
+**Карточка юзера** (`im.user.get`): `id`, `name`, `first_name`, `last_name`, `avatar`, `work_position`,
+`gender`, `status`, `online` — резолв автора сообщения (`authorId`) в имя.
+**Сообщение** (`im.v2.Chat.Message.*`): `id`, `chatId`, `authorId`, `date`, `text`, `params`, `viewed`.
 Ответ также несёт `users[]` (участники), `additionalMessages[]`, `hasPrevPage`/`hasNextPage`.
+`chatId` берётся из `im.recent.list` (`chat_id`) или из `workgroup.get` (`CHAT_ID`/`DIALOG_ID`).
+**Адресация чата (`chat.load`): `dialogId` vs `chatId`.** `chat.load` принимает любой из двух:
+- `dialogId` = **ID пользователя** (число, напр. `11`) → **личный чат 1-на-1** с этим пользователем.
+- `dialogId` = **`"chat"+CHAT_ID`** (напр. `"chat7111"`) → **групповой чат** (проекта/задачи/канала).
+- `chatId` = числовой `CHAT_ID` — то же, что групповой `dialogId`, но без префикса.
+Ответ `chat.load` возвращает числовой `chatId` — используй его дальше для `chat.messages` /
+`chat.messages.tail` (листание вглубь) и `chat.message.read` (эти три работают по `chatId`, не по `dialogId`).
 ---
-## 6. Примеры точных выборок
+## 6. Примеры вызовов
 ```jsonc
 // открытые задачи ответственного 55, по дедлайну, вторая страница
@@ -107,24 +178,142 @@ bitrix_tasks_list { "params": { "filter": {"RESPONSIBLE_ID":55,"REAL_STATUS":2},
 // карточка задачи с расширенным набором полей
 bitrix_task_get { "taskId": 4229, "params": { "select": ["ID","TITLE","DESCRIPTION","TAGS","TIME_ESTIMATE"] } }
-// проекты, отсортированные по дате создания
-bitrix_projects_list { "params": { "order": {"DATE_CREATE":"desc"} } }
+// карточка задачи через v2-подсистему (JSON-тело; id вложен в task)
+bitrix_task_get_v2 { "taskId": 4229 }                       // → { "task": { "id": 4229 } }
+bitrix_call { "name": "task.v2.get", "params": { "task": { "id": 4229 } } }
-// полная карточка группы
+// файлы задачи и счётчик просмотров (v2, JSON-тело); подзадачи/связанные
+bitrix_call { "name": "task.files", "params": { "ids": [4229] } }
+bitrix_call { "name": "task.views.count", "params": { "task": { "id": 4229 } } }
+bitrix_task_subtasks { "taskId": 4229 }
+bitrix_task_related  { "taskId": 4229 }
+// проекты по дате создания; полная карточка группы
+bitrix_projects_list { "params": { "order": {"DATE_CREATE":"desc"} } }
 bitrix_project_get { "groupId": 15 }
-// глубже в историю чата
-bitrix_chat_messages { "chatId": 485, "limit": 50, "beforeId": 1936695 }
+// открыть чат (первые сообщения)
+bitrix_chat_load { "chatId": 485, "messageLimit": 50 }
+// ЛИСТАНИЕ ИСТОРИИ ВГЛУБЬ (старые сообщения): beforeId = минимальный id сообщения
+// из текущей страницы. Повторяй, уменьшая beforeId, до начала истории (order DESC — дефолт).
+bitrix_chat_history { "chatId": 485, "beforeId": 1861279 }
+// пометить сообщения прочитанными (МУТИРУЮЩИЙ). actionUuid генерируется автоматически.
+bitrix_chat_mark_read { "chatId": 40271, "ids": [1884131] }
 ```
+### 6.1. Сценарий: чат с конкретным пользователем
+Личный чат 1-на-1 адресуется `dialogId` = **ID пользователя**. Id берётся из задачи
+(`RESPONSIBLE_ID`/`CREATED_BY`), из `bitrix_chats_recent`, либо резолвится поиском (§6.3).
+```jsonc
+// 1) открыть личный чат с пользователем 11 → в ответе будет числовой chatId
+bitrix_chat_load { "dialogId": 11 }
+// 2) листать его историю вглубь по chatId из ответа шага 1
+bitrix_chat_history { "chatId": 485, "beforeId": 1861279 }
+```
+### 6.2. Сценарий: обсуждение (чат) конкретной задачи
+У каждой задачи есть свой im-чат-обсуждение. Два пути найти его `chatId`:
+**А. Через список чатов задач (прямой).** `im.v2.Recent.load` с секцией `tasksTask` отдаёт чаты задач
+(в `bitrix_chats_recent` / `/rest/im.recent.list` их НЕТ). Листать вглубь — `bitrix_recent_tail`.
+```jsonc
+bitrix_recent_load { "section": "tasksTask" }           // → чаты задач с chatId/dialogId
+bitrix_recent_tail { "section": "tasksTask", "lastMessageDate": "2026-06-29T17:25:38+03:00" }
+// открыть найденный чат и листать историю
+bitrix_chat_load    { "dialogId": "chat38849" }         // или { "chatId": 38849 }
+bitrix_chat_history { "chatId": 38849, "beforeId": 1722353 }
+```
+**Б. Поиском по названию задачи** — `bitrix_entity_search` с секцией `tasksTask`:
+```jsonc
+bitrix_entity_search { "query": "трекер", "section": "tasksTask" }
+```
+**Чат ПРОЕКТА задачи** (обсуждение группы, не самой задачи) — через `GROUP_ID`:
+```jsonc
+bitrix_task_get    { "taskId": 4229, "params": { "select": ["ID","GROUP_ID"] } }
+bitrix_project_get { "groupId": 15 }                    // отдаёт CHAT_ID / DIALOG_ID
+bitrix_chat_load   { "dialogId": "chat7111" }
+bitrix_chat_get_dialog_id { "externalId": "sg15" }      // либо резолв dialogId соцгруппы напрямую
+```
+### 6.3. Сценарий: поиск чата / пользователя
+Текстовый поиск — `bitrix_entity_search` (обёртка над `ui.entityselector.doSearch`): сам собирает
+диалог `IM_CHAT_SEARCH` и `searchQuery` из строки:
+```jsonc
+bitrix_entity_search { "query": "дмитрий" }                        // среди всех чатов/диалогов
+bitrix_entity_search { "query": "трекер", "section": "tasksTask" } // среди чатов задач
+```
+Быстрый путь без поиска — недавние чаты и фильтрация на стороне агента; карточка автора по id:
+```jsonc
+bitrix_chats_recent { }                        // сопоставь по title / user
+bitrix_recent_load  { "section": "tasksTask" }
+bitrix_user_get     { "userId": 11 }           // резолв authorId → имя
+```
+### 6.4. Легаси-комментарии задачи (HTML-поддомен — пока НЕ в мосте)
+У задач два независимых фида обсуждения:
+- **im.v2-чат** — структурный JSON, читается уже сейчас (§6.2); обычно этого достаточно.
+- **Форумные легаси-комментарии** — рендерятся как **HTML** в side-slider'е. Это отдельный
+  «HTML-поддомен» внутреннего API, который **текущий мост не поддерживает** (блокеры ниже).
+**Как грузятся (реверс).** Первая страница — GET HTML-страницы iframe (сервер тут же минтит подпись):
+```
+GET /task/comments/<taskId>/?IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER   → HTML (комментарии + signedParameters)
+```
+Листание — POST компонентного ajax (форма, отдаёт HTML-фрагмент):
+```
+POST /bitrix/services/main/ajax.php?mode=class&c=bitrix:forum.comments&action=navigateComment
+form: AJAX_POST=Y, ENTITY_XML_ID=TASK_<taskId>, taskId=<taskId>, MODE=LIST,
+      FILTER[<ID]=<курсор: id, ДО которого грузить старые>, PAGEN_1=1,
+      signedParameters=<подписанный blob>, IFRAME=Y, IFRAME_TYPE=SIDE_SLIDER
+headers: bx-ajax: true, x-bitrix-site-id: s1 (плюс обычный X-Bitrix-Csrf-Token)
+```
+`signedParameters` — base64 PHP-массива + HMAC-подпись сервера; кодирует
+`FORUM_ID, ENTITY_TYPE=TK, ENTITY_ID=<taskId>, ENTITY_XML_ID=TASK_<taskId>, …`. **Подделать нельзя** —
+берётся из HTML первой страницы.
+**Почему пока не в каталоге (3 блокера):**
+1. Мост парсит ответ только как JSON (`extension/src/connector.ts` → `resp.json()`) — HTML бросит исключение.
+2. Path-параметр в URL (`/task/comments/<taskId>/`) — записи каталога статичны, шаблонов пути нет.
+3. `signedParameters` + заголовки `bx-ajax`/`x-bitrix-site-id` — нужен предварительный GET HTML-страницы.
+**Чтобы подключить** (будущая работа): научить мост возвращать text/HTML при не-JSON ответе и
+поддержать path-шаблон эндпоинта; затем обёртка `bitrix_task_comments { taskId }` (GET первой
+страницы), а листание — через `navigateComment` с выпарсенным `signedParameters`.
+> Тот же HTML-поддомен: **детали звонка** — `GET /call/detail/<callId>?IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER`
+> (отдаёт HTML). Ограничения идентичны.
 ---
 ## 7. Как расширить (новый домен: календарь, диск, CRM, …)
-1. Сними реальные вызовы (`docs/reconnaissance.md` — авто-запись `bun run capture` или HAR).
-2. Определи транспорт и форму параметров по разделу 3 (сверься с `sampleParams` из черновика).
-3. Добавь запись в `actions.json` (только read-only). Проверь через `bitrix_call { name, params }`.
+1. Сними реальные вызовы (`docs/reconnaissance.md` — авто-запись `bun run capture` или HAR →
+   `bun run catalog:draft`). Черновик `actions.draft.json` накапливает **все уникальные комбинации
+   параметров** на экшен и проставляет `bodyType` (form/json) автоматически.
+2. Определи транспорт по разделу 3: если черновик показал `"bodyType": "json"` — перенеси его в запись.
+3. Добавь запись в `actions.json` (может быть мутирующей — каталог это допускает). Проверь через
+   `bitrix_call { name, params }`.
 4. Если удобно — оберни в типизированный инструмент в `src/tools/register.ts` (с дефолтным `select`).
-> `actions.json` — данные конкретного портала (gitignored). Этот файл (`api-notes.md`) — переносимые
-> знания о самом API; держи его в актуальном состоянии при добавлении новых методов.
+> `actions.json` / `actions.draft.json` — данные конкретного портала (gitignored). Этот файл
+> (`api-notes.md`) — переносимые знания о самом API; держи его в актуальном состоянии при добавлении
+> новых методов.

package/extension/dist/connector.js CHANGED Viewed

@@ -12,8 +12,11 @@
     return out.toString();
   }
   function buildRequest(origin, req, sessid) {
-    let q = req.action ? `?action=${encodeURIComponent(req.action)}` : "", url = `${origin}${req.endpoint}${q}`, body = encodeForm({ ...req.params, sessid });
-    return { url, body };
+    let q = req.action ? `?action=${encodeURIComponent(req.action)}` : "", url = `${origin}${req.endpoint}${q}`;
+    if (req.bodyType === "json")
+      return { url, body: JSON.stringify(req.params), contentType: "application/json" };
+    let body = encodeForm({ ...req.params, sessid });
+    return { url, body, contentType: "application/x-www-form-urlencoded" };
   }
   function interpret(json) {
     let list = json && (Array.isArray(json.errors) ? json.errors : json.error ? [{ code: json.error }] : []), hasErrors = Array.isArray(list) && list.length > 0;
@@ -72,10 +75,11 @@
   async function handleCall(req) {
     let sessid = await freshSessid();
     if (!sessid) return { ok: !1, error: "session context not ready \u2014 open a normal Bitrix24 portal tab" };
-    let { url, body } = buildRequest(ORIGIN, req, sessid), init = {
+    let { url, body, contentType } = buildRequest(ORIGIN, req, sessid), init = {
       method: req.method,
       credentials: "include",
-      headers: { "Content-Type": "application/x-www-form-urlencoded" }
+      // sessid rides the CSRF header for all ajax (v2 form + json); form bodies also carry it inline.
+      headers: { "Content-Type": contentType, "X-Bitrix-Csrf-Token": sessid }
     }, finalUrl = url;
     req.method === "POST" ? init.body = body : finalUrl += (url.includes("?") ? "&" : "?") + body;
     let json = await (await fetch(finalUrl, init)).json();

package/extension/dist/connector.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/bridge-core.ts", "../src/bridge-protocol.ts", "../src/connector.ts"],
-  "sourcesContent": ["// Pure, browser-agnostic \u2014 unit-tested.\n\n// Wire types come from the shared single source; re-exported so downstream\n// extension modules keep importing them from here.\nimport type { CallRequest } from \"../../shared/wire.ts\";\nexport type { CallRequest, CapturedEntry } from \"../../shared/wire.ts\";\n\n// Extension-only: the shape handleCall returns to the bridge (not a wire message).\nexport interface InterpretResult {\n  ok: boolean;\n  data?: unknown;\n  error?: string;\n}\n\nexport function encodeForm(params: Record<string, unknown>): string {\n  const out = new URLSearchParams();\n  const add = (key: string, val: unknown): void => {\n    if (val === null || val === undefined) return;\n    if (Array.isArray(val)) val.forEach((v, i) => add(`${key}[${i}]`, v));\n    else if (typeof val === \"object\") for (const [k, v] of Object.entries(val)) add(`${key}[${k}]`, v);\n    else out.set(key, String(val));\n  };\n  for (const [k, v] of Object.entries(params)) add(k, v);\n  return out.toString();\n}\n\nexport function buildRequest(\n  origin: string,\n  req: CallRequest,\n  sessid: string,\n): { url: string; body: string } {\n  const q = req.action ? `?action=${encodeURIComponent(req.action)}` : \"\";\n  const url = `${origin}${req.endpoint}${q}`;\n  const body = encodeForm({ ...req.params, sessid });\n  return { url, body };\n}\n\n// Bitrix wraps errors in HTTP 200: { status:\"error\", errors:[{code}] } or { error, error_description }.\n// NOTE: successful ajax responses carry an EMPTY `errors: []` array \u2014 a truthy value in JS \u2014 so we\n// must treat only a NON-EMPTY errors list (or status:\"error\"/a top-level error) as a real failure.\nexport function interpret(json: any): InterpretResult {\n  const list = json && (Array.isArray(json.errors) ? json.errors : json.error ? [{ code: json.error }] : []);\n  const hasErrors = Array.isArray(list) && list.length > 0;\n  if (json && (json.status === \"error\" || hasErrors)) {\n    const first = list[0];\n    const code = (first && (first.code || first.message)) || json.error || \"bitrix_error\";\n    const description = json.error_description || (first && first.message);\n    const error = description && description !== code ? `${code}: ${description}` : code;\n    return { ok: false, error, data: json };\n  }\n  return { ok: true, data: json };\n}\n", "// Pure, browser-agnostic \u2014 unit-tested. No DOM / chrome / window.BX here.\n//\n// Two concerns live together because both are the *contract* between the extension's\n// two content scripts and the packaged config, and both are pure/testable:\n//   1) parseConfig  \u2014 validate the per-user config.json ({ token, port }).\n//   2) the postMessage protocol \u2014 the envelopes the ISOLATED connector and the MAIN\n//      script exchange over window.postMessage (sessid request/response, and \u2014 in the\n//      capture build \u2014 MAIN-observed capture entries forwarded to the connector).\n\nimport type { CapturedEntry } from \"./bridge-core.ts\";\n\nexport interface BridgeConfig {\n  token: string;\n  port: number;\n}\n\n/**\n * Parse and validate the packaged config.json body. Throws with a clear,\n * user-facing message (mentioning config.json) on any malformed input so the\n * connector can surface why it failed to start.\n */\nexport function parseConfig(raw: string): BridgeConfig {\n  let doc: unknown;\n  try {\n    doc = JSON.parse(raw);\n  } catch {\n    throw new Error(\"config.json is not valid JSON\");\n  }\n  if (typeof doc !== \"object\" || doc === null) {\n    throw new Error(\"config.json must be an object like { token, port }\");\n  }\n  const obj = doc as Record<string, unknown>;\n  const token = typeof obj.token === \"string\" ? obj.token.trim() : \"\";\n  if (!token) throw new Error(\"config.json is missing a non-empty `token`\");\n  const port = Number(obj.port);\n  if (!Number.isInteger(port) || port < 1 || port > 65535) {\n    throw new Error(\"config.json is missing a numeric `port`\");\n  }\n  return { token, port };\n}\n\n// --- sessid postMessage protocol -------------------------------------------\n//\n// window.postMessage is delivered to BOTH the MAIN and ISOLATED worlds of the same\n// frame (they share the DOM window), and each world also receives its own posts. So\n// every envelope is tagged with a fixed `source` and a `kind`, and each side ignores\n// anything that isn't addressed to it. Responses additionally carry the request nonce\n// so the connector can match a reply to the exact in-flight request it issued.\n\nexport const BRIDGE_MSG_SOURCE = \"bitrix24-mcp-bridge\";\n\nexport interface SessidRequestMsg {\n  source: typeof BRIDGE_MSG_SOURCE;\n  kind: \"sessid-request\";\n  nonce: string;\n}\n\nexport interface SessidResponseMsg {\n  source: typeof BRIDGE_MSG_SOURCE;\n  kind: \"sessid-response\";\n  nonce: string;\n  sessid: string;\n}\n\nexport function buildSessidRequest(nonce: string): SessidRequestMsg {\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-request\", nonce };\n}\n\nexport function buildSessidResponse(nonce: string, sessid: string): SessidResponseMsg {\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-response\", nonce, sessid };\n}\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null;\n}\n\n/** For the MAIN shim: a well-formed request from our connector, or null. */\nexport function parseSessidRequest(data: unknown): SessidRequestMsg | null {\n  if (!isRecord(data)) return null;\n  if (data.source !== BRIDGE_MSG_SOURCE || data.kind !== \"sessid-request\") return null;\n  if (typeof data.nonce !== \"string\") return null;\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-request\", nonce: data.nonce };\n}\n\n/** For the ISOLATED connector: a response matching `expectedNonce`, or null. */\nexport function parseSessidResponse(data: unknown, expectedNonce: string): SessidResponseMsg | null {\n  if (!isRecord(data)) return null;\n  if (data.source !== BRIDGE_MSG_SOURCE || data.kind !== \"sessid-response\") return null;\n  if (typeof data.nonce !== \"string\" || data.nonce !== expectedNonce) return null;\n  if (typeof data.sessid !== \"string\") return null;\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-response\", nonce: data.nonce, sessid: data.sessid };\n}\n\n// --- capture forwarding (capture build only) -------------------------------\n//\n// The capture hooks must observe the PAGE's fetch/XHR, so they run in the MAIN world.\n// The socket lives only in the ISOLATED connector, so MAIN forwards each observed entry\n// to the connector over postMessage; the connector relays it to the daemon.\n\nexport interface CaptureForwardMsg {\n  source: typeof BRIDGE_MSG_SOURCE;\n  kind: \"capture\";\n  call: CapturedEntry;\n}\n\nexport function buildCaptureForward(call: CapturedEntry): CaptureForwardMsg {\n  return { source: BRIDGE_MSG_SOURCE, kind: \"capture\", call };\n}\n\n/** For the ISOLATED connector: a capture entry forwarded by the MAIN script, or null. */\nexport function parseCaptureForward(data: unknown): CaptureForwardMsg | null {\n  if (!isRecord(data)) return null;\n  if (data.source !== BRIDGE_MSG_SOURCE || data.kind !== \"capture\") return null;\n  if (!isRecord(data.call)) return null;\n  return { source: BRIDGE_MSG_SOURCE, kind: \"capture\", call: data.call as unknown as CapturedEntry };\n}\n", "// ISOLATED-world connector. This is where the token and the WebSocket live \u2014 never in\n// the page's MAIN world, so the page cannot read the token without knowing the dynamic\n// (`use_dynamic_url`) resource URL for config.json, and cannot hijack the socket. It has\n// `chrome.runtime`, so it loads the per-user config from the packaged config.json at\n// runtime (nothing per-user is baked into this JS \u2014 the file is static). The actual\n// boundary is `use_dynamic_url: true` on config.json in the manifest: it makes the\n// resource URL unguessable from the page while `chrome.runtime.getURL()` here still\n// resolves it.\n//\n// Per daemon call it asks the MAIN shim for a FRESH sessid over postMessage (nonce-matched),\n// then reuses the pure bridge-core helpers to build the request, fetch it with the page's\n// cookies, and interpret the response.\n\nimport { buildRequest, interpret, type CallRequest, type InterpretResult } from \"./bridge-core.ts\";\nimport {\n  parseConfig,\n  buildSessidRequest,\n  parseSessidResponse,\n  parseCaptureForward,\n  type BridgeConfig,\n} from \"./bridge-protocol.ts\";\n\n// Gates the capture relay listener; stripped from normal builds via esbuild `define`.\ndeclare const __BITRIX_CAPTURE__: boolean;\n\n// Minimal ambient for the one chrome API we use (no @types/chrome dependency).\ndeclare const chrome: { runtime: { getURL(path: string): string } };\n\nconst ORIGIN = location.origin;\nconst SESSID_TIMEOUT_MS = 2000;\nconst RECONNECT_MS = 3000;\n\nlet socket: WebSocket | null = null;\nlet nonceSeq = 0;\n\n/** Ask the MAIN shim for a fresh sessid; resolves \"\" if it doesn't answer in time. */\nfunction freshSessid(): Promise<string> {\n  const nonce = `${Date.now()}-${nonceSeq++}-${Math.random().toString(36).slice(2)}`;\n  return new Promise((resolve) => {\n    const onMsg = (ev: MessageEvent): void => {\n      if (ev.source !== window) return;\n      const res = parseSessidResponse(ev.data, nonce);\n      if (!res) return;\n      cleanup();\n      resolve(res.sessid);\n    };\n    const timer = setTimeout(() => {\n      cleanup();\n      resolve(\"\");\n    }, SESSID_TIMEOUT_MS);\n    const cleanup = (): void => {\n      clearTimeout(timer);\n      window.removeEventListener(\"message\", onMsg);\n    };\n    window.addEventListener(\"message\", onMsg);\n    window.postMessage(buildSessidRequest(nonce), ORIGIN);\n  });\n}\n\nasync function handleCall(req: CallRequest): Promise<InterpretResult> {\n  const sessid = await freshSessid();\n  if (!sessid) return { ok: false, error: \"session context not ready \u2014 open a normal Bitrix24 portal tab\" }; // G5\n  const { url, body } = buildRequest(ORIGIN, req, sessid);\n  const init: RequestInit = {\n    method: req.method,\n    credentials: \"include\",\n    headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n  };\n  let finalUrl = url;\n  if (req.method === \"POST\") init.body = body;\n  else finalUrl += (url.includes(\"?\") ? \"&\" : \"?\") + body;\n  const resp = await fetch(finalUrl, init);\n  const json = await resp.json();\n  return interpret(json); // G3\n}\n\nfunction connect(config: BridgeConfig): void {\n  const ws = new WebSocket(`ws://127.0.0.1:${config.port}`);\n  ws.addEventListener(\"open\", () => {\n    ws.send(JSON.stringify({ type: \"auth\", token: config.token })); // auth first (server closes non-auth)\n    socket = ws;\n  });\n  ws.addEventListener(\"message\", async (ev: MessageEvent) => {\n    let req: CallRequest;\n    try {\n      req = JSON.parse(ev.data) as CallRequest;\n    } catch (e) {\n      console.error(\"[bitrix-bridge] malformed WS frame, dropping:\", e);\n      return;\n    }\n    if (req.type !== \"call\") return;\n    try {\n      const r = await handleCall(req);\n      ws.send(JSON.stringify({ type: \"result\", id: req.id, ok: r.ok, data: r.data, error: r.error }));\n    } catch (e) {\n      ws.send(JSON.stringify({ type: \"result\", id: req.id, ok: false, error: String(e) }));\n    }\n  });\n  ws.addEventListener(\"close\", () => {\n    if (socket === ws) socket = null;\n    setTimeout(() => connect(config), RECONNECT_MS); // auto-reconnect\n  });\n}\n\n// Capture build only: relay MAIN-observed capture entries to the daemon.\nif (__BITRIX_CAPTURE__) {\n  window.addEventListener(\"message\", (ev: MessageEvent) => {\n    if (ev.source !== window) return;\n    const fwd = parseCaptureForward(ev.data);\n    if (!fwd) return;\n    if (socket && socket.readyState === WebSocket.OPEN) {\n      socket.send(JSON.stringify({ type: \"capture\", call: fwd.call }));\n    }\n  });\n}\n\nasync function start(): Promise<void> {\n  let config: BridgeConfig;\n  try {\n    const resp = await fetch(chrome.runtime.getURL(\"config.json\"));\n    if (!resp.ok) throw new Error(`HTTP ${resp.status}`);\n    config = parseConfig(await resp.text());\n  } catch (e) {\n    // Nothing to fall back to \u2014 surface why the bridge won't start and stop.\n    console.error(\"[bitrix-bridge] cannot load config.json:\", e);\n    return;\n  }\n  connect(config);\n}\n\nstart();\n"],
-  "mappings": ";;;AAcO,WAAS,WAAW,QAAyC;AAClE,QAAM,MAAM,IAAI,gBAAgB,GAC1B,MAAM,CAAC,KAAa,QAAuB;AAC/C,UAAI,OAAQ;AACZ,YAAI,MAAM,QAAQ,GAAG,EAAG,KAAI,QAAQ,CAAC,GAAG,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AAAA,iBAC3D,OAAO,OAAQ,SAAU,UAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,GAAG,EAAG,KAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;AAAA,YAC5F,KAAI,IAAI,KAAK,OAAO,GAAG,CAAC;AAAA,IAC/B;AACA,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,EAAG,KAAI,GAAG,CAAC;AACrD,WAAO,IAAI,SAAS;AAAA,EACtB;AAEO,WAAS,aACd,QACA,KACA,QAC+B;AAC/B,QAAM,IAAI,IAAI,SAAS,WAAW,mBAAmB,IAAI,MAAM,CAAC,KAAK,IAC/D,MAAM,GAAG,MAAM,GAAG,IAAI,QAAQ,GAAG,CAAC,IAClC,OAAO,WAAW,EAAE,GAAG,IAAI,QAAQ,OAAO,CAAC;AACjD,WAAO,EAAE,KAAK,KAAK;AAAA,EACrB;AAKO,WAAS,UAAU,MAA4B;AACpD,QAAM,OAAO,SAAS,MAAM,QAAQ,KAAK,MAAM,IAAI,KAAK,SAAS,KAAK,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,IAClG,YAAY,MAAM,QAAQ,IAAI,KAAK,KAAK,SAAS;AACvD,QAAI,SAAS,KAAK,WAAW,WAAW,YAAY;AAClD,UAAM,QAAQ,KAAK,CAAC,GACd,OAAQ,UAAU,MAAM,QAAQ,MAAM,YAAa,KAAK,SAAS,gBACjE,cAAc,KAAK,qBAAsB,SAAS,MAAM;AAE9D,aAAO,EAAE,IAAI,IAAO,OADN,eAAe,gBAAgB,OAAO,GAAG,IAAI,KAAK,WAAW,KAAK,MACrD,MAAM,KAAK;AAAA,IACxC;AACA,WAAO,EAAE,IAAI,IAAM,MAAM,KAAK;AAAA,EAChC;;;AC9BO,WAAS,YAAY,KAA2B;AACrD,QAAI;AACJ,QAAI;AACF,YAAM,KAAK,MAAM,GAAG;AAAA,IACtB,QAAQ;AACN,YAAM,IAAI,MAAM,+BAA+B;AAAA,IACjD;AACA,QAAI,OAAO,OAAQ,YAAY,QAAQ;AACrC,YAAM,IAAI,MAAM,oDAAoD;AAEtE,QAAM,MAAM,KACN,QAAQ,OAAO,IAAI,SAAU,WAAW,IAAI,MAAM,KAAK,IAAI;AACjE,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,4CAA4C;AACxE,QAAM,OAAO,OAAO,IAAI,IAAI;AAC5B,QAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO;AAChD,YAAM,IAAI,MAAM,yCAAyC;AAE3D,WAAO,EAAE,OAAO,KAAK;AAAA,EACvB;AAUO,MAAM,oBAAoB;AAe1B,WAAS,mBAAmB,OAAiC;AAClE,WAAO,EAAE,QAAQ,mBAAmB,MAAM,kBAAkB,MAAM;AAAA,EACpE;AAMA,WAAS,SAAS,GAA0C;AAC1D,WAAO,OAAO,KAAM,YAAY,MAAM;AAAA,EACxC;AAWO,WAAS,oBAAoB,MAAe,eAAiD;AAIlG,WAHI,CAAC,SAAS,IAAI,KACd,KAAK,WAAW,qBAAqB,KAAK,SAAS,qBACnD,OAAO,KAAK,SAAU,YAAY,KAAK,UAAU,iBACjD,OAAO,KAAK,UAAW,WAAiB,OACrC,EAAE,QAAQ,mBAAmB,MAAM,mBAAmB,OAAO,KAAK,OAAO,QAAQ,KAAK,OAAO;AAAA,EACtG;;;AC/DA,MAAM,SAAS,SAAS,QAClB,oBAAoB,KACpB,eAAe,KAEjB,SAA2B,MAC3B,WAAW;AAGf,WAAS,cAA+B;AACtC,QAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,IAAI,UAAU,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAChF,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,QAAQ,CAAC,OAA2B;AACxC,YAAI,GAAG,WAAW,OAAQ;AAC1B,YAAM,MAAM,oBAAoB,GAAG,MAAM,KAAK;AAC9C,QAAK,QACL,QAAQ,GACR,QAAQ,IAAI,MAAM;AAAA,MACpB,GACM,QAAQ,WAAW,MAAM;AAC7B,gBAAQ,GACR,QAAQ,EAAE;AAAA,MACZ,GAAG,iBAAiB,GACd,UAAU,MAAY;AAC1B,qBAAa,KAAK,GAClB,OAAO,oBAAoB,WAAW,KAAK;AAAA,MAC7C;AACA,aAAO,iBAAiB,WAAW,KAAK,GACxC,OAAO,YAAY,mBAAmB,KAAK,GAAG,MAAM;AAAA,IACtD,CAAC;AAAA,EACH;AAEA,iBAAe,WAAW,KAA4C;AACpE,QAAM,SAAS,MAAM,YAAY;AACjC,QAAI,CAAC,OAAQ,QAAO,EAAE,IAAI,IAAO,OAAO,qEAAgE;AACxG,QAAM,EAAE,KAAK,KAAK,IAAI,aAAa,QAAQ,KAAK,MAAM,GAChD,OAAoB;AAAA,MACxB,QAAQ,IAAI;AAAA,MACZ,aAAa;AAAA,MACb,SAAS,EAAE,gBAAgB,oCAAoC;AAAA,IACjE,GACI,WAAW;AACf,IAAI,IAAI,WAAW,SAAQ,KAAK,OAAO,OAClC,aAAa,IAAI,SAAS,GAAG,IAAI,MAAM,OAAO;AAEnD,QAAM,OAAO,OADA,MAAM,MAAM,UAAU,IAAI,GACf,KAAK;AAC7B,WAAO,UAAU,IAAI;AAAA,EACvB;AAEA,WAAS,QAAQ,QAA4B;AAC3C,QAAM,KAAK,IAAI,UAAU,kBAAkB,OAAO,IAAI,EAAE;AACxD,OAAG,iBAAiB,QAAQ,MAAM;AAChC,SAAG,KAAK,KAAK,UAAU,EAAE,MAAM,QAAQ,OAAO,OAAO,MAAM,CAAC,CAAC,GAC7D,SAAS;AAAA,IACX,CAAC,GACD,GAAG,iBAAiB,WAAW,OAAO,OAAqB;AACzD,UAAI;AACJ,UAAI;AACF,cAAM,KAAK,MAAM,GAAG,IAAI;AAAA,MAC1B,SAAS,GAAG;AACV,gBAAQ,MAAM,iDAAiD,CAAC;AAChE;AAAA,MACF;AACA,UAAI,IAAI,SAAS;AACjB,YAAI;AACF,cAAM,IAAI,MAAM,WAAW,GAAG;AAC9B,aAAG,KAAK,KAAK,UAAU,EAAE,MAAM,UAAU,IAAI,IAAI,IAAI,IAAI,EAAE,IAAI,MAAM,EAAE,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC;AAAA,QAChG,SAAS,GAAG;AACV,aAAG,KAAK,KAAK,UAAU,EAAE,MAAM,UAAU,IAAI,IAAI,IAAI,IAAI,IAAO,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;AAAA,QACrF;AAAA,IACF,CAAC,GACD,GAAG,iBAAiB,SAAS,MAAM;AACjC,MAAI,WAAW,OAAI,SAAS,OAC5B,WAAW,MAAM,QAAQ,MAAM,GAAG,YAAY;AAAA,IAChD,CAAC;AAAA,EACH;AAcA,iBAAe,QAAuB;AACpC,QAAI;AACJ,QAAI;AACF,UAAM,OAAO,MAAM,MAAM,OAAO,QAAQ,OAAO,aAAa,CAAC;AAC7D,UAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,QAAQ,KAAK,MAAM,EAAE;AACnD,eAAS,YAAY,MAAM,KAAK,KAAK,CAAC;AAAA,IACxC,SAAS,GAAG;AAEV,cAAQ,MAAM,4CAA4C,CAAC;AAC3D;AAAA,IACF;AACA,YAAQ,MAAM;AAAA,EAChB;AAEA,QAAM;",
+  "sourcesContent": ["// Pure, browser-agnostic \u2014 unit-tested.\n\n// Wire types come from the shared single source; re-exported so downstream\n// extension modules keep importing them from here.\nimport type { CallRequest } from \"../../shared/wire.ts\";\nexport type { CallRequest, CapturedEntry } from \"../../shared/wire.ts\";\n\n// Extension-only: the shape handleCall returns to the bridge (not a wire message).\nexport interface InterpretResult {\n  ok: boolean;\n  data?: unknown;\n  error?: string;\n}\n\nexport function encodeForm(params: Record<string, unknown>): string {\n  const out = new URLSearchParams();\n  const add = (key: string, val: unknown): void => {\n    if (val === null || val === undefined) return;\n    if (Array.isArray(val)) val.forEach((v, i) => add(`${key}[${i}]`, v));\n    else if (typeof val === \"object\") for (const [k, v] of Object.entries(val)) add(`${key}[${k}]`, v);\n    else out.set(key, String(val));\n  };\n  for (const [k, v] of Object.entries(params)) add(k, v);\n  return out.toString();\n}\n\nexport function buildRequest(\n  origin: string,\n  req: CallRequest,\n  sessid: string,\n): { url: string; body: string; contentType: string } {\n  const q = req.action ? `?action=${encodeURIComponent(req.action)}` : \"\";\n  const url = `${origin}${req.endpoint}${q}`;\n  // JSON actions (ui.entityselector.*, tasks.v2.*) send a JSON body; sessid rides the\n  // X-Bitrix-Csrf-Token header (added by the caller), never the body.\n  if (req.bodyType === \"json\") {\n    return { url, body: JSON.stringify(req.params), contentType: \"application/json\" };\n  }\n  const body = encodeForm({ ...req.params, sessid });\n  return { url, body, contentType: \"application/x-www-form-urlencoded\" };\n}\n\n// Bitrix wraps errors in HTTP 200: { status:\"error\", errors:[{code}] } or { error, error_description }.\n// NOTE: successful ajax responses carry an EMPTY `errors: []` array \u2014 a truthy value in JS \u2014 so we\n// must treat only a NON-EMPTY errors list (or status:\"error\"/a top-level error) as a real failure.\nexport function interpret(json: any): InterpretResult {\n  const list = json && (Array.isArray(json.errors) ? json.errors : json.error ? [{ code: json.error }] : []);\n  const hasErrors = Array.isArray(list) && list.length > 0;\n  if (json && (json.status === \"error\" || hasErrors)) {\n    const first = list[0];\n    const code = (first && (first.code || first.message)) || json.error || \"bitrix_error\";\n    const description = json.error_description || (first && first.message);\n    const error = description && description !== code ? `${code}: ${description}` : code;\n    return { ok: false, error, data: json };\n  }\n  return { ok: true, data: json };\n}\n", "// Pure, browser-agnostic \u2014 unit-tested. No DOM / chrome / window.BX here.\n//\n// Two concerns live together because both are the *contract* between the extension's\n// two content scripts and the packaged config, and both are pure/testable:\n//   1) parseConfig  \u2014 validate the per-user config.json ({ token, port }).\n//   2) the postMessage protocol \u2014 the envelopes the ISOLATED connector and the MAIN\n//      script exchange over window.postMessage (sessid request/response, and \u2014 in the\n//      capture build \u2014 MAIN-observed capture entries forwarded to the connector).\n\nimport type { CapturedEntry } from \"./bridge-core.ts\";\n\nexport interface BridgeConfig {\n  token: string;\n  port: number;\n}\n\n/**\n * Parse and validate the packaged config.json body. Throws with a clear,\n * user-facing message (mentioning config.json) on any malformed input so the\n * connector can surface why it failed to start.\n */\nexport function parseConfig(raw: string): BridgeConfig {\n  let doc: unknown;\n  try {\n    doc = JSON.parse(raw);\n  } catch {\n    throw new Error(\"config.json is not valid JSON\");\n  }\n  if (typeof doc !== \"object\" || doc === null) {\n    throw new Error(\"config.json must be an object like { token, port }\");\n  }\n  const obj = doc as Record<string, unknown>;\n  const token = typeof obj.token === \"string\" ? obj.token.trim() : \"\";\n  if (!token) throw new Error(\"config.json is missing a non-empty `token`\");\n  const port = Number(obj.port);\n  if (!Number.isInteger(port) || port < 1 || port > 65535) {\n    throw new Error(\"config.json is missing a numeric `port`\");\n  }\n  return { token, port };\n}\n\n// --- sessid postMessage protocol -------------------------------------------\n//\n// window.postMessage is delivered to BOTH the MAIN and ISOLATED worlds of the same\n// frame (they share the DOM window), and each world also receives its own posts. So\n// every envelope is tagged with a fixed `source` and a `kind`, and each side ignores\n// anything that isn't addressed to it. Responses additionally carry the request nonce\n// so the connector can match a reply to the exact in-flight request it issued.\n\nexport const BRIDGE_MSG_SOURCE = \"bitrix24-mcp-bridge\";\n\nexport interface SessidRequestMsg {\n  source: typeof BRIDGE_MSG_SOURCE;\n  kind: \"sessid-request\";\n  nonce: string;\n}\n\nexport interface SessidResponseMsg {\n  source: typeof BRIDGE_MSG_SOURCE;\n  kind: \"sessid-response\";\n  nonce: string;\n  sessid: string;\n}\n\nexport function buildSessidRequest(nonce: string): SessidRequestMsg {\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-request\", nonce };\n}\n\nexport function buildSessidResponse(nonce: string, sessid: string): SessidResponseMsg {\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-response\", nonce, sessid };\n}\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null;\n}\n\n/** For the MAIN shim: a well-formed request from our connector, or null. */\nexport function parseSessidRequest(data: unknown): SessidRequestMsg | null {\n  if (!isRecord(data)) return null;\n  if (data.source !== BRIDGE_MSG_SOURCE || data.kind !== \"sessid-request\") return null;\n  if (typeof data.nonce !== \"string\") return null;\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-request\", nonce: data.nonce };\n}\n\n/** For the ISOLATED connector: a response matching `expectedNonce`, or null. */\nexport function parseSessidResponse(data: unknown, expectedNonce: string): SessidResponseMsg | null {\n  if (!isRecord(data)) return null;\n  if (data.source !== BRIDGE_MSG_SOURCE || data.kind !== \"sessid-response\") return null;\n  if (typeof data.nonce !== \"string\" || data.nonce !== expectedNonce) return null;\n  if (typeof data.sessid !== \"string\") return null;\n  return { source: BRIDGE_MSG_SOURCE, kind: \"sessid-response\", nonce: data.nonce, sessid: data.sessid };\n}\n\n// --- capture forwarding (capture build only) -------------------------------\n//\n// The capture hooks must observe the PAGE's fetch/XHR, so they run in the MAIN world.\n// The socket lives only in the ISOLATED connector, so MAIN forwards each observed entry\n// to the connector over postMessage; the connector relays it to the daemon.\n\nexport interface CaptureForwardMsg {\n  source: typeof BRIDGE_MSG_SOURCE;\n  kind: \"capture\";\n  call: CapturedEntry;\n}\n\nexport function buildCaptureForward(call: CapturedEntry): CaptureForwardMsg {\n  return { source: BRIDGE_MSG_SOURCE, kind: \"capture\", call };\n}\n\n/** For the ISOLATED connector: a capture entry forwarded by the MAIN script, or null. */\nexport function parseCaptureForward(data: unknown): CaptureForwardMsg | null {\n  if (!isRecord(data)) return null;\n  if (data.source !== BRIDGE_MSG_SOURCE || data.kind !== \"capture\") return null;\n  if (!isRecord(data.call)) return null;\n  return { source: BRIDGE_MSG_SOURCE, kind: \"capture\", call: data.call as unknown as CapturedEntry };\n}\n", "// ISOLATED-world connector. This is where the token and the WebSocket live \u2014 never in\n// the page's MAIN world, so the page cannot read the token without knowing the dynamic\n// (`use_dynamic_url`) resource URL for config.json, and cannot hijack the socket. It has\n// `chrome.runtime`, so it loads the per-user config from the packaged config.json at\n// runtime (nothing per-user is baked into this JS \u2014 the file is static). The actual\n// boundary is `use_dynamic_url: true` on config.json in the manifest: it makes the\n// resource URL unguessable from the page while `chrome.runtime.getURL()` here still\n// resolves it.\n//\n// Per daemon call it asks the MAIN shim for a FRESH sessid over postMessage (nonce-matched),\n// then reuses the pure bridge-core helpers to build the request, fetch it with the page's\n// cookies, and interpret the response.\n\nimport { buildRequest, interpret, type CallRequest, type InterpretResult } from \"./bridge-core.ts\";\nimport {\n  parseConfig,\n  buildSessidRequest,\n  parseSessidResponse,\n  parseCaptureForward,\n  type BridgeConfig,\n} from \"./bridge-protocol.ts\";\n\n// Gates the capture relay listener; stripped from normal builds via esbuild `define`.\ndeclare const __BITRIX_CAPTURE__: boolean;\n\n// Minimal ambient for the one chrome API we use (no @types/chrome dependency).\ndeclare const chrome: { runtime: { getURL(path: string): string } };\n\nconst ORIGIN = location.origin;\nconst SESSID_TIMEOUT_MS = 2000;\nconst RECONNECT_MS = 3000;\n\nlet socket: WebSocket | null = null;\nlet nonceSeq = 0;\n\n/** Ask the MAIN shim for a fresh sessid; resolves \"\" if it doesn't answer in time. */\nfunction freshSessid(): Promise<string> {\n  const nonce = `${Date.now()}-${nonceSeq++}-${Math.random().toString(36).slice(2)}`;\n  return new Promise((resolve) => {\n    const onMsg = (ev: MessageEvent): void => {\n      if (ev.source !== window) return;\n      const res = parseSessidResponse(ev.data, nonce);\n      if (!res) return;\n      cleanup();\n      resolve(res.sessid);\n    };\n    const timer = setTimeout(() => {\n      cleanup();\n      resolve(\"\");\n    }, SESSID_TIMEOUT_MS);\n    const cleanup = (): void => {\n      clearTimeout(timer);\n      window.removeEventListener(\"message\", onMsg);\n    };\n    window.addEventListener(\"message\", onMsg);\n    window.postMessage(buildSessidRequest(nonce), ORIGIN);\n  });\n}\n\nasync function handleCall(req: CallRequest): Promise<InterpretResult> {\n  const sessid = await freshSessid();\n  if (!sessid) return { ok: false, error: \"session context not ready \u2014 open a normal Bitrix24 portal tab\" }; // G5\n  const { url, body, contentType } = buildRequest(ORIGIN, req, sessid);\n  const init: RequestInit = {\n    method: req.method,\n    credentials: \"include\",\n    // sessid rides the CSRF header for all ajax (v2 form + json); form bodies also carry it inline.\n    headers: { \"Content-Type\": contentType, \"X-Bitrix-Csrf-Token\": sessid },\n  };\n  let finalUrl = url;\n  if (req.method === \"POST\") init.body = body;\n  else finalUrl += (url.includes(\"?\") ? \"&\" : \"?\") + body;\n  const resp = await fetch(finalUrl, init);\n  const json = await resp.json();\n  return interpret(json); // G3\n}\n\nfunction connect(config: BridgeConfig): void {\n  const ws = new WebSocket(`ws://127.0.0.1:${config.port}`);\n  ws.addEventListener(\"open\", () => {\n    ws.send(JSON.stringify({ type: \"auth\", token: config.token })); // auth first (server closes non-auth)\n    socket = ws;\n  });\n  ws.addEventListener(\"message\", async (ev: MessageEvent) => {\n    let req: CallRequest;\n    try {\n      req = JSON.parse(ev.data) as CallRequest;\n    } catch (e) {\n      console.error(\"[bitrix-bridge] malformed WS frame, dropping:\", e);\n      return;\n    }\n    if (req.type !== \"call\") return;\n    try {\n      const r = await handleCall(req);\n      ws.send(JSON.stringify({ type: \"result\", id: req.id, ok: r.ok, data: r.data, error: r.error }));\n    } catch (e) {\n      ws.send(JSON.stringify({ type: \"result\", id: req.id, ok: false, error: String(e) }));\n    }\n  });\n  ws.addEventListener(\"close\", () => {\n    if (socket === ws) socket = null;\n    setTimeout(() => connect(config), RECONNECT_MS); // auto-reconnect\n  });\n}\n\n// Capture build only: relay MAIN-observed capture entries to the daemon.\nif (__BITRIX_CAPTURE__) {\n  window.addEventListener(\"message\", (ev: MessageEvent) => {\n    if (ev.source !== window) return;\n    const fwd = parseCaptureForward(ev.data);\n    if (!fwd) return;\n    if (socket && socket.readyState === WebSocket.OPEN) {\n      socket.send(JSON.stringify({ type: \"capture\", call: fwd.call }));\n    }\n  });\n}\n\nasync function start(): Promise<void> {\n  let config: BridgeConfig;\n  try {\n    const resp = await fetch(chrome.runtime.getURL(\"config.json\"));\n    if (!resp.ok) throw new Error(`HTTP ${resp.status}`);\n    config = parseConfig(await resp.text());\n  } catch (e) {\n    // Nothing to fall back to \u2014 surface why the bridge won't start and stop.\n    console.error(\"[bitrix-bridge] cannot load config.json:\", e);\n    return;\n  }\n  connect(config);\n}\n\nstart();\n"],
+  "mappings": ";;;AAcO,WAAS,WAAW,QAAyC;AAClE,QAAM,MAAM,IAAI,gBAAgB,GAC1B,MAAM,CAAC,KAAa,QAAuB;AAC/C,UAAI,OAAQ;AACZ,YAAI,MAAM,QAAQ,GAAG,EAAG,KAAI,QAAQ,CAAC,GAAG,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AAAA,iBAC3D,OAAO,OAAQ,SAAU,UAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,GAAG,EAAG,KAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;AAAA,YAC5F,KAAI,IAAI,KAAK,OAAO,GAAG,CAAC;AAAA,IAC/B;AACA,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,EAAG,KAAI,GAAG,CAAC;AACrD,WAAO,IAAI,SAAS;AAAA,EACtB;AAEO,WAAS,aACd,QACA,KACA,QACoD;AACpD,QAAM,IAAI,IAAI,SAAS,WAAW,mBAAmB,IAAI,MAAM,CAAC,KAAK,IAC/D,MAAM,GAAG,MAAM,GAAG,IAAI,QAAQ,GAAG,CAAC;AAGxC,QAAI,IAAI,aAAa;AACnB,aAAO,EAAE,KAAK,MAAM,KAAK,UAAU,IAAI,MAAM,GAAG,aAAa,mBAAmB;AAElF,QAAM,OAAO,WAAW,EAAE,GAAG,IAAI,QAAQ,OAAO,CAAC;AACjD,WAAO,EAAE,KAAK,MAAM,aAAa,oCAAoC;AAAA,EACvE;AAKO,WAAS,UAAU,MAA4B;AACpD,QAAM,OAAO,SAAS,MAAM,QAAQ,KAAK,MAAM,IAAI,KAAK,SAAS,KAAK,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,IAClG,YAAY,MAAM,QAAQ,IAAI,KAAK,KAAK,SAAS;AACvD,QAAI,SAAS,KAAK,WAAW,WAAW,YAAY;AAClD,UAAM,QAAQ,KAAK,CAAC,GACd,OAAQ,UAAU,MAAM,QAAQ,MAAM,YAAa,KAAK,SAAS,gBACjE,cAAc,KAAK,qBAAsB,SAAS,MAAM;AAE9D,aAAO,EAAE,IAAI,IAAO,OADN,eAAe,gBAAgB,OAAO,GAAG,IAAI,KAAK,WAAW,KAAK,MACrD,MAAM,KAAK;AAAA,IACxC;AACA,WAAO,EAAE,IAAI,IAAM,MAAM,KAAK;AAAA,EAChC;;;ACnCO,WAAS,YAAY,KAA2B;AACrD,QAAI;AACJ,QAAI;AACF,YAAM,KAAK,MAAM,GAAG;AAAA,IACtB,QAAQ;AACN,YAAM,IAAI,MAAM,+BAA+B;AAAA,IACjD;AACA,QAAI,OAAO,OAAQ,YAAY,QAAQ;AACrC,YAAM,IAAI,MAAM,oDAAoD;AAEtE,QAAM,MAAM,KACN,QAAQ,OAAO,IAAI,SAAU,WAAW,IAAI,MAAM,KAAK,IAAI;AACjE,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,4CAA4C;AACxE,QAAM,OAAO,OAAO,IAAI,IAAI;AAC5B,QAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO;AAChD,YAAM,IAAI,MAAM,yCAAyC;AAE3D,WAAO,EAAE,OAAO,KAAK;AAAA,EACvB;AAUO,MAAM,oBAAoB;AAe1B,WAAS,mBAAmB,OAAiC;AAClE,WAAO,EAAE,QAAQ,mBAAmB,MAAM,kBAAkB,MAAM;AAAA,EACpE;AAMA,WAAS,SAAS,GAA0C;AAC1D,WAAO,OAAO,KAAM,YAAY,MAAM;AAAA,EACxC;AAWO,WAAS,oBAAoB,MAAe,eAAiD;AAIlG,WAHI,CAAC,SAAS,IAAI,KACd,KAAK,WAAW,qBAAqB,KAAK,SAAS,qBACnD,OAAO,KAAK,SAAU,YAAY,KAAK,UAAU,iBACjD,OAAO,KAAK,UAAW,WAAiB,OACrC,EAAE,QAAQ,mBAAmB,MAAM,mBAAmB,OAAO,KAAK,OAAO,QAAQ,KAAK,OAAO;AAAA,EACtG;;;AC/DA,MAAM,SAAS,SAAS,QAClB,oBAAoB,KACpB,eAAe,KAEjB,SAA2B,MAC3B,WAAW;AAGf,WAAS,cAA+B;AACtC,QAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,IAAI,UAAU,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAChF,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,QAAQ,CAAC,OAA2B;AACxC,YAAI,GAAG,WAAW,OAAQ;AAC1B,YAAM,MAAM,oBAAoB,GAAG,MAAM,KAAK;AAC9C,QAAK,QACL,QAAQ,GACR,QAAQ,IAAI,MAAM;AAAA,MACpB,GACM,QAAQ,WAAW,MAAM;AAC7B,gBAAQ,GACR,QAAQ,EAAE;AAAA,MACZ,GAAG,iBAAiB,GACd,UAAU,MAAY;AAC1B,qBAAa,KAAK,GAClB,OAAO,oBAAoB,WAAW,KAAK;AAAA,MAC7C;AACA,aAAO,iBAAiB,WAAW,KAAK,GACxC,OAAO,YAAY,mBAAmB,KAAK,GAAG,MAAM;AAAA,IACtD,CAAC;AAAA,EACH;AAEA,iBAAe,WAAW,KAA4C;AACpE,QAAM,SAAS,MAAM,YAAY;AACjC,QAAI,CAAC,OAAQ,QAAO,EAAE,IAAI,IAAO,OAAO,qEAAgE;AACxG,QAAM,EAAE,KAAK,MAAM,YAAY,IAAI,aAAa,QAAQ,KAAK,MAAM,GAC7D,OAAoB;AAAA,MACxB,QAAQ,IAAI;AAAA,MACZ,aAAa;AAAA;AAAA,MAEb,SAAS,EAAE,gBAAgB,aAAa,uBAAuB,OAAO;AAAA,IACxE,GACI,WAAW;AACf,IAAI,IAAI,WAAW,SAAQ,KAAK,OAAO,OAClC,aAAa,IAAI,SAAS,GAAG,IAAI,MAAM,OAAO;AAEnD,QAAM,OAAO,OADA,MAAM,MAAM,UAAU,IAAI,GACf,KAAK;AAC7B,WAAO,UAAU,IAAI;AAAA,EACvB;AAEA,WAAS,QAAQ,QAA4B;AAC3C,QAAM,KAAK,IAAI,UAAU,kBAAkB,OAAO,IAAI,EAAE;AACxD,OAAG,iBAAiB,QAAQ,MAAM;AAChC,SAAG,KAAK,KAAK,UAAU,EAAE,MAAM,QAAQ,OAAO,OAAO,MAAM,CAAC,CAAC,GAC7D,SAAS;AAAA,IACX,CAAC,GACD,GAAG,iBAAiB,WAAW,OAAO,OAAqB;AACzD,UAAI;AACJ,UAAI;AACF,cAAM,KAAK,MAAM,GAAG,IAAI;AAAA,MAC1B,SAAS,GAAG;AACV,gBAAQ,MAAM,iDAAiD,CAAC;AAChE;AAAA,MACF;AACA,UAAI,IAAI,SAAS;AACjB,YAAI;AACF,cAAM,IAAI,MAAM,WAAW,GAAG;AAC9B,aAAG,KAAK,KAAK,UAAU,EAAE,MAAM,UAAU,IAAI,IAAI,IAAI,IAAI,EAAE,IAAI,MAAM,EAAE,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC;AAAA,QAChG,SAAS,GAAG;AACV,aAAG,KAAK,KAAK,UAAU,EAAE,MAAM,UAAU,IAAI,IAAI,IAAI,IAAI,IAAO,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;AAAA,QACrF;AAAA,IACF,CAAC,GACD,GAAG,iBAAiB,SAAS,MAAM;AACjC,MAAI,WAAW,OAAI,SAAS,OAC5B,WAAW,MAAM,QAAQ,MAAM,GAAG,YAAY;AAAA,IAChD,CAAC;AAAA,EACH;AAcA,iBAAe,QAAuB;AACpC,QAAI;AACJ,QAAI;AACF,UAAM,OAAO,MAAM,MAAM,OAAO,QAAQ,OAAO,aAAa,CAAC;AAC7D,UAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,QAAQ,KAAK,MAAM,EAAE;AACnD,eAAS,YAAY,MAAM,KAAK,KAAK,CAAC;AAAA,IACxC,SAAS,GAAG;AAEV,cAAQ,MAAM,4CAA4C,CAAC;AAC3D;AAAA,IACF;AACA,YAAQ,MAAM;AAAA,EAChB;AAEA,QAAM;",
   "names": []
 }

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "bitrix24-mcp-bridge",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "MCP bridge server for Bitrix24 — exposes REST API access, tasks, projects and chat to MCP clients like Claude Code.",
   "license": "MIT",
   "repository": {
@@ -12,7 +12,12 @@
     "bitrix24-bridge": "dist/cli.js",
     "bitrix24-mcp-bridge": "dist/cli.js"
   },
-  "files": ["dist", "extension/dist", "docs/api-notes.md", "actions.example.json"],
+  "files": [
+    "dist",
+    "extension/dist",
+    "docs/api-notes.md",
+    "actions.example.json"
+  ],
   "scripts": {
     "test": "bun test",
     "dev": "bun run src/index.ts",