@besales/mcp 0.37.1 → 0.39.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.
package/README.md CHANGED
@@ -290,10 +290,11 @@ connect each once and pin sessions via `BESALES_WORKSPACE_ID` (or switch the
290
290
  global default with `besales-mcp use <id>`) — see
291
291
  [Multiple Workspaces](#multiple-workspaces).
292
292
 
293
- ## Available tools (169 tools by category)
293
+ ## Available tools (191 tools by category)
294
294
 
295
- Counts are derived from `src/schemas/mcp-tools.json` (`summary.tools_by_category`)
296
- and asserted in `src/tools/registry.spec.ts`:
295
+ Итоговое число выводится из `src/schemas/mcp-tools.json` (`tools.length`) и закреплено в
296
+ `src/tools/registry.spec.ts`. ⚠️ Разбивка по категориям ниже и `summary.tools_by_category`
297
+ ведутся ВРУЧНУЮ и в сумме отстают от итога — тестами они не проверяются:
297
298
 
298
299
  | Category | Tools | Notes |
299
300
  |---|---|---|
@@ -323,6 +324,7 @@ and asserted in `src/tools/registry.spec.ts`:
323
324
  | Broadcast analytics | 2 | `besales_broadcast_analytics_get`, `besales_broadcast_cohorts_list` — authoritative read-only aggregates, drill-downs, segment/product catalogs, insights and payment-candidate reports from `/broadcast-analytics`, not transcript-derived counts |
324
325
  | GetCourse waves | 10 | `besales_getcourse_wave_import`, `besales_getcourse_wave_status`, `besales_getcourse_wave_run_start`, `besales_getcourse_wave_run_status`, `besales_getcourse_wave_run_contacts`, `besales_getcourse_wave_run_cancel`, `besales_getcourse_wave_run_batch_start`, `besales_getcourse_wave_run_batch_status`, `besales_getcourse_wave_run_batch_cancel`, `besales_getcourse_wave_run_batch_resume`; durable confirm использует стабильный `launch_key` + `dry_run_hash`, import/run/batch принимают `segment_description` |
325
326
  | Scheduled tasks | 2 | `besales_scheduled_task_list`, `besales_scheduled_task_update` — cron-driven dialogue analysis («суфлёр»): daily summary + hourly status written to the CRM timeline or as a hidden open-line message, never to the client |
327
+ | Link tracking (короткие ссылки) | 6 | `besales_tracked_link_list` / `_create` / `_update` / `_archive` / `_breakdown` / `_clicks` — каталог токенов `{{link:slug}}` для текстов дожимов и рассылок; удаления нет (архивация), правка адреса историю выдач не переписывает |
326
328
  | Follow-up (read) | 2 | `besales_followup_sequence_list`, `besales_followup_step_stats` — read a sequence config before a read-modify-write upsert, and see per-step delivery/skip reasons |
327
329
 
328
330
  Recent capabilities:
@@ -390,7 +392,7 @@ Inspect them locally:
390
392
  yarn dlx @modelcontextprotocol/inspector node bin/besales-mcp.js
391
393
  ```
392
394
 
393
- The Inspector should show 169 tools and 31 resources.
395
+ The Inspector should show 191 tools and 31 resources.
394
396
 
395
397
  ## Codex Dialogue Audit Skill
396
398
 
@@ -434,7 +436,7 @@ Claude Code, and Codex CLI are documented in
434
436
  - This package calls Animaly only through `ai-aniomaly` `/api/v2/*`.
435
437
  - Direct calls to `prompt-services` are intentionally out of scope.
436
438
 
437
- The package exposes 169 active MCP tools from `src/schemas/mcp-tools.json`.
439
+ The package exposes 191 active MCP tools from `src/schemas/mcp-tools.json`.
438
440
 
439
441
  ### Token scopes
440
442
 
@@ -313,7 +313,11 @@ Salebot сам подключает Telegram/VK/WhatsApp/etc. Animaly через
313
313
 
314
314
  **Особенности:**
315
315
  - Real-time через **Socket.IO** (не webhook).
316
- - `webWidgetShowPageInfo=true` — добавляет в промпт URL текущей страницы.
316
+ - `webWidgetShowPageInfo` (**default `false`**, opt-in) — добавляет в системный промпт блок
317
+ «Контекст страницы»: URL, заголовок и meta description страницы, на которой находится
318
+ посетитель. Работает **только для RAG-агентов** — у SIMPLE- и QA-шаблонов этого блока нет.
319
+ Вложения (файлы, скриншоты) приходят без контекста страницы. Значения санируются: пробелы
320
+ схлопываются, длина режется (url 512 / title 200 / description 400 символов).
317
321
  - `webWidgetMarketingFieldMappings` — UTM/yaClientId/gaClientId автоматически отправляются в CRM-поля.
318
322
  - Push-кампании **не поддерживаются** (нет инициатора со стороны бота).
319
323
  - Особая логика follow-up через `webWidgetLastSeenAt` (см. [`08-follow-up.md`](08-follow-up.md)).