@besales/mcp 0.47.0 → 0.48.0

package/dist/types/api-contract.gen.d.ts

@@ -7059,13 +7059,15 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * История запусков — наша отправка и волны по файлу одним списком
-         * @description Scope `read:campaigns`.
+         * История запусков — ручная отправка, волны, авторассылка и автоприём одним списком
+         * @description Scope `read:campaigns`. Ручная отправка пакетом — одна строка с `batch`, автоприём регистраций — одна строка на день с `registrationDay`.
          */
         get: {
             parameters: {
                 query?: {
                     mailingVariantId?: string;
+                    /** @description Откуда запуск: manual — ручная отправка, wave — волна по файлу, schedule — авторассылка, registration — автоприём регистраций. Пусто = все четыре. */
+                    origin?: "manual" | "wave" | "schedule" | "registration";
                     limit?: number;
                 };
                 header?: never;
@@ -8000,6 +8002,13 @@ export interface paths {
                         "application/json": components["schemas"]["PlatformSetupMutationResult"];
                     };
                 };
+                /** @description Название триггера уже занято у этого агента */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         delete?: never;
@@ -8074,6 +8083,13 @@ export interface paths {
                         "application/json": components["schemas"]["PlatformSetupMutationResult"];
                     };
                 };
+                /** @description Название триггера уже занято у этого агента */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         trace?: never;
@@ -8406,7 +8422,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["PlatformSetupMutationResult"];
+                        "application/json": components["schemas"]["FollowUpSequenceUpsertResult"];
                     };
                 };
             };
@@ -8452,7 +8468,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["PlatformSetupMutationResult"];
+                        "application/json": components["schemas"]["FollowUpSequenceUpsertResult"];
                     };
                 };
             };
@@ -11470,6 +11486,8 @@ export interface paths {
                     freshness?: components["parameters"]["BroadcastFreshness"];
                     /** @description Мессенджеры волны (транспорты GetCourse + UNKNOWN — канал не определён), мультивыбор. Деньги фильтруются по скалярному каналу сделки. */
                     channels?: components["parameters"]["BroadcastChannels"];
+                    /** @description Чьи деньги показывать. `outbound` — рассылок: органические заказы и карточки оплат с органическим якорем исключены. `inbound` — органических диалогов: без `platformId` это все входящие площадки воркспейса, `channels` читает канал ВХОДЯЩИХ контакта, период — по дате оплаты, волновые измерения у органики пусты. */
+                    origin?: components["parameters"]["BroadcastPaymentOrigin"];
                     /** @description cohort — дата запуска; period — дата события; entry — дата входа в сегмент (segment_entered_at: регистрация, конец серии, предсписок). В entry строки без даты входа выпадают всегда, включая mode=all, а события атрибутируются когортно. */
                     view?: components["parameters"]["BroadcastView"];
                     /** @description Конкретный день кликнутой ячейки (МСК). */
@@ -11629,6 +11647,8 @@ export interface paths {
                     freshness?: components["parameters"]["BroadcastFreshness"];
                     /** @description Мессенджеры волны (транспорты GetCourse + UNKNOWN — канал не определён), мультивыбор. Деньги фильтруются по скалярному каналу сделки. */
                     channels?: components["parameters"]["BroadcastChannels"];
+                    /** @description Чьи деньги показывать. `outbound` — рассылок: органические заказы и карточки оплат с органическим якорем исключены. `inbound` — органических диалогов: без `platformId` это все входящие площадки воркспейса, `channels` читает канал ВХОДЯЩИХ контакта, период — по дате оплаты, волновые измерения у органики пусты. */
+                    origin?: components["parameters"]["BroadcastPaymentOrigin"];
                     /** @description cohort — дата запуска; period — дата события; entry — дата входа в сегмент (segment_entered_at: регистрация, конец серии, предсписок). В entry строки без даты входа выпадают всегда, включая mode=all, а события атрибутируются когортно. */
                     view?: components["parameters"]["BroadcastView"];
                     /** @description Конкретный день кликнутой ячейки (МСК). */
@@ -11709,6 +11729,8 @@ export interface paths {
                     freshness?: components["parameters"]["BroadcastFreshness"];
                     /** @description Мессенджеры волны (транспорты GetCourse + UNKNOWN — канал не определён), мультивыбор. Деньги фильтруются по скалярному каналу сделки. */
                     channels?: components["parameters"]["BroadcastChannels"];
+                    /** @description Чьи деньги показывать. `outbound` — рассылок: органические заказы и карточки оплат с органическим якорем исключены. `inbound` — органических диалогов: без `platformId` это все входящие площадки воркспейса, `channels` читает канал ВХОДЯЩИХ контакта, период — по дате оплаты, волновые измерения у органики пусты. */
+                    origin?: components["parameters"]["BroadcastPaymentOrigin"];
                     /** @description cohort — дата запуска; period — дата события; entry — дата входа в сегмент (segment_entered_at: регистрация, конец серии, предсписок). В entry строки без даты входа выпадают всегда, включая mode=all, а события атрибутируются когортно. */
                     view?: components["parameters"]["BroadcastView"];
                     /** @description Конкретный день кликнутой ячейки (МСК). */
@@ -12060,6 +12082,8 @@ export interface paths {
                     freshness?: components["parameters"]["BroadcastFreshness"];
                     /** @description Мессенджеры волны (транспорты GetCourse + UNKNOWN — канал не определён), мультивыбор. Деньги фильтруются по скалярному каналу сделки. */
                     channels?: components["parameters"]["BroadcastChannels"];
+                    /** @description Чьи деньги показывать. `outbound` — рассылок: органические заказы и карточки оплат с органическим якорем исключены. `inbound` — органических диалогов: без `platformId` это все входящие площадки воркспейса, `channels` читает канал ВХОДЯЩИХ контакта, период — по дате оплаты, волновые измерения у органики пусты. */
+                    origin?: components["parameters"]["BroadcastPaymentOrigin"];
                     /** @description Сегмент очереди. `resolved` = `confirmed` + `rejected` одним списком; UI пользуется раздельными сегментами, выгрузке чаще нужен общий. */
                     view?: "decidable" | "external_mailing" | "excluded" | "confirmed" | "rejected" | "resolved" | "potential";
                     /** @description Режим атрибуции для сегмента `potential`: `cohort` датирует по волне, `period` — по оплате. Отдельное имя потому, что `view` занят сегмент-переключателем; остальные сегменты параметр игнорируют. */
@@ -12139,6 +12163,8 @@ export interface paths {
                     freshness?: components["parameters"]["BroadcastFreshness"];
                     /** @description Мессенджеры волны (транспорты GetCourse + UNKNOWN — канал не определён), мультивыбор. Деньги фильтруются по скалярному каналу сделки. */
                     channels?: components["parameters"]["BroadcastChannels"];
+                    /** @description Чьи деньги показывать. `outbound` — рассылок: органические заказы и карточки оплат с органическим якорем исключены. `inbound` — органических диалогов: без `platformId` это все входящие площадки воркспейса, `channels` читает канал ВХОДЯЩИХ контакта, период — по дате оплаты, волновые измерения у органики пусты. */
+                    origin?: components["parameters"]["BroadcastPaymentOrigin"];
                 };
                 header?: never;
                 path: {
@@ -20473,6 +20499,11 @@ export interface components {
             contactId: string;
             /** @description Пин заказа для штампа полей сделки. */
             dealId?: string;
+            /**
+             * Format: date-time
+             * @description Момент регистрации, по которой человек попал в сегмент (ISO 8601, зона ОБЯЗАТЕЛЬНА): предохранитель держит только заявки и оплаты после этой регистрации, более ранние не держат. Не передан — заявки и оплаты судятся за всю историю человека (с 15.09.2026).
+             */
+            registeredAt?: string;
             /**
              * Format: date-time
              * @description Точный момент входа контакта в когорту (ISO 8601, зона ОБЯЗАТЕЛЬНА — …Z либо ±ЧЧ:ММ). На нём считается свежесть в «Аналитике рассылок»: возраст = время отправки минус segmentEnteredAt. Заполняется, когда предсписок собран ПРАВИЛОМ и у каждой строки есть свой момент события (например eventAt регистрации). Не передан — возраст строки остаётся неизвестным. Дату запуска сюда подставлять нельзя: она схлопнула бы месяцы когорт в одну корзину.
@@ -20520,10 +20551,12 @@ export interface components {
                     alreadyGreeted: number;
                     /** @description Идёт эпизод регистрации: приветствие ДОЛЖНЫ и не отдали либо подготовлен повторный вход на новый эфир. Считается ПО ЧЕЛОВЕКУ, без скоупа площадки. */
                     activeEpisode: number;
+                    /** @description Пауза повтора сегмента (с 16.09.2026): этим сегментом человеку уже писали, после отправки он зарегистрировался снова, и расписание повторит ему сегмент, но пауза после прошлой отправки ещё не прошла. Только у запуска расписания с включённым повтором; у ручного запуска всегда 0. */
+                    resendPause: number;
                     /** @description Тихий период: человека трогали (нашей отправкой либо шагом календарной цепочки) внутри окна. Окно резолвится настройками — перекрытие рассылки, затем площадка, затем воркспейс, затем 0. По умолчанию 0, то есть правило выключено, пока оператор его не выставит; рекомендация — 7 суток. Волна школы касанием НЕ считается. Расписания судятся своим cooldownDays. */
                     cooldown: number;
                 };
-                /** @description Тот же ТЕКСТ уже занят в журнале касаний под ДРУГИМ ярлыком. Отдельно от blockedBy: это не правило владельца, а атомарное право — «тот же текст не дважды» держится строкой журнала, а не читающей проверкой. */
+                /** @description Касание этого сегмента уже занято в журнале касаний под другим именем (строка продолжения до 16.09.2026, старое продолжение этим текстом без ярлыка) либо тот же ТЕКСТ уходил человеку любым сегментом меньше трёх суток назад. Только у продолжения расписания; отдельно от blockedBy: claim журнала такие строки не видит, их держит читающая проверка. */
                 touchClaimed: number;
                 /** @description ИНФОРМАЦИЯ, а не запрет: этим же ярлыком человека рассылал ВНЕШНИЙ механизм — волна школы своими процессами либо шаблон Wazzup. Наш догон в мессенджерах уйдёт как обычно: так работает штатный процесс. В отсев это число НЕ входит. */
                 externalWaveTouched: number;
@@ -20775,11 +20808,47 @@ export interface components {
             } | null;
             /** @description Сколько отправок ушло ВСЛЕПУЮ: канал взят резервным транспортом площадки, а не доказан привязками контакта или его ответом. Это ПОДМНОЖЕСТВО sentCount, а не отдельный исход — сообщение ушло. Без него «доставлено в мессенджер» и «упало в личный кабинет сайта» в истории неразличимы. null — у волн (отправляет процесс школы) и у запусков до появления счётчика; это НЕ то же, что 0. */
             sentWithoutChannelEvidence?: number | null;
+            /** @description Ручная отправка пакетом: id строки = batchId, блоки — внутри. Null у одиночной отправки (и у пакета из одного блока), волн, авторассылки и автоприёма. У такой строки tracedOutcomes — null: поимённый разбор у блоков. */
+            batch?: components["schemas"]["BroadcastLaunchBatch"] | null;
+            /** @description Автоприём регистраций за день. sentCount = totalContacts = отправлено за день; status=running значит «день ещё идёт». Null у остальных источников. */
+            registrationDay?: components["schemas"]["BroadcastLaunchRegistrationDay"] | null;
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
             completedAt?: string | null;
         };
+        BroadcastLaunchBatch: {
+            /** Format: uuid */
+            batchId: string;
+            /** @description Блоки в порядке исполнения, включая ещё не стартовавшие. */
+            blocks: components["schemas"]["BroadcastLaunchBatchBlock"][];
+        };
+        BroadcastLaunchBatchBlock: {
+            position: number;
+            /** @description Задача блока; null — блок ещё не стартовал. */
+            importJobId: string | null;
+            segment?: string | null;
+            productCode?: string | null;
+            funnel?: string | null;
+            /** @enum {string} */
+            status: "pending" | "running" | "completed" | "cancelled" | "failed";
+            totalContacts: number;
+            sentCount: number;
+            failedCount: number;
+            outcomes?: {
+                [key: string]: number;
+            } | null;
+            tracedOutcomes?: {
+                [key: string]: number;
+            } | null;
+        };
+        BroadcastLaunchRegistrationDay: {
+            /**
+             * Format: date
+             * @description Календарный день МСК корзины
+             */
+            day: string;
+        };
         BroadcastLaunchesPage: {
             items: components["schemas"]["BroadcastLaunch"][];
             hasMore: boolean;
@@ -20970,6 +21039,20 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        FollowUpSequenceUpsertResult: components["schemas"]["PlatformSetupMutationResult"] & {
+            /** @description Предупреждения к записанной цепочке. Поле есть, только когда предупреждения есть; запись при этом УЖЕ выполнена — повторять вызов не нужно. */
+            warnings?: components["schemas"]["FollowUpStatusModeWarning"][];
+        };
+        /** @description Режим отбора «по статусу CRM» (filterMode=status или поле не задано) на этой площадке никого не выберет. Не запрет: по настройкам нельзя предсказать, что статусы не появятся. */
+        FollowUpStatusModeWarning: {
+            /**
+             * @description NO_ACTIVE_CRM — в воркспейсе нет активной CRM; NO_CONTACT_STATUSES — контакты на площадке есть, но ни у одного нет статуса CRM.
+             * @enum {string}
+             */
+            code: "FOLLOW_UP_STATUS_MODE_NO_ACTIVE_CRM" | "FOLLOW_UP_STATUS_MODE_NO_CONTACT_STATUSES";
+            /** @description Самодостаточное объяснение с альтернативами (eventType или variable). */
+            message: string;
+        };
         TriggerActionCatalogItem: {
             actionType: string;
             title: string;
@@ -21214,7 +21297,9 @@ export interface components {
             updatedAt?: string;
         };
         TriggerUpsertRequest: components["schemas"]["ConfirmableSetupMutation"] & {
+            /** @description Название, уникальное в рамках агента. Потолок общий с формой интерфейса — канон AGENT_TRIGGER_NAME_MAX_LENGTH (ai-aniomaly/src/core/application/tools/constants/agent-trigger.constants.ts). */
             name?: string;
+            /** @description Условие срабатывания; уходит в системный промпт агента целиком. Потолок общий с формой интерфейса — канон AGENT_TRIGGER_CONDITION_MAX_LENGTH (ai-aniomaly/src/core/application/tools/constants/agent-trigger.constants.ts). */
             condition?: string;
             isEnabled?: boolean;
             priority?: number;
@@ -21681,6 +21766,8 @@ export interface components {
                 guardPaid?: components["schemas"]["OutboundGuardMode"];
                 /** @description Quiet period in days after ANY touch OF OURS (a send or a calendar-chain follow-up step). Counted PER PERSON across the workspace; a school wave does NOT count as a touch (measured: the wide perimeter would have blocked 15.3% of our sends). null = not configured, effective value 0 (rule disabled); the owner recommends 7. Schedules are NOT judged by this number — they have their own cooldownDays. */
                 quietDays?: number | null;
+                /** @description How many days the school's "no linked messengers" answer stays trusted. While it is fresh, the contact import neither creates a card nor asks the school again, and schedule selection does not feed that person. null = not configured, effective value 7; 0 = ask the school every time. */
+                reachabilityTtlDays?: number | null;
                 /** @description Transport → exact deal custom field NAME (read API returns no field ids). Clear with {}. */
                 deliveryFieldMap?: {
                     [key: string]: string;
@@ -24945,7 +25032,7 @@ export interface components {
             name: string;
             /** @description Латиница, цифры, дефис, подчёркивание. Уникален в воркспейсе. */
             slug: string;
-            /** @description Абсолютный http(s)-адрес; иные схемы отвергаются. В ЗНАЧЕНИЯ query-параметров можно подставлять переменные контакта: {firstName}, {lastName}, {fullName}, {username}, {email}, {phone}, {getcourseUserId}, {getcourseDealId} — например ?email={email}&param1={getcourseUserId}&autologin=1. Переменная обязана составлять ЦЕЛОЕ значение параметра; в хосте, пути, фрагменте, имени параметра или вперемешку с текстом она отвергается (400). Подстановка происходит при ОТПРАВКЕ через плейсхолдер {{link:slug}}: в анонимном staticUrl переменные вычищаются, потому что за ним нет конкретного человека. Пустое у контакта значение убирает параметр из адреса целиком. */
+            /** @description Абсолютный http(s)-адрес; иные схемы отвергаются. В ЗНАЧЕНИЯ query-параметров можно подставлять переменные контакта: {firstName}, {lastName}, {fullName}, {username}, {email}, {phone}, {getcourseUserId}, {getcourseDealId}, а также номер шага дожима {followUpStep} (p1, p2… — вне дожима параметр выпадает) — например ?email={email}&param1={getcourseUserId}&autologin=1. Переменная обязана составлять ЦЕЛОЕ значение параметра; в хосте, пути, фрагменте, имени параметра или вперемешку с текстом она отвергается (400). Подстановка происходит при ОТПРАВКЕ через плейсхолдер {{link:slug}}: в анонимном staticUrl переменные вычищаются, потому что за ним нет конкретного человека. Пустое у контакта значение убирает параметр из адреса целиком. */
             targetUrl: string;
             productCode?: string;
         };
@@ -26778,6 +26865,8 @@ export interface components {
             isConstant: boolean | null;
             /** @description CHANNEL scope (isConstant=true) only */
             constantValue: string | null;
+            /** @description Value substituted instead of constantValue for a person we have already written to — cold mailings only (e.g. "это снова Светлана." instead of the full introduction). CHANNEL scope constants only; null otherwise. Absent in responses of backends before 16.09.2026. */
+            repeatConstantValue?: string | null;
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
@@ -26805,6 +26894,8 @@ export interface components {
             isConstant?: boolean;
             /** @description Required when scope=CHANNEL AND isConstant=true */
             constantValue?: string;
+            /** @description CHANNEL scope with isConstant=true only. Value for a person we have already written to (cold mailings only). No curly braces; empty string or null — no value. */
+            repeatConstantValue?: string | null;
         };
         UpdateVariableRequest: {
             /** @enum {string} */
@@ -26820,6 +26911,8 @@ export interface components {
             value?: string | null;
             /** @description CHANNEL scope only; null clears */
             constantValue?: string | null;
+            /** @description CHANNEL scope constants only (checked against the stored variable). Value for a person we have already written to (cold mailings only). No curly braces; empty string or null clears. Unsetting isConstant clears it. */
+            repeatConstantValue?: string | null;
         };
         DeleteVariableRequest: {
             /** @enum {string} */
@@ -27329,6 +27422,8 @@ export interface components {
         BroadcastFreshness: ("0-7" | "8-14" | "15-30" | "31-45" | "46-60" | "61+")[];
         /** @description Мессенджеры волны (транспорты GetCourse + UNKNOWN — канал не определён), мультивыбор. Деньги фильтруются по скалярному каналу сделки. */
         BroadcastChannels: string[];
+        /** @description Чьи деньги показывать. `outbound` — рассылок: органические заказы и карточки оплат с органическим якорем исключены. `inbound` — органических диалогов: без `platformId` это все входящие площадки воркспейса, `channels` читает канал ВХОДЯЩИХ контакта, период — по дате оплаты, волновые измерения у органики пусты. */
+        BroadcastPaymentOrigin: "outbound" | "inbound";
         /** @description cohort — дата запуска; period — дата события; entry — дата входа в сегмент (segment_entered_at: регистрация, конец серии, предсписок). В entry строки без даты входа выпадают всегда, включая mode=all, а события атрибутируются когортно. */
         BroadcastView: "cohort" | "period" | "entry";
         /** @description Конкретный день кликнутой ячейки (МСК). */

package/docs/agent-usage-guide.ru.md

@@ -114,6 +114,11 @@ npx -y @besales/mcp connect
   он вдруг попросит вставить пароль прямо в переписку, **не делай этого** — это ошибка.
 - Перед удалением или перезаписью он спрашивает подтверждение — прочитай, что именно
   удаляется, прежде чем согласиться.
+- **Перед любой правкой он переспрашивает.** Меняет промпт, дожимы, поведение, триггеры,
+  расписание или выключает что-то — сначала одним сообщением перечислит все правки: что, где,
+  зачем и что изменится для клиента, и спросит «делать?». Одним вопросом на весь список, а не по
+  одному. Пока не ответишь — не пишет. «Настрой сам» согласием не считается. Читать и показывать
+  он может без спроса.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besales/mcp",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "Model Context Protocol server for Animaly / Besales",
   "license": "MIT",
   "homepage": "https://github.com/be-sales/mcp#readme",