@besales/mcp 0.32.0 → 0.37.0

package/dist/schemas/mcp-tools.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "besales-mcp Tool Definitions",
   "version": "1.2.0-draft",
-  "lastUpdated": "2026-07-26",
+  "lastUpdated": "2026-07-28",
   "description": "MCP tool schemas для besales-mcp npm package. Active v1.5 set содержит PromptHub/ICP/Sandbox/Knowledge external-execution operations и stateless Platform Setup Bridge direct tools. Setup Pipeline session tools сохранены как Phase 4+ future design, но не входят в active toolset.",
   "executionModes": {
     "summary": "Каждая active LLM-операция имеет 2 MCP tools: get_instructions + submit. Claude локально между tools выполняет LLM-вызовы своими моделями. Auto-detection через JWT scope mcp:* → external default.",
@@ -1266,6 +1266,11 @@
       "description": "Launch a GetCourse outbound wave (Step 1 import contacts + pin deals -> Step 2 send). Default launch_type=status. WITHOUT confirm=true it is a DRY-RUN and sends nothing. funnel is the canonical business-funnel key/name, never a batch/resend label; cohort_label names the concrete launch. product_code binds that funnel to the analytics product dictionary; product_name is its display name. contacts[].segment_entered_at is the exact segment-entry time; lead_last_active_at is legacy last activity only. Returns waveJobId — poll besales_getcourse_wave_status until COMPLETED. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
+        "dependentRequired": {
+          "segment_description": [
+            "segment"
+          ]
+        },
         "required": [
           "platform_id",
           "crm_id",
@@ -1315,11 +1320,21 @@
             "maxLength": 200,
             "description": "Wave segment label (analytics)."
           },
+          "segment_description": {
+            "type": "string",
+            "maxLength": 4000,
+            "description": "Explicit business rule for segment selection. Requires segment; creates or updates its saved description."
+          },
           "cohort_label": {
             "type": "string",
             "maxLength": 200,
             "description": "Человекочитаемое имя конкретного запуска волны; не подменяет каноническую бизнес-воронку."
           },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "ID активного именованного варианта рассылки для сравнительной аналитики."
+          },
           "message_variant": {
             "type": "string",
             "maxLength": 120,
@@ -1385,6 +1400,27 @@
                   "type": "string",
                   "description": "Optional GetCourse dialog id (resp_id) — needed for board-mode welcome."
                 },
+                "email": {
+                  "type": "string",
+                  "format": "email",
+                  "maxLength": 320,
+                  "description": "Optional contact email from the source audience."
+                },
+                "phone": {
+                  "type": "string",
+                  "maxLength": 64,
+                  "description": "Optional contact phone from the source audience."
+                },
+                "first_name": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Optional contact first name from the source audience."
+                },
+                "last_name": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Optional contact last name from the source audience."
+                },
                 "lead_last_active_at": {
                   "type": "string",
                   "format": "date-time",
@@ -1492,9 +1528,14 @@
     },
     {
       "name": "besales_getcourse_wave_run_start",
-      "description": "Start a durable GetCourse status-mode wave run for up to 5000 contacts. The run chunks the cohort, waits for the import lock, processes chunks sequentially and survives service restarts; poll one run via besales_getcourse_wave_run_status instead of building waves manually. WITHOUT confirm=true this is a DRY-RUN and no run is created. A real run requires BOTH confirm=true and explicit_confirmation=true. Only launch_type=status is supported; use besales_getcourse_wave_import for board/group. HTTP 409 returns the already active runId for the platform. Scope: mcp:platform-setup.",
+      "description": "Start a durable GetCourse status-mode wave run for up to 5000 contacts. The run chunks the cohort, waits for the import lock, processes chunks sequentially and survives service restarts; poll one run via besales_getcourse_wave_run_status instead of building waves manually. WITHOUT confirm=true this is a DRY-RUN and no run is created. A real run requires confirm=true, explicit_confirmation=true, a stable launch_key and dry_run_hash from the latest dry-run. Reuse the same launch_key for retries of one intent. Only launch_type=status is supported; use besales_getcourse_wave_import for board/group. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
+        "dependentRequired": {
+          "segment_description": [
+            "segment"
+          ]
+        },
         "required": [
           "platform_id",
           "crm_id",
@@ -1517,6 +1558,16 @@
             "format": "uuid",
             "description": "GetCourse CRM uuid."
           },
+          "launch_key": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable UUID for one launch intent. Required when confirm=true; reuse it for HTTP/network retries."
+          },
+          "dry_run_hash": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "Hash returned by the latest dry-run. Required when confirm=true."
+          },
           "launch_type": {
             "type": "string",
             "enum": [
@@ -1542,11 +1593,21 @@
             "maxLength": 200,
             "description": "Wave segment label for analytics."
           },
+          "segment_description": {
+            "type": "string",
+            "maxLength": 4000,
+            "description": "Explicit business rule for segment selection. Requires segment; creates or updates its saved description."
+          },
           "cohort_label": {
             "type": "string",
             "maxLength": 200,
             "description": "Human-readable name of this concrete run."
           },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "ID of an active named mailing variant for comparative analytics."
+          },
           "message_variant": {
             "type": "string",
             "maxLength": 120,
@@ -1579,7 +1640,7 @@
                 "null"
               ]
             },
-            "description": "status mode: { \"<numeric fieldId>\": value } applied to every contact's deal."
+            "description": "Optional manual override: { \"<numeric fieldId>\": value }. Saved platform field bindings are used when omitted."
           },
           "contacts": {
             "type": "array",
@@ -1608,6 +1669,27 @@
                   "type": "string",
                   "description": "Optional GetCourse dialog id (resp_id)."
                 },
+                "email": {
+                  "type": "string",
+                  "format": "email",
+                  "maxLength": 320,
+                  "description": "Optional contact email from the source audience."
+                },
+                "phone": {
+                  "type": "string",
+                  "maxLength": 64,
+                  "description": "Optional contact phone from the source audience."
+                },
+                "first_name": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Optional contact first name from the source audience."
+                },
+                "last_name": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Optional contact last name from the source audience."
+                },
                 "lead_last_active_at": {
                   "type": "string",
                   "format": "date-time",
@@ -1624,7 +1706,7 @@
           },
           "confirm": {
             "type": "boolean",
-            "description": "Without true the call is a DRY-RUN: no run is created and nothing is sent."
+            "description": "Without true the call is a DRY-RUN. true also requires launch_key, dry_run_hash and explicit_confirmation=true."
           },
           "check_messenger_presence": {
             "type": "boolean",
@@ -1691,7 +1773,7 @@
             "enum": [
               true
             ],
-            "description": "Required together with confirm=true for a real run. MCP-only safety gate; not sent to the backend."
+            "description": "Required with confirm=true together with launch_key and dry_run_hash. MCP-only safety gate; not sent to the backend."
           },
           "confirmation_reason": {
             "type": "string",
@@ -1794,6 +1876,342 @@
         "additionalProperties": false
       }
     },
+    {
+      "name": "besales_getcourse_wave_run_batch_start",
+      "description": "Start an idempotent GetCourse status-mode wave-run batch with 1..10 sequential segments (at most 2000 contacts per segment and 5000 total). Generate batch_key once per attempt and reuse it for retries: the same key returns the existing batch, while a new key creates a second campaign. A changed composition with the same key returns HTTP 409. Only batch-level platform_id, crm_id and confirm are accepted. WITHOUT confirm=true this is a DRY-RUN. A real launch also requires MCP-only explicit_confirmation=true. Poll only besales_getcourse_wave_run_batch_status. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "batch_key",
+          "platform_id",
+          "crm_id",
+          "segments"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — resolved from the connected session."
+          },
+          "batch_key": {
+            "type": "string",
+            "description": "Idempotency key. Generate it once for this attempt and reuse it unchanged for every retry."
+          },
+          "platform_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "GetCourse platform uuid; valid only at batch level."
+          },
+          "crm_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "GetCourse CRM uuid; valid only at batch level."
+          },
+          "segments": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 10,
+            "description": "Sequential status-mode segments. At most 2000 contacts per segment and 5000 contacts across the whole batch.",
+            "items": {
+              "type": "object",
+              "dependentRequired": {
+                "segment_description": [
+                  "segment"
+                ]
+              },
+              "required": [
+                "contacts",
+                "channels",
+                "deal_fields"
+              ],
+              "properties": {
+                "launch_type": {
+                  "type": "string",
+                  "enum": [
+                    "status"
+                  ],
+                  "description": "Only status mode is supported. Optional: the server defaults to status."
+                },
+                "contacts": {
+                  "type": "array",
+                  "minItems": 1,
+                  "maxItems": 2000,
+                  "description": "Cohort of this segment.",
+                  "items": {
+                    "type": "object",
+                    "required": [
+                      "contact_id"
+                    ],
+                    "properties": {
+                      "contact_id": {
+                        "type": "string",
+                        "description": "GetCourse user id."
+                      },
+                      "deal_id": {
+                        "type": "string",
+                        "description": "Optional order id to pin."
+                      },
+                      "transport": {
+                        "type": "string",
+                        "description": "Optional known transport of the contact."
+                      },
+                      "dialog_id": {
+                        "type": "string",
+                        "description": "Optional GetCourse dialog id (resp_id)."
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "maxLength": 320,
+                        "description": "Optional contact email from the source audience."
+                      },
+                      "phone": {
+                        "type": "string",
+                        "maxLength": 64,
+                        "description": "Optional contact phone from the source audience."
+                      },
+                      "first_name": {
+                        "type": "string",
+                        "maxLength": 200,
+                        "description": "Optional contact first name from the source audience."
+                      },
+                      "last_name": {
+                        "type": "string",
+                        "maxLength": 200,
+                        "description": "Optional contact last name from the source audience."
+                      },
+                      "lead_last_active_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "description": "Legacy ISO timestamp of the lead's last activity."
+                      },
+                      "segment_entered_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "description": "Exact ISO timestamp when the contact entered this segment."
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                },
+                "channels": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "minItems": 1,
+                  "description": "Wave channels (GetCourseTransport: VK|Telegram|MAX|SMS|Email|Site) for analytics."
+                },
+                "deal_fields": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "null"
+                    ]
+                  },
+                  "description": "status mode: { \"<numeric fieldId>\": value } applied to every contact's deal."
+                },
+                "funnel": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Canonical business-funnel key/name for analytics."
+                },
+                "segment": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Segment label for analytics."
+                },
+                "segment_description": {
+                  "type": "string",
+                  "maxLength": 4000,
+                  "description": "Explicit business rule for segment selection. Requires segment; creates or updates its saved description."
+                },
+                "cohort_label": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Human-readable name of this concrete segment run."
+                },
+                "mailing_variant_id": {
+                  "type": "string",
+                  "format": "uuid",
+                  "description": "ID of an active named mailing variant for this segment run."
+                },
+                "message_variant": {
+                  "type": "string",
+                  "maxLength": 120,
+                  "description": "Welcome-message variant for segment analytics."
+                },
+                "found_count": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 10000000,
+                  "description": "Contacts found in the source before deduplication and filters."
+                },
+                "product_code": {
+                  "type": "string",
+                  "maxLength": 100,
+                  "pattern": "^[^\\s/]+$",
+                  "description": "Product code for the funnel→product analytics dictionary."
+                },
+                "product_name": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Display name of the analytics product."
+                },
+                "preflight": {
+                  "type": "object",
+                  "description": "Per-contact pre-send gate.",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean",
+                      "description": "false disables the row-level preflight gate."
+                    },
+                    "product_title": {
+                      "type": "string",
+                      "maxLength": 500,
+                      "description": "Human product title used to build the match key."
+                    },
+                    "product_match_key": {
+                      "type": "string",
+                      "maxLength": 500,
+                      "description": "Pre-normalized product match key."
+                    },
+                    "offer_id": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "description": "Optional GetCourse offer id."
+                    },
+                    "other_product_active_deal_mode": {
+                      "type": "string",
+                      "enum": [
+                        "warn",
+                        "block",
+                        "ignore"
+                      ],
+                      "description": "How to handle an active deal for another product."
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "check_messenger_presence": {
+                  "type": "boolean",
+                  "description": "Whether to skip contacts without Telegram/Max/VK messenger presence."
+                },
+                "dedup_window_days": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 365,
+                  "description": "Deduplication window in days. 0 is forbidden for batched wave runs."
+                },
+                "dedup_scope": {
+                  "type": "string",
+                  "enum": [
+                    "any",
+                    "same_funnel"
+                  ],
+                  "description": "Deduplicate against any wave or only the same canonical funnel."
+                },
+                "chunk_size": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 500,
+                  "description": "Contacts per sequential durable-run chunk."
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "confirm": {
+            "type": "boolean",
+            "description": "Without true the call is a DRY-RUN: no batch is created and nothing is sent. Valid only at batch level."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "enum": [
+              true
+            ],
+            "description": "Required together with confirm=true for a real batch. MCP-only safety gate; not sent to the backend."
+          },
+          "confirmation_reason": {
+            "type": "string",
+            "description": "Optional human-readable reason accompanying explicit confirmation; not sent to the backend."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_getcourse_wave_run_batch_status",
+      "description": "Get the aggregate status of an idempotent GetCourse wave-run batch. The queue runs segments sequentially with only one run on the platform; poll this one endpoint instead of collecting segment statuses manually. A batch pauses after two consecutive rejected segments and is resumed with besales_getcourse_wave_run_batch_resume. UNKNOWN and FAILED contacts are never retried automatically. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "batch_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — resolved from the connected session."
+          },
+          "batch_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Wave-run batch uuid returned by besales_getcourse_wave_run_batch_start."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_getcourse_wave_run_batch_cancel",
+      "description": "Cancel a GetCourse wave-run batch. Then poll only besales_getcourse_wave_run_batch_status for the aggregate queue state; do not collect segment statuses manually. UNKNOWN and FAILED contacts are never retried automatically. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "batch_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — resolved from the connected session."
+          },
+          "batch_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Wave-run batch uuid."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_getcourse_wave_run_batch_resume",
+      "description": "Resume a paused GetCourse wave-run batch after two consecutive rejected segments. The queue continues sequentially with one run on the platform; poll only besales_getcourse_wave_run_batch_status. UNKNOWN and FAILED contacts are never retried automatically. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "batch_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — resolved from the connected session."
+          },
+          "batch_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Paused wave-run batch uuid."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
     {
       "name": "besales_wazzup_templates_list",
       "description": "List approved WABA templates of a Wazzup platform with usability flags. Returns templateGuid, title, Meta moderation status, bodyText, variableCount (values required) and usable + unsupportedReasons. Only usable=true templates can be sent in a wave; the rest are unapproved or carry a media header / variable URL button, where values would land in the wrong slots. Scope: mcp:platform-setup.",
@@ -3622,21 +4040,136 @@
                   "null"
                 ]
               },
-              "field_variable_map": {
+              "wave_field_bindings": {
                 "type": [
-                  "array",
+                  "object",
                   "null"
                 ],
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "getcourse_field_name": {
-                      "type": "string"
-                    },
-                    "variable_name": {
-                      "type": "string"
-                    }
-                  },
+                "description": "School-scoped bindings of durable-wave roles to GetCourse deal custom-field IDs. Null clears all bindings.",
+                "additionalProperties": false,
+                "properties": {
+                  "product_value_source": {
+                    "type": "string",
+                    "enum": [
+                      "CODE",
+                      "NAME"
+                    ]
+                  },
+                  "launch_type": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "field_id": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 2147483647
+                      },
+                      "field_label": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field_id",
+                      "field_label"
+                    ]
+                  },
+                  "product": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "field_id": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 2147483647
+                      },
+                      "field_label": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field_id",
+                      "field_label"
+                    ]
+                  },
+                  "segment": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "field_id": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 2147483647
+                      },
+                      "field_label": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field_id",
+                      "field_label"
+                    ]
+                  },
+                  "funnel": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "field_id": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 2147483647
+                      },
+                      "field_label": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field_id",
+                      "field_label"
+                    ]
+                  },
+                  "channels": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "field_id": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 2147483647
+                      },
+                      "field_label": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "required": [
+                      "field_id",
+                      "field_label"
+                    ]
+                  }
+                },
+                "required": [
+                  "product_value_source"
+                ]
+              },
+              "field_variable_map": {
+                "type": [
+                  "array",
+                  "null"
+                ],
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "getcourse_field_name": {
+                      "type": "string"
+                    },
+                    "variable_name": {
+                      "type": "string"
+                    }
+                  },
                   "required": [
                     "getcourse_field_name",
                     "variable_name"
@@ -3999,6 +4532,54 @@
         }
       }
     },
+    {
+      "name": "besales_prompt_headroom",
+      "description": "Сколько символов занимает промпт агента, сколько осталось до лимитов PromptLint (hard_fail 80000 / warn 40000) и вес разделов по «## ». Зови ПЕРЕД сборкой черновика: линтер срабатывает только на besales_prompt_patch_commit, и без этого перебор лимита выясняется уже после применения операций. Признак перебора — exceedsHardLimit; ровно на лимите (hardHeadroom=0) commit ещё проходит. `draft_id` — измерить черновик вместо закоммиченного промпта; черновик обязан принадлежать этому же агенту, иначе 404. Endpoint: GET /api/v2/agents/{agentId}/prompt/headroom. Scope: read:prompt-drafts.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "agent_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "draft_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_diff",
+      "description": "Расхождение закоммиченных промптов двух агентов одного workspace: `identicalBytes` (тексты совпадают побайтово — значит один и тот же набор patch-операций найдёт те же якоря; это НЕ гарантия одинакового исхода commit, lint резолвит канал каждого агента отдельно), `identicalNormalized` (различие только в пробелах), `onlyInBase` / `onlyInCompare` — строки, которых нет на другой стороне, с кратностями. Зови вместо чтения двух промптов целиком: парк из 30+ агентов на одном промпте иначе не влезает в контекст. Порядок строк и перемещения НЕ отслеживаются. Endpoint: POST /api/v2/agents/{agentId}/prompt/diff. Scope: read:prompt-drafts.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "agent_id",
+          "compare_agent_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "compare_agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "max_lines": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 1000
+          }
+        }
+      }
+    },
     {
       "name": "besales_prompt_patch_apply",
       "description": "S3.8: применяет batch operations к draft.currentContent. Resets TTL на 24h (activity-based). Возвращает `appliedCount` + `skippedCount` (anchor не найден / growth guard >30%). Endpoint: PATCH /api/v2/agents/{agentId}/prompt/drafts/{draftId}/operations. Scope: write:prompt-drafts. ВАЖНО: ведущие и замыкающие пробелы/переводы строк в replacement_text срезаются — чтобы вставить пустую строку-разделитель между абзацами, держи перевод строки В СЕРЕДИНЕ replacement_text или включи окружающий текст в anchor/target; иначе соседние заголовки/абзацы склеятся. Ответ возвращает весь обновлённый currentContent (может быть очень большим) — сверяйся по appliedCount/skippedCount, не перечитывай весь контент между батчами.",
@@ -4104,6 +4685,115 @@
         }
       }
     },
+    {
+      "name": "besales_prompt_batch_start",
+      "description": "Раскатывает ОДИН набор patch-операций по НЕСКОЛЬКИМ агентам одного workspace. Используй вместо ручного цикла patch_start→apply→commit: 33 агента × 3 вызова не укладываются в таймаут MCP, поэтому прогон фоновый — тулза возвращает `runId`, статус опрашивается через besales_prompt_batch_status. Две фазы: сначала у ВСЕХ агентов создаётся черновик, применяются операции и прогоняется полный lint; коммитятся только прошедшие. `all_or_nothing=true` — не коммитить никого, если хоть один не прошёл подготовку. `idempotency_key` делает повторный старт безопасным (вернёт тот же прогон). Агенты чужого workspace в прогон не попадают. Endpoint: POST /api/v2/prompt-batch/runs. Scope: write:prompt-drafts.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "agent_ids",
+          "operations"
+        ],
+        "properties": {
+          "agent_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 200,
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          "operations": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": [
+                "type"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "replace_text",
+                    "replace_all_text",
+                    "insert_after_text",
+                    "insert_before_text",
+                    "remove_text",
+                    "move_text_after_text"
+                  ]
+                },
+                "target_text": {
+                  "type": "string"
+                },
+                "anchor_text": {
+                  "type": "string"
+                },
+                "replacement_text": {
+                  "type": "string"
+                },
+                "match_variants": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          },
+          "all_or_nothing": {
+            "type": "boolean"
+          },
+          "idempotency_key": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "platform_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_batch_status",
+      "description": "Статус пакетной раскатки: счётчики по статусам и per-agent исход. `counts.PENDING+PREPARED > 0` — прогон ещё идёт, опроси позже. `SKIPPED` — НЕ ошибка, смотри `skipReason`: AGENT_NOT_FOUND / DRAFT_CONFLICT_OTHER_USER (у агента чужой незакоммиченный черновик) / NO_OPERATIONS_APPLIED (у этого агента промпт другой, якоря не нашлись) / PROMPT_UNCHANGED / ALL_OR_NOTHING_ABORTED. У `FAILED` смотри `errorMessage` и `lintIssues`. Endpoint: GET /api/v2/prompt-batch/runs/{runId}. Scope: read:prompt-drafts.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "run_id"
+        ],
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_batch_resume",
+      "description": "Докатывает прогон: повторяет ТОЛЬКО агентов со статусом FAILED, уже закоммиченных не трогает (повторное применение операций удвоило бы вставки). Нужен, потому что клонированный через GUI агент структурно 409-ит на каждом commit — без докатки такой прогон навсегда остаётся PARTIAL. Отказывает с 400, если прогон ещё выполняется; заброшенный прогон (воркер упал, heartbeat протух) перезанимается. Endpoint: POST /api/v2/prompt-batch/runs/{runId}/resume. Scope: write:prompt-drafts.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "run_id"
+        ],
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
     {
       "name": "besales_prompt_lint",
       "description": "S2.6 extra (v1.5 pipeline rules): standalone lint для текста промпта — позволяет проверить промпт ДО `besales_prompt_finalize`, чтобы избежать цикла «finalize → 400 → fix». Запускает те же чекеры, что и finalize: anti-AI baseline (hard_fail), officialese (warn), markdown в мессенджер-канале (hard_fail), §9 prohibitions / lint paradox (hard_fail), scope-consistency (warn). Если передан `agent_id`, бэкенд резолвит channel и agentScope из `AgentChat`. Endpoint: POST /api/v2/workspaces/{workspaceId}/prompt-lint. Scope: read:prompt-drafts.",
@@ -7309,7 +7999,7 @@
     },
     {
       "name": "besales_broadcast_analytics_get",
-      "description": "Read-only authoritative агрегат страницы /broadcast-analytics по дням и измерениям. Метрики считаются по получателям волн/доставке/событиям, а не по строкам сообщений. Scope: read:analytics.",
+      "description": "Read-only все данные страницы /broadcast-analytics: отчёты, drill-down, справочники сегментов и продуктов, качество данных и подтверждения оплат. Выбери report; общие фильтры совпадают с UI. Scope: read:analytics.",
       "inputSchema": {
         "type": "object",
         "required": [],
@@ -7320,6 +8010,28 @@
             "format": "uuid",
             "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
           },
+          "report": {
+            "type": "string",
+            "enum": [
+              "summary",
+              "cohorts",
+              "skip_reasons",
+              "recipients",
+              "deals",
+              "action_failures",
+              "indirect_payments",
+              "response_windows",
+              "insights",
+              "recent_leads",
+              "data_quality",
+              "segments_catalog",
+              "funnel_products",
+              "payment_candidates",
+              "payment_candidates_summary"
+            ],
+            "default": "summary",
+            "description": "Какой отчёт страницы вернуть. Для recipients нужен recipient_metric, для deals — deal_metric."
+          },
           "mode": {
             "type": "string",
             "enum": [
@@ -7350,40 +8062,280 @@
             "format": "uuid"
           },
           "funnel": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Точная бизнес-воронка волны."
+            "oneOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            ],
+            "description": "Одна или несколько бизнес-воронок волны."
           },
           "funnel_mode": {
             "type": "string",
             "enum": [
               "none"
             ],
-            "description": "Явно выбрать строки без воронки."
+            "description": "Добавить строки без воронки. Можно сочетать с funnel: значения и NULL объединяются через OR."
           },
           "segment": {
-            "type": "string",
-            "minLength": 1
-          },
-          "product": {
-            "type": "string",
-            "minLength": 1
+            "oneOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            ]
           },
-          "product_mode": {
-            "type": "string",
-            "enum": [
-              "none"
+          "mailing_variant_id": {
+            "oneOf": [
+              {
+                "type": "string",
+                "format": "uuid"
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "format": "uuid"
+                }
+              }
             ],
-            "description": "Явно выбрать строки без продукта."
+            "description": "Один или несколько ID именованных вариантов рассылки."
           },
-          "view": {
-            "type": "string",
-            "enum": [
-              "cohort",
+          "product": {
+            "oneOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            ]
+          },
+          "product_mode": {
+            "type": "string",
+            "enum": [
+              "none"
+            ],
+            "description": "Добавить строки без продукта. Можно сочетать с product: значения и NULL объединяются через OR."
+          },
+          "view": {
+            "type": "string",
+            "enum": [
+              "cohort",
               "period"
             ],
             "default": "period",
             "description": "period — по дате события (как вкладка по дням); cohort — по дате запуска волны."
+          },
+          "freshness": {
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "0-7",
+                  "8-14",
+                  "15-30",
+                  "31+"
+                ]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 4,
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "0-7",
+                    "8-14",
+                    "15-30",
+                    "31+"
+                  ]
+                }
+              }
+            ],
+            "description": "Корзины свежести лида; контакты без даты при активном фильтре исключаются."
+          },
+          "channels": {
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "Site",
+                  "Email",
+                  "SMS",
+                  "Telegram",
+                  "Facebook",
+                  "VK",
+                  "Chatium",
+                  "WhatsApp",
+                  "Viber",
+                  "MAX",
+                  "UNKNOWN"
+                ]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 11,
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "Site",
+                    "Email",
+                    "SMS",
+                    "Telegram",
+                    "Facebook",
+                    "VK",
+                    "Chatium",
+                    "WhatsApp",
+                    "Viber",
+                    "MAX",
+                    "UNKNOWN"
+                  ]
+                }
+              }
+            ]
+          },
+          "date": {
+            "type": "string",
+            "format": "date",
+            "description": "День кликнутой ячейки для drill-down/skip_reasons."
+          },
+          "channel": {
+            "type": "string",
+            "enum": [
+              "Site",
+              "Email",
+              "SMS",
+              "Telegram",
+              "Facebook",
+              "VK",
+              "Chatium",
+              "WhatsApp",
+              "Viber",
+              "MAX",
+              "UNKNOWN"
+            ],
+            "description": "Канал кликнутой ячейки drill-down."
+          },
+          "import_job_id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "ID конкретной волны для skip_reasons/drill-down."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200,
+            "description": "До 200 для аналитических drill-down; до 100 для payment_candidates."
+          },
+          "recipient_metric": {
+            "type": "string",
+            "enum": [
+              "sent",
+              "delivered",
+              "entered",
+              "deepDialog",
+              "handedOff",
+              "notDelivered",
+              "notSent"
+            ],
+            "description": "Обязателен для report=recipients."
+          },
+          "deal_metric": {
+            "type": "string",
+            "enum": [
+              "issued",
+              "paid",
+              "withoutCohort"
+            ],
+            "description": "Обязателен для report=deals."
+          },
+          "reason": {
+            "type": "string",
+            "enum": [
+              "NO_MESSENGER",
+              "ACTIVE_INVOICE_SAME_PRODUCT",
+              "ACTIVE_DEAL_SAME_PRODUCT",
+              "PAID_SAME_PRODUCT",
+              "ACTIVE_DEAL_OTHER_PRODUCT",
+              "MANAGER_ASSIGNED_ACTIVE_DEAL",
+              "PRODUCT_CONTEXT_MISSING",
+              "GETCOURSE_CHECK_ERROR",
+              "ALREADY_SENT",
+              "USER_NOT_FOUND"
+            ],
+            "description": "Причина для report=recipients + recipient_metric=notSent."
+          },
+          "action_type": {
+            "type": "string",
+            "description": "Точный ActionType для сужения report=action_failures."
+          },
+          "payment_view": {
+            "type": "string",
+            "enum": [
+              "decidable",
+              "excluded",
+              "resolved"
+            ],
+            "description": "Только для payment_candidates; не сочетать с payment_status/payment_eligibility."
+          },
+          "payment_status": {
+            "type": "string",
+            "enum": [
+              "PENDING",
+              "CONFIRMED",
+              "CONFIRMED_INDIRECT",
+              "REJECTED"
+            ],
+            "description": "Только для payment_candidates без payment_view."
+          },
+          "payment_eligibility": {
+            "type": "string",
+            "enum": [
+              "PENDING_CHECK",
+              "VERIFIED",
+              "VERIFIED_WEAK",
+              "UNVERIFIED",
+              "EXCLUDED_NON_AUTOWEB",
+              "EXCLUDED_PREEXISTING"
+            ],
+            "description": "Только для payment_candidates без payment_view."
+          },
+          "include_archived": {
+            "type": "boolean",
+            "description": "Только для report=payment_candidates."
           }
         }
       }
@@ -7429,8 +8381,21 @@
             "format": "uuid"
           },
           "funnel": {
-            "type": "string",
-            "minLength": 1
+            "oneOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            ]
           },
           "funnel_mode": {
             "type": "string",
@@ -7439,18 +8404,137 @@
             ]
           },
           "segment": {
-            "type": "string",
-            "minLength": 1
+            "oneOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            ]
+          },
+          "mailing_variant_id": {
+            "oneOf": [
+              {
+                "type": "string",
+                "format": "uuid"
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "format": "uuid"
+                }
+              }
+            ]
           },
           "product": {
-            "type": "string",
-            "minLength": 1
+            "oneOf": [
+              {
+                "type": "string",
+                "minLength": 1
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            ]
           },
           "product_mode": {
             "type": "string",
             "enum": [
               "none"
             ]
+          },
+          "freshness": {
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "0-7",
+                  "8-14",
+                  "15-30",
+                  "31+"
+                ]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 4,
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "0-7",
+                    "8-14",
+                    "15-30",
+                    "31+"
+                  ]
+                }
+              }
+            ]
+          },
+          "channels": {
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "Site",
+                  "Email",
+                  "SMS",
+                  "Telegram",
+                  "Facebook",
+                  "VK",
+                  "Chatium",
+                  "WhatsApp",
+                  "Viber",
+                  "MAX",
+                  "UNKNOWN"
+                ]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 11,
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "Site",
+                    "Email",
+                    "SMS",
+                    "Telegram",
+                    "Facebook",
+                    "VK",
+                    "Chatium",
+                    "WhatsApp",
+                    "Viber",
+                    "MAX",
+                    "UNKNOWN"
+                  ]
+                }
+              }
+            ]
+          },
+          "view": {
+            "type": "string",
+            "enum": [
+              "cohort",
+              "period"
+            ],
+            "default": "period"
           }
         }
       }
@@ -7580,6 +8664,16 @@
                   "hidden"
                 ],
                 "description": "note — заметка в таймлайн CRM (безопасно). hidden — скрытое сообщение в открытой линии (клиент не видит; на живом портале НЕ проверено)."
+              },
+              "model": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Модель разбора этого режима. Пусто → общая."
+              },
+              "max_tokens": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Лимит токенов этого режима. Пусто → общий."
               }
             },
             "description": "Саммари дня. Пишется ПОСЛЕ summary_time по локальному времени канала.",
@@ -7623,7 +8717,7 @@
               "min_new_events": {
                 "type": "integer",
                 "minimum": 1,
-                "description": "Порог новых событий: не набрано — разбор не запускается и заметка не пишется."
+                "description": "Порог новых событий: не набрано — разбор не запускается. Независимо от порога разбор идёт только при наличии реплики клиента в окне."
               },
               "output": {
                 "type": "string",
@@ -7632,6 +8726,16 @@
                   "hidden"
                 ],
                 "description": "note — заметка в таймлайн CRM (безопасно). hidden — скрытое сообщение в открытой линии (клиент не видит; на живом портале НЕ проверено)."
+              },
+              "model": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Модель разбора этого режима. Пусто → общая."
+              },
+              "max_tokens": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Лимит токенов этого режима. Пусто → общий."
               }
             },
             "description": "«Статус коммуникации» — раз в час внутри рабочего окна и только при новых сообщениях.",
@@ -7659,7 +8763,7 @@
               "type": "string",
               "minLength": 1
             },
-            "description": "ID воронок CRM. Пусто = без фильтра."
+            "description": "ID воронок CRM. Разбираются ТОЛЬКО перечисленные. Пусто = не выбрано (включённая задача вернёт 400), а НЕ «все»."
           },
           "managers": {
             "type": "array",
@@ -7667,7 +8771,7 @@
               "type": "integer",
               "minimum": 1
             },
-            "description": "ASSIGNED_BY_ID ответственных Bitrix (не наши id — бери из besales_crm_operator_list). Пусто = без фильтра."
+            "description": "ASSIGNED_BY_ID ответственных Bitrix (не наши id — бери из besales_crm_operator_list). Разбираются ТОЛЬКО перечисленные. Пусто = не выбрано (включённая задача вернёт 400), а НЕ «все»."
           },
           "daily_prompt": {
             "type": [
@@ -7675,7 +8779,7 @@
               "null"
             ],
             "minLength": 1,
-            "description": "Переопределение системного промпта саммари дня. Пусто = встроенный (написан под «ткани/производство»). null — СНЯТЬ переопределение (вернуть встроенный промпт)."
+            "description": "Переопределение системного промпта саммари дня. Пусто = встроенный: он доменно-нейтрален, но состав срезов из кейса Lavsit. null — СНЯТЬ переопределение (вернуть встроенный промпт)."
           },
           "hourly_prompt": {
             "type": [
@@ -7691,6 +8795,138 @@
           }
         }
       }
+    },
+    {
+      "name": "besales_broadcast_mailing_variant_list",
+      "description": "Список именованных «Вариантов рассылки» workspace. Активные варианты выбираются для GetCourse-волн; архивные доступны для истории.",
+      "inputSchema": {
+        "type": "object",
+        "required": [],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "include_archived": {
+            "type": "boolean",
+            "description": "Включить архивные варианты для чтения исторических конфигураций."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_broadcast_mailing_variant_create",
+      "description": "Создать или восстановить именованный «Вариант рассылки» с описанием гипотезы, сообщений и GetCourse-процесса.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "name"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 4000
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_broadcast_mailing_variant_update",
+      "description": "Изменить название, описание или архивный статус «Варианта рассылки».",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "mailing_variant_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4000
+          },
+          "archived": {
+            "type": "boolean"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Обязательно true при archived=true после явного подтверждения пользователя."
+          }
+        },
+        "if": {
+          "properties": {
+            "archived": {
+              "const": true
+            }
+          },
+          "required": [
+            "archived"
+          ]
+        },
+        "then": {
+          "required": [
+            "explicit_confirmation"
+          ]
+        }
+      }
+    },
+    {
+      "name": "besales_broadcast_mailing_variant_delete",
+      "description": "Архивировать «Вариант рассылки», сохранив историческую аналитику и ссылки отложенных durable-run.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "mailing_variant_id",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Обязательно true после явного подтверждения пользователя."
+          }
+        }
+      }
     }
   ],
   "resources": [
@@ -7882,9 +9118,9 @@
     }
   ],
   "summary": {
-    "total_tools": 156,
+    "total_tools": 169,
     "tools_by_category": {
-      "getcourse_wave": 6,
+      "getcourse_wave": 10,
       "files_upload": 3,
       "platform_provisioning": 3,
       "crm_provisioning": 6,
@@ -7905,7 +9141,7 @@
       "feedback_sheets": 5,
       "facts_management": 2,
       "prompt_lint_standalone": 1,
-      "prompt_drafts": 5,
+      "prompt_drafts": 7,
       "workbook_ingestion": 3,
       "knowledge_spaces": 6,
       "knowledge_documents": 4,