@besales/mcp 0.47.1 → 1.0.0-beta.2

package/dist/tools/definitions/shared.js

@@ -1,11 +1,17 @@
-// Schemas, helpers, snake→camel mappers and the ToolDefinition contract
-// shared by all definition modules. Split out of the former monolithic
-// definitions.ts to keep each file under the 1200-line project limit.
+import { compactObject } from './shared-input.helpers.js';
+import { instagramCommentTemplatesSchema } from './instagram-comment.templates.js';
+// Общие схемы, перевод snake→camel и контракт ToolDefinition отделены от общего списка определений: единая форма между модулями и ограничение размера каждого файла.
 import { z } from 'zod';
+import { MESSAGE_FILTER_SOURCE_MAX_LENGTH, MESSAGE_FILTER_TARGET_MAX_LENGTH, } from '../../shared/constants/message-filter.constants.js';
+import { platformGetcourseWaveFieldBindingsSchema } from './platform-getcourse-wave-field-bindings.js';
+import { PLATFORM_FINISH_AUTO_MAX_DAYS } from './platform-settings-limits.js';
+import { platformWidgetPageRulesSchema } from './platform-widget-page-rules.schema.js';
 export const uuidSchema = z.string().uuid();
+/** Preserved knowledge-space IDs keep hex 8-4-4-4-12 without RFC version/variant constraints. */
+export const knowledgeSpaceIdSchema = z.guid().meta({ format: 'uuid' });
 export const anyObjectSchema = z.object({}).passthrough();
 export const optionalAnyObjectSchema = anyObjectSchema.optional();
-export const outcomeSchema = z.enum(['won', 'lost', 'in_progress']);
+export const outcomeSchema = z.enum(['won', 'lost', 'in_progress', 'unknown']);
 export const platformSetupConfirmationSchema = {
     explicit_confirmation: z.boolean().optional(),
     confirmation_reason: z.string().optional(),
@@ -20,12 +26,26 @@ export const PROMPT_DIFF_MAX_LINES_LIMIT = 1000;
  * Больший `limit` сервер отвергнет валидацией, поэтому граница объявлена и здесь.
  */
 export const VARIABLES_MAX_PAGE_SIZE = 200;
-/** Максимальный размер явно запрошенной страницы списка агентов платформы. */
-export const PLATFORM_AGENTS_MAX_PAGE_SIZE = 200;
+/**
+ * Верхняя граница страницы перечня агентов канала — совпадает с `CHANNEL_AGENTS_LIST_MAX_LIMIT`
+ * бэкенда. Умолчания у самой ручки нет: без `limit` перечень приходит целиком.
+ */
+export const CHANNEL_AGENTS_MAX_PAGE_SIZE = 200;
+/** Верхняя граница страницы сценариев ICP — совпадает с `ICP_SCENARIOS_LIST_MAX_LIMIT` бэкенда. */
+export const ICP_SCENARIOS_MAX_PAGE_SIZE = 200;
+/** Верхняя граница страницы воронок и стадий — совпадает с `CRM_PIPELINES_LIST_MAX_LIMIT` бэкенда. */
+export const CRM_PIPELINES_MAX_PAGE_SIZE = 200;
+/** Верхняя граница страницы цепочек дожима — совпадает с `FOLLOWUP_SEQUENCES_LIST_MAX_LIMIT`. */
+export const FOLLOWUP_SEQUENCES_MAX_PAGE_SIZE = 200;
 /** Потолок агентов в одном пакетном прогоне — должен совпадать с `PROMPT_BATCH_MAX_AGENTS`. */
 export const PROMPT_BATCH_MAX_AGENTS = 200;
 /** Длина ключа идемпотентности пакетного прогона — должна совпадать с DTO бэкенда. */
 export const PROMPT_BATCH_IDEMPOTENCY_KEY_MAX_LENGTH = 200;
+/**
+ * Потолок срока доверия ответу школы (сутки). Совпадает с сервером: иначе мост пропустил бы
+ * значение, которое сервер отвергает, либо наоборот.
+ */
+export const GETCOURSE_REACHABILITY_TTL_DAYS_MAX = 365;
 /**
  * Одна patch-операция промпта. Общая для `besales_prompt_patch_apply` и
  * `besales_prompt_batch_start`: две копии разъехались бы при добавлении нового типа.
@@ -85,9 +105,8 @@ export const apiKeyPlatformTypeSchema = z.enum([
 ]);
 // v1.5 Increment 5b Phase 2 — OAuth-каналы (авторизация в браузере, код мимо LLM).
 export const oauthPlatformTypeSchema = z.enum(['Instagram', 'Avito']);
-// v1.5 Increment 5c — CRM provisioning через Setup URL pattern (секреты в браузере).
-// GETCOURSE/TELEGRAM — API-key; AMOCRM/BITRIX24 — вставка credentials (5c Phase 2, не OAuth-redirect).
-export const provisionableCrmTypeSchema = z.enum(['GETCOURSE', 'TELEGRAM', 'AMOCRM', 'BITRIX24']);
+// CRM provisioning через Setup URL pattern: секреты вводятся только в браузере.
+export const provisionableCrmTypeSchema = z.enum(['GETCOURSE', 'AMOCRM', 'BITRIX24']);
 export const fieldSpecialPurposeSchema = z.enum([
     'phone',
     'telegramId',
@@ -177,18 +196,33 @@ export const icpAnalysisPersonaSchema = z
 /**
  * Машинные ожидания реплики: что раннер песочницы обязан увидеть в ответе агента на неё.
  *
- * ⚠️ Без этой схемы поле не просто «не валидируется», а ИСЧЕЗАЕТ: zod стрипает неизвестные ключи
- * молча, и ожидания не доехали бы до backend вовсе. Вторая точка потери — маппинг сабмита, где
- * реплики пересобираются по явному списку полей.
+ * ⚠️ Без схемы поле не просто «не проверяется», а ИСЧЕЗАЕТ: zod молча срезает неизвестные ключи,
+ * и рубрика не доехала бы до сервера вовсе. Вторая точка потери — сборка тела отправки, где
+ * реплики пересобираются по явному списку полей: там `expect` перечислен отдельно.
+ *
+ * ⛔ Принимаются ровно ТРИ правила — те, что сервер открывает генератору сценариев
+ * (`GENERATED_SCENARIO_EXPECTATION_KEYS`, `additionalProperties: false`): два по тексту ответа и
+ * запрет ранней передачи оператору, у которого единственная цель — `call_operator` (песочница
+ * проверяет его по сработавшему действию с шагом передачи). Идентификаторов действий и имён
+ * инструментов генератор не знает, и выдуманная цель краснела бы на исправном агенте: правила по
+ * действиям ставит оператор. Хранилище сервера знает ШЕСТЬ имён — это реестр ХРАНЕНИЯ, а не то,
+ * что сервер показывает пишущей стороне.
+ *
+ * ⚠️ Отгруженный клиент объявляет все шесть, и сервер их принимает; сужение здесь повторяет
+ * контракт генератора, а не обещает модели цели, которых она не знает.
  */
-export const scenarioTurnExpectationSchema = z.object({
-    triggers: z.array(z.string().min(1)).optional(),
-    noTriggers: z.array(z.string().min(1)).optional(),
-    tools: z.array(z.string().min(1)).optional(),
-    noTools: z.array(z.string().min(1)).optional(),
+export const scenarioTurnExpectationSchema = z
+    .object({
+    noTools: z
+        .array(z.enum(['call_operator']))
+        .min(1)
+        .optional(),
     answerContains: z.array(z.string().min(1)).optional(),
     answerNotContains: z.array(z.string().min(1)).optional(),
-});
+})
+    // ⛔ Строгая: незнакомое правило отвергается С ИМЕНЕМ, а не срезается молча. Молчаливое срезание
+    // и есть тот случай, когда пишущая сторона считает правило заданным, а проверять его некому.
+    .strict();
 export const scenarioSituationSchema = z.object({
     role: z.enum(['client', 'agent']),
     text: z.string().min(1).max(4000),
@@ -209,7 +243,21 @@ export const generatedScenarioSchema = z
     ...rest,
     segment_ids: segment_ids ?? segmentIds,
 }));
-export const sandboxFindingSchema = z.object({
+/**
+ * Находка песочницы — КАНОН сервера, а не прежняя форма ветки v2.
+ *
+ * ⛔ Рубрика — РОВНО семь категорий отгруженного контракта. `missed_trigger` убрана: сервер её
+ * отвергает, то есть ветка v2 предлагала модели категорию, на которой вызов падал целиком.
+ * `missed_context` добавлена — она в каноне и была недостижима. Прежняя `wrong_pipeline_transition`
+ * НЕ рекламируется сознательно: сервер её принимает ради уже сохранённых находок, но его задание
+ * называет модели семь категорий, и предлагать восьмую значило бы спорить с этим решением.
+ *
+ * ⛔ Текст находки называется `description`; прежнее имя `message` принимается тоже, потому что
+ * им пользуется отгруженный клиент, стоящий у людей сейчас. Требуется РОВНО ОДНО из двух: без
+ * этого правила находка без текста уходила бы на сервер пустой.
+ */
+export const sandboxFindingSchema = z
+    .object({
     scenario_id: uuidSchema.optional(),
     scenarioId: uuidSchema.optional(),
     category: z.enum([
@@ -229,8 +277,9 @@ export const sandboxFindingSchema = z.object({
     suggestion: z.string().optional(),
     turn_index: z.number().int().optional(),
     turnIndex: z.number().int().optional(),
-}).refine((finding) => finding.description !== undefined || finding.message !== undefined, {
-    message: 'description is required',
+})
+    .refine((finding) => finding.description !== undefined || finding.message !== undefined, {
+    message: 'Находка обязана нести текст: description (канон) либо message (прежнее имя)',
     path: ['description'],
 });
 export const simulationFindingSchema = z.object({
@@ -260,11 +309,11 @@ export const routingRuleLeadStatusSchema = z.object({
 // Одно условие правила роутинга «по значению переменной» (CUSTOM_VARIABLE).
 // Одно правило = N условий, объединяемых condition_logic (ALL=И / ANY=ИЛИ).
 // Внутри условия значения объединяются по ИЛИ (variable_values) — вместе с condition_logic=ALL
-// это даёт «И из ИЛИ»: AI_TOPIC ∈ [дбо] AND WAVE_SEGMENT ∈ [post-web, post-web-2].
-// variable_value — legacy-форма на одно значение; ровно одна из двух форм на условие.
-// Обе формы принимаются вместе, если СОГЛАСОВАНЫ (скаляр = первое значение набора): ответ API и
-// besales_platform_context_get отдают оба поля, поэтому клиент «прочитал → поправил → отправил»
-// естественно шлёт оба. Жёсткий XOR ломал бы обычный сценарий правки. Противоречие — отказ.
+// это даёт «И из ИЛИ»: тема ∈ [дбо] AND сегмент ∈ [post-web, post-web-2].
+// variable_value — форма на одно значение; ровно одна из двух форм на условие обязательна.
+// Обе формы принимаются вместе, если СОГЛАСОВАНЫ (скаляр = первое значение набора): ответ API
+// отдаёт оба поля, поэтому клиент «прочитал → поправил → отправил» естественно шлёт оба.
+// Жёсткий выбор одной формы ломал бы обычный сценарий правки. Противоречие — отказ.
 export const routingRuleConditionSchema = z
     .object({
     custom_variable_id: z.string().uuid(),
@@ -276,9 +325,14 @@ export const routingRuleConditionSchema = z
 })
     .refine((cond) => cond.variable_values === undefined ||
     cond.variable_value === undefined ||
-    cond.variable_values[0]?.trim().toLowerCase() === cond.variable_value.trim().toLowerCase(), {
-    message: 'variable_value не совпадает с variable_values[0]. Присылайте одну форму либо согласованные',
+    // Сравнение идёт с первым НЕПУСТЫМ элементом — тем же, который останется набором после
+    // чистки на стороне API. Иначе мост отвергал бы форму, которую API принимает.
+    firstMeaningfulValue(cond.variable_values) === cond.variable_value.trim().toLowerCase(), {
+    message: 'variable_value не совпадает с первым значением variable_values. Присылайте одну форму либо согласованные',
 });
+function firstMeaningfulValue(values) {
+    return values.map((value) => value.trim().toLowerCase()).find((value) => value !== '');
+}
 export const agentToolPatchSchema = z.object({
     tool_id: z.string(),
     priority: z.number().int().min(1).max(100).optional(),
@@ -303,9 +357,7 @@ export const agentRuntimeConfigSchema = z.object({
     qa_min_score: z.number().min(0).max(1).optional(),
     qa_context_limit: z.number().int().min(1).max(10).optional(),
     max_response_symbols: z.number().int().min(1).optional(),
-    reasoning_effort: z
-        .enum(['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'])
-        .optional(),
+    reasoning_effort: z.enum(['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']).optional(),
     verbosity: z.enum(['low', 'medium', 'high']).optional(),
     enable_thinking: z.boolean().optional(),
     timezone: z.string().optional(),
@@ -338,79 +390,172 @@ export const agentScopeSchema = z.enum([
     'complaint',
     'other',
 ]);
-// Behavior typed sections (Group C.1)
-export const behaviorGreetingButtonSchema = z.object({
+// Behavior typed sections — КАНОН v2 (spec 02 § 5.2).
+//
+// ⛔ Имена полей = имена Zod-схем секций besales-api, а не отгруженные имена v1.5. Причина не в
+// чистоте: у части полей вместе с именем сменилась ЕДИНИЦА (задержки уехали из секунд в
+// миллисекунды), и сохрани мы старое имя — оператор, задавший 10, получил бы десять миллисекунд
+// вместо десяти секунд, молча и без единой ошибки.
+//
+// ⛔ Все поля НЕОБЯЗАТЕЛЬНЫ, потому что сервер сливает присланное с текущим значением секции.
+// Обязательность зеркалить нельзя: она запретила бы правку одного поля — то самое, ради чего
+// инструмент и существует.
+//
+// ⛔ `schema_version` принимается, но перезаписывается: снимок из besales_platform_context_get его
+// СОДЕРЖИТ, и строгая схема без этого поля отвергла бы собственный же прочитанный снимок.
+const behaviorSchemaVersion = { schema_version: z.literal(1).optional() };
+export const behaviorGreetingButtonSchema = z
+    .object({
     id: z.string(),
     label: z.string(),
     text: z.string(),
     order: z.number().int(),
-});
-export const behaviorGreetingSchema = z.object({
-    bot_greeting: z.string().optional(),
-    greeting_file_id: uuidSchema.nullable().optional(),
-    greeting_buttons: z.array(behaviorGreetingButtonSchema).optional(),
-    greeting_buttons_keyboard_type: z.enum(['INLINE', 'REPLY']).optional(),
+})
+    .strict();
+export const behaviorGreetingSchema = z
+    .object({
+    ...behaviorSchemaVersion,
+    text: z.string().optional(),
+    // null очищает картинку приветствия: сервер удаляет ключ, а не пишет пустоту.
+    file_id: z.string().nullable().optional(),
+    buttons: z.array(behaviorGreetingButtonSchema).optional(),
+    keyboard_type: z.enum(['INLINE', 'REPLY']).optional(),
     popup_delay_seconds: z.number().int().min(0).optional(),
-});
-/**
- * Набор стратегий у каждого типа вложения свой. `PROCESS_WITH_LLM` разбирает вложение
- * по-разному: image → vision-модель, video → подпись как текст, document → извлечённый текст
- * файла. У аудио такого значения на бэкенде нет вовсе, и запрос отвергается 400. Общая схема
- * на все четыре типа предлагала значение везде, из-за чего агент слал заведомо невалидный
- * payload (прод, 2026-08-10).
- */
-const mediaHandlerCommonFields = {
-    fixed_response_text: z.string().optional(),
+    // Отдаёт ли канал offMessage, когда ИИ выключен. Поле есть в v2 и у него живой читатель;
+    // у отгруженного инструмента его не было вовсе.
+    send_off_message_when_ai_disabled: z.boolean().optional(),
+})
+    .strict();
+const behaviorMediaHandlerFields = {
+    fixed_response_text: z.string().nullable().optional(),
     call_operator: z.boolean().optional(),
-    operator_comment: z.string().optional(),
+    operator_comment: z.string().nullable().optional(),
 };
-export const behaviorMediaHandlerSchema = z.object({
-    behavior: z.enum(['SILENT', 'PROCESS_WITH_LLM', 'FIXED_RESPONSE']),
-    ...mediaHandlerCommonFields,
-});
-export const behaviorPlainMediaHandlerSchema = z.object({
-    behavior: z.enum(['SILENT', 'FIXED_RESPONSE']),
-    ...mediaHandlerCommonFields,
-});
-export const behaviorMediaHandlingSchema = z.object({
+/**
+ * Обработчик вложения, у которого есть разбор моделью: картинка (кадр уходит зрячей модели),
+ * видео (в модель уходит подпись) и документ (в модель уходит ИЗВЛЕЧЁННЫЙ ТЕКСТ, сам файл — нет).
+ *
+ * ⚠️ У картинки и документа `PROCESS_WITH_LLM` означает: воркспейс соглашается отправлять в модель
+ * содержимое присланных файлов, включая персональные данные ТРЕТЬИХ ЛИЦ. Обезличивание подменяет
+ * известные значения контакта и распознаёт имена и контакты эвристикой, но полноты на содержимом
+ * чужого файла не гарантирует. Поэтому включение требует `explicit_confirmation`.
+ */
+export const behaviorMediaHandlerSchema = z
+    .object({
+    behavior: z.enum(['SILENT', 'PROCESS_WITH_LLM', 'FIXED_RESPONSE']).optional(),
+    ...behaviorMediaHandlerFields,
+})
+    .strict();
+/**
+ * Обработчик вложения БЕЗ разбора моделью — сегодня это только звук.
+ *
+ * ⛔ Отдельная схема, а не общая: разбирать в аудиофайле нечего (голосовые обрабатывает
+ * распознавание речи), и общий набор значений заставлял бы агента слать заведомо невалидный
+ * запрос — сервер отвергает `PROCESS_WITH_LLM` у звука своей схемой.
+ */
+export const behaviorPlainMediaHandlerSchema = z
+    .object({
+    behavior: z.enum(['SILENT', 'FIXED_RESPONSE']).optional(),
+    ...behaviorMediaHandlerFields,
+})
+    .strict();
+export const behaviorMediaHandlingSchema = z
+    .object({
+    ...behaviorSchemaVersion,
     image: behaviorMediaHandlerSchema.optional(),
     video: behaviorMediaHandlerSchema.optional(),
     audio: behaviorPlainMediaHandlerSchema.optional(),
     document: behaviorMediaHandlerSchema.optional(),
-});
-export const behaviorUrlHandlingSchema = z.object({
-    behavior: z.enum(['PASS_THROUGH', 'SILENT', 'FIXED_RESPONSE', 'PROCESS_WITH_CRAWLER']),
-    fixed_response_text: z.string().optional(),
+})
+    .strict();
+export const behaviorUnsupportedInputHandlingSchema = z
+    .object({
+    ...behaviorSchemaVersion,
+    behavior: z.enum(['SILENT', 'AS_TEXT', 'FIXED_RESPONSE']).optional(),
+    fixed_response_text: z.string().nullable().optional(),
+    call_operator: z.boolean().optional(),
+    operator_comment: z.string().nullable().optional(),
+})
+    .strict();
+export const behaviorUrlHandlingSchema = z
+    .object({
+    ...behaviorSchemaVersion,
+    behavior: z
+        .enum(['PASS_THROUGH', 'SILENT', 'FIXED_RESPONSE', 'PROCESS_WITH_CRAWLER'])
+        .optional(),
+    fixed_response_text: z.string().nullable().optional(),
     call_operator: z.boolean().optional(),
-    operator_comment: z.string().optional(),
+    operator_comment: z.string().nullable().optional(),
     use_youtube_data_api: z.boolean().optional(),
-});
-export const behaviorErrorHandlingSchema = z.object({
+})
+    .strict();
+export const behaviorErrorHandlingSchema = z
+    .object({
+    ...behaviorSchemaVersion,
     ai_error_behavior: z.enum(['SILENT', 'SEND_ERROR_MESSAGE']).optional(),
-    ai_error_custom_message: z.string().optional(),
-    call_operator_with_error: z.boolean().optional(),
-    ai_error_target_stage_id: z.number().int().nullable().optional(),
-});
-export const behaviorDayAvailabilitySchema = z.object({
+    custom_message: z.string().nullable().optional(),
+    call_operator: z.boolean().optional(),
+    // Цель сбоя модели: пара «воронка + статус» либо статус без воронки — «стадия с этим кодом в текущей воронке
+    // сделки» (так понимала номер прежняя система). null снимает цель.
+    ai_error_target: z
+        .object({ pipeline_id: z.string().min(1).optional(), status_id: z.string().min(1) })
+        .strict()
+        .nullable()
+        .optional(),
+    // Прежнее поле отгруженного моста — номер стадии прежней системы. Переводит его в цель СЕРВЕР (по каталогу
+    // подключения CRM канала; неоднозначность и неизвестный номер — отказ с адресом поля); null или 0 снимает цель.
+    // Вместе с ai_error_target не присылается.
+    ai_error_target_stage_id: z.number().int().nonnegative().nullable().optional(),
+})
+    .strict();
+/**
+ * ⛔ У РАБОЧЕГО дня обязательны ОБА времени и строго в формате `HH:MM`. Схема хранения приняла бы
+ * и `active: true` без времён, и запись вида `9:00` — а читатель расписания на таком дне считает
+ * НЕСТРОГИМ всё расписание целиком и объявляет оператора доступным ВСЕГДА. То есть один
+ * неаккуратный день молча выключает расписание на всю неделю, без ошибки и без предупреждения.
+ */
+export const behaviorDayAvailabilitySchema = z
+    .object({
     active: z.boolean(),
-    start_time: z.string().optional(),
-    end_time: z.string().optional(),
-});
-export const behaviorWeekAvailabilitySchema = z.object({
-    monday: behaviorDayAvailabilitySchema.optional(),
-    tuesday: behaviorDayAvailabilitySchema.optional(),
-    wednesday: behaviorDayAvailabilitySchema.optional(),
-    thursday: behaviorDayAvailabilitySchema.optional(),
-    friday: behaviorDayAvailabilitySchema.optional(),
-    saturday: behaviorDayAvailabilitySchema.optional(),
-    sunday: behaviorDayAvailabilitySchema.optional(),
+    start_time: z
+        .string()
+        .regex(/^(?:[01]\d|2[0-3]):[0-5]\d$/u)
+        .optional(),
+    end_time: z
+        .string()
+        .regex(/^(?:[01]\d|2[0-3]):[0-5]\d$/u)
+        .optional(),
+})
+    .strict()
+    .refine((day) => !day.active || (day.start_time !== undefined && day.end_time !== undefined), {
+    message: 'у рабочего дня обязательны start_time и end_time в формате HH:MM',
 });
-export const behaviorOperatorScheduleSchema = z.object({
+/**
+ * ⛔ Ключи дня пришпилены к канону `MON..SUN`. Хранилище приняло бы ЛЮБУЮ строку
+ * (`z.record(z.string(), …)`), а читатель при чужом ключе объявляет оператора доступным ВСЕГДА —
+ * то есть расписание, выставленное с ключами `monday…sunday`, молча не работало бы: ни ошибки,
+ * ни предупреждения, ни строки в логе.
+ */
+export const behaviorWeekAvailabilitySchema = z
+    .object({
+    MON: behaviorDayAvailabilitySchema.optional(),
+    TUE: behaviorDayAvailabilitySchema.optional(),
+    WED: behaviorDayAvailabilitySchema.optional(),
+    THU: behaviorDayAvailabilitySchema.optional(),
+    FRI: behaviorDayAvailabilitySchema.optional(),
+    SAT: behaviorDayAvailabilitySchema.optional(),
+    SUN: behaviorDayAvailabilitySchema.optional(),
+})
+    .strict();
+export const behaviorOperatorScheduleSchema = z
+    .object({
+    ...behaviorSchemaVersion,
     enabled: z.boolean().optional(),
     availability: behaviorWeekAvailabilitySchema.optional(),
-    unavailable_message: z.string().optional(),
-    // -1 — ответ оператора не отключает бота, 0 — молчать до /start, далее часы паузы.
-    bot_waiting_return_hours: z.union([
+    unavailable_message: z.string().nullable().optional(),
+    // -1 — ответ оператора НЕ отключает бота; 0 — молчать до /start; далее часы паузы.
+    bot_waiting_return_hours: z
+        .union([
         z.literal(-1),
         z.literal(0),
         z.literal(1),
@@ -418,32 +563,81 @@ export const behaviorOperatorScheduleSchema = z.object({
         z.literal(6),
         z.literal(12),
         z.literal(24),
-    ]).optional(),
-    follow_up_waiting_return_hours: z.number().int().optional(),
-    skip_task_creation_on_call_operator: z.boolean().optional(),
-});
-export const behaviorTypingBehaviorSchema = z.object({
+    ])
+        .optional(),
+    followup_waiting_return_hours: z.number().int().optional(),
+    // Замолкает ли агент после реплики живого оператора. Отсутствие поля означает КАНОН
+    // «замолкать», поэтому выключение требует `explicit_confirmation`.
+    pause_agent_on_operator_reply: z.boolean().optional(),
+})
+    .strict();
+export const behaviorTypingBehaviorSchema = z
+    .object({
+    ...behaviorSchemaVersion,
+    typing_speed: z.enum(['slow', 'medium', 'fast', 'instant']).optional(),
     waiting_answer_time: z.number().int().min(0).optional(),
     can_interrupt: z.boolean().optional(),
-    message_devide: z.boolean().optional(),
-    typing_speed: z.enum(['slow', 'medium', 'fast']).optional(),
-    fake_delay: z.number().int().min(0).optional(),
-    message_open_delay: z.number().int().min(0).optional(),
-    go_offline: z.string().optional(),
-});
-export const behaviorMessageFilterSchema = z.object({
+    // ⚠️ Секунды v1.5 стали МИЛЛИСЕКУНДАМИ — единица видна в имени намеренно.
+    fake_delay_ms: z.number().int().min(0).optional(),
+    message_open_delay_ms: z.number().int().min(0).optional(),
+})
+    .strict();
+export const behaviorMessageFilterSchema = z
+    .object({
     id: z.string(),
-    source: z.string(),
-    target: z.string(),
+    // Границы зеркалят схему хранения.
+    source: z.string().min(1).max(MESSAGE_FILTER_SOURCE_MAX_LENGTH),
+    target: z.string().max(MESSAGE_FILTER_TARGET_MAX_LENGTH),
     enabled: z.boolean(),
     order: z.number().int(),
-});
-export const behaviorMessageSplittingSchema = z.object({
-    message_chunk_separator: z.string().optional(),
-});
-export const behaviorPrivacySchema = z.object({
+})
+    .strict();
+export const behaviorMessageFiltersSchema = z
+    .object({
+    ...behaviorSchemaVersion,
+    // Переехало из расписания оператора: в v2 признак живёт здесь.
+    skip_task_creation_on_call_operator: z.boolean().optional(),
+    rules: z.array(behaviorMessageFilterSchema).optional(),
+})
+    .strict();
+export const behaviorMessageSplittingSchema = z
+    .object({
+    ...behaviorSchemaVersion,
+    // Переехало из «печатает»: в v1.5 это было `message_devide`.
+    enabled: z.boolean().optional(),
+    mode: z.enum(['PARAGRAPH', 'SEPARATOR']).optional(),
+    separator: z.string().optional(),
+    // Максимум означает «не дробить дополнительно»: у v1.5 отдельного предела не было.
+    // Границы зеркалят схему хранения.
+    max_chunk_size: z.number().int().min(100).max(100_000).optional(),
+    delay_between_ms: z.number().int().min(0).max(60_000).optional(),
+})
+    .strict();
+/**
+ * CRM-поведение канала в инструменте поведения — только входящий фильтр по сделке GetCourse («бот отвечает только
+ * тем, у кого есть подходящая сделка»). Раздел СЛИВАЕТСЯ с сохранённым CRM-поведением канала; у канала без привязанной
+ * CRM сливать не с чем, и сервер ответит отказом с перечнем недостающих полей. Полноту включённого фильтра и
+ * подтверждение смены включённости и типа держит сервер.
+ */
+export const behaviorCrmSchema = z
+    .object({
+    ...behaviorSchemaVersion,
+    inbound_deal_filter: z
+        .object({
+        enabled: z.boolean(),
+        type: z.enum(['NONE', 'TAG', 'CUSTOM_FIELD']),
+        value: z.string().nullable().optional(),
+        field_id: z.string().nullable().optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+export const behaviorPrivacySchema = z
+    .object({
+    ...behaviorSchemaVersion,
     anonymization_enabled: z.boolean().optional(),
-    contact_name_personalization_mode: z.enum(['OFF', 'SHADOW', 'ENABLED']).optional(),
+    personalization_mode: z.enum(['OFF', 'SHADOW', 'ENABLED']).optional(),
     // Типы PII, выключенные из анонимизации (отдаются в LLM как есть).
     // Именные типы всегда защищены и не входят в OFF-список.
     anonymization_disabled_types: z
@@ -461,7 +655,8 @@ export const behaviorPrivacySchema = z.object({
         'SOCIAL_ID',
     ]))
         .optional(),
-});
+})
+    .strict();
 // Pipeline settings typed sections (Group C.3)
 export const pipelineCrmBehaviorSchema = z.object({
     active_pipeline_ids: z.array(z.string()).optional(),
@@ -473,19 +668,19 @@ export const pipelineCrmBehaviorSchema = z.object({
 export const pipelineAutoFinishSchema = z.object({
     finish_auto_noanswer: z.boolean().optional(),
     finish_auto_timeout: z.boolean().optional(),
-    finish_auto_days: z.number().int().min(1).optional(),
+    finish_auto_days: z.number().int().min(1).max(PLATFORM_FINISH_AUTO_MAX_DAYS).optional(),
     send_finish_auto_note_to_crm: z.boolean().optional(),
     finish_auto_note_template: z.string().nullable().optional(),
 });
 // Platform settings typed sections (Group C.2 + Increment 4c per-channel)
+/**
+ * Кто из людей вообще доходит до агента.
+ *
+ * ⛔ Выключатели канала и ответов агента (`is_active`, `is_ai_enabled`) СЮДА НЕ ВХОДЯТ — их дом
+ * `general_settings`. Отсюда приёмник их не принимает и отвечал отказом на весь запрос.
+ */
 export const platformAccessControlSchema = z
     .object({
-    // У Instagram это НАМЕРЕНИЕ держать канал включённым, а не факт работы: эффективная
-    // активность = намерение И подтверждённая подписка на вебхуки. Прочитав `is_active` обратно
-    // через `besales_platform_context_get`, можно увидеть `false` при успешно сохранённом `true` —
-    // это не отказ операции, а неподтверждённая подписка (лечится resubscribe).
-    is_active: z.boolean().optional(),
-    is_ai_enabled: z.boolean().optional(),
     is_user_filter_enabled: z.boolean().optional(),
     filtered_user_ids: z.array(z.string()).optional(),
     // v1.5 Increment 4c — TelegramBot only (hard 400 на других)
@@ -501,6 +696,7 @@ export const platformVariablesConfigSchema = z
 export const platformCrmBehaviorSchema = z
     .object({
     send_to_crm: z.boolean().optional(),
+    create_deal_on_first_outbound: z.boolean().optional(),
     use_cross_platform_history: z.boolean().optional(),
     responsible_assignee_strategy: z
         .enum(['ROUND_ROBIN', 'LEAST_BUSY', 'RANDOM', 'FIXED', 'OPERATOR_SPECIFIC'])
@@ -512,82 +708,107 @@ export const platformCrmBehaviorSchema = z
     failed_note_template: z.string().nullable().optional(),
     send_operator_takeover_note_to_crm: z.boolean().optional(),
     operator_takeover_note_template: z.string().nullable().optional(),
+    finish_auto_enabled: z.boolean().optional(),
+    finish_auto_days: z.number().int().min(1).max(PLATFORM_FINISH_AUTO_MAX_DAYS).optional(),
+    send_finish_auto_note_to_crm: z.boolean().optional(),
+    finish_auto_note_template: z.string().nullable().optional(),
+    getcourse_create_deal_payment_tracking_enabled: z.boolean().optional(),
+    getcourse_status_deal_fallback_enabled: z.boolean().optional(),
     // v1.5 Increment 4c — deal marker (любой CRM-aware channel)
     deal_marker_type: z.enum(['NONE', 'TAG', 'CUSTOM_FIELD']).optional(),
     deal_marker_value: z.string().nullable().optional(),
     deal_marker_field_id: z.string().nullable().optional(),
-    // Inbound deal-фильтр (GetCourse): агент отвечает только контактам, у которых в активной
-    // сделке есть поле=значение (CUSTOM_FIELD) или тег (TAG). Для не-GetCourse каналов — no-op.
-    // Включённый фильтр требует type≠NONE + value (для CUSTOM_FIELD ещё field_id) — иначе 400.
+    // Входящий фильтр по сделке (GetCourse) — прежние имена отгруженного моста; сервер хранит его в
+    // crm_behavior.inbound_deal_filter. Включённый фильтр обязан быть полным; включённость и тип — опасные поля.
     inbound_deal_filter_enabled: z.boolean().optional(),
     inbound_deal_filter_type: z.enum(['NONE', 'TAG', 'CUSTOM_FIELD']).optional(),
     inbound_deal_filter_value: z.string().nullable().optional(),
     inbound_deal_filter_field_id: z.string().nullable().optional(),
 })
     .strict();
+/**
+ * Маркетинговая секция виджета — РОВНО два поля, которые принимает besales-api.
+ *
+ * ⛔ Список сайтов, лимит обращений, признак «передавать адрес страницы» и оформление ЖИВУТ НЕ
+ * ЗДЕСЬ, а в `general_settings`: их приёмник — конфигурация подключения канала, а не поведение.
+ * Прежде все шесть полей уезжали сюда под именами `webWidget*`, которых приёмная сторона не знает
+ * ни одного, и любое из них давало отказ «удалите неизвестные поля» на ВЕСЬ запрос — то есть ни
+ * одна настройка виджета через мост не записывалась.
+ *
+ * ⛔ `null` здесь не принимается: приёмник объявляет оба поля необязательными, но НЕ нулевыми, а
+ * проекция пишет `null` значением, а не удаляет ключ. Мост, принявший `null`, обещал бы очистку,
+ * которой не бывает.
+ */
 export const platformWidgetMarketingSchema = z
     .object({
-    web_widget_allowed_origins: anyObjectSchema.nullable().optional(),
-    web_widget_show_page_info: z.boolean().optional(),
-    web_widget_rate_limit_per_minute: z.number().int().min(1).max(600).optional(),
-    web_widget_customization: anyObjectSchema.nullable().optional(),
-    web_widget_marketing_field_mappings: anyObjectSchema.nullable().optional(),
-    web_widget_entry_url_variable_mapping: anyObjectSchema.nullable().optional(),
+    marketing_field_mappings: anyObjectSchema.optional(),
+    entry_url_variable_mapping: anyObjectSchema.optional(),
+})
+    .strict();
+/**
+ * Оформление виджета — одиннадцать разделов ровно теми именами, которыми их принимает
+ * `general_settings.customization`.
+ *
+ * ⚠️ Внутренность раздела мост НЕ переописывает: это был бы второй реестр против схемы хранения
+ * besales-api, и он разошёлся бы с ней на первой же правке. Раздел сливается с сохранённым, так
+ * что частичное значение законно; пустой объект не сбрасывает ничего.
+ */
+export const platformWidgetCustomizationSchema = z
+    .object({
+    button: anyObjectSchema.optional(),
+    window: anyObjectSchema.optional(),
+    theme: anyObjectSchema.optional(),
+    welcome_state: anyObjectSchema.optional(),
+    pre_chat_form: anyObjectSchema.optional(),
+    offline_state: anyObjectSchema.optional(),
+    languages: anyObjectSchema.optional(),
+    widget_ux: anyObjectSchema.optional(),
+    gdpr: anyObjectSchema.optional(),
+    embed: anyObjectSchema.optional(),
+    advanced: anyObjectSchema.optional(),
 })
     .strict();
 export const platformInstagramCommentSchema = z
     .object({
     reply_to_instagram_comments: z.boolean().optional(),
     instagram_comment_handling_mode: z.string().nullable().optional(),
-    instagram_comment_reply_method: z.string().nullable().optional(),
-    instagram_comment_keywords: anyObjectSchema.nullable().optional(),
+    instagram_comment_reply_method: z
+        .enum(['DM_ONLY', 'PUBLIC_REPLY', 'BOTH', 'PUBLIC_AND_DM'])
+        .optional(),
+    instagram_comment_templates: instagramCommentTemplatesSchema.nullable().optional(),
+    instagram_comment_keywords: z.array(z.string()).nullable().optional(),
     reply_to_story_mentions: z.boolean().optional(),
 })
     .strict();
 /**
- * Ссылка на стадию CRM ПОЛНЫМ композитом.
+ * Общие настройки канала. Четыре поля справедливы для любого канала, остальные — веб-виджет.
  *
- * ⚠️ Голый `status_id` не годится: статусы 142/143 и одноимённые стадии есть в КАЖДОЙ
- * воронке, и выбор по номеру попал бы не туда.
- */
-export const funnelStageRefSchema = z
-    .object({
-    pipeline_crm_id: z.string().min(1),
-    pipeline_id: z.number().int(),
-    status_id: z.number().int(),
-})
-    .strict();
-/**
- * Настройки раздела «Воронка канала».
+ * ⛔ Список сайтов — МАССИВ строк, и проверка его формы остаётся на приёмной стороне. Здесь список
+ * объявлялся объектом, из-за чего отвергался мостом ещё до отправки. Элементом законны голый домен
+ * (`site.ru`), домен с портом (`site.ru:8443`), полный адрес (`https://site.ru`) и `*`, поэтому
+ * проверка «это URL» была бы ошибкой — она отвергла бы три законные формы из четырёх.
+ *
+ * ⚠️ Пустой список — законное значение со смыслом «не работать нигде»; приёмник его принимает, и
+ * мост не вправе быть строже.
  *
- * ⚠️ `null` у `decision_gate`/`path_target_stage` — СБРОС; отсутствие поля — «не трогать».
- * Бэкенд ДЕЛЕГИРУЕТ запись сервисам раздела, поэтому здесь нет своей валидации стадий:
- * «стадии разные» и «стадия есть в каталоге площадки» проверяет он, и второй набор правил
- * рядом разошёлся бы с первым.
+ * Лимит обращений — целое число от 1 до 600, как на приёмной стороне.
  */
-export const platformFunnelAnalyticsSchema = z
-    .object({
-    decision_gate: z
-        .object({
-        submitted: funnelStageRefSchema,
-        approved: funnelStageRefSchema,
-        rejected: funnelStageRefSchema,
-    })
-        .strict()
-        .nullable()
-        .optional(),
-    path_target_stage: funnelStageRefSchema.nullable().optional(),
-    engaged_inbound_count: z.number().int().min(2).max(20).nullable().optional(),
-    stuck_threshold_hours: z.number().int().min(1).max(720).nullable().optional(),
-})
-    .strict();
-// v1.5 Increment 4c — per-channel typed sections
 export const platformGeneralSettingsSchema = z
     .object({
     name: z.string().nullable().optional(),
     off_message: z.string().nullable().optional(),
     timezone: z.string().optional(),
     is_active: z.boolean().optional(),
+    // Выключатель ответов агента. Прежде жил в `access_control`, откуда приёмник его не принимает.
+    is_ai_enabled: z.boolean().optional(),
+    // Реестр поддерживаемых стран принадлежит API; мост передаёт строку либо снимает настройку.
+    phone_parsing_country: z.string().nullable().optional(),
+    // Веб-виджет.
+    allowed_origins: z.array(z.string()).optional(),
+    page_rules: platformWidgetPageRulesSchema.nullable().optional(),
+    rate_limit: z.number().int().positive().max(600).optional(),
+    show_page_info: z.boolean().optional(),
+    customization: platformWidgetCustomizationSchema.optional(),
 })
     .strict();
 export const platformSalebotSettingsSchema = z
@@ -616,25 +837,7 @@ export const platformBitrix24BotSettingsSchema = z
     ignore_crm_stage_gate: z.boolean().optional(),
 })
     .strict();
-/**
- * ⚠️ УСТАРЕЛО с 23.08.2026 и на поведение НЕ влияет. Оставлено, потому что API поле ещё
- * принимает, а старые записи его несут; снять можно только вместе с клиентами.
- *
- * Режим применялся ко ВСЕМУ списку разом: `RESTRICT` умел лишь сужать уже посчитанный выбор, а
- * Email/WhatsApp/SMS в него не попадали ни у кого (`bot_link` школы отдаёт vk/telegram/max) — то
- * есть их отметка была молчаливым no-op. Теперь список значит «слать сюда», а судьбу КАЖДОГО
- * канала решает сервер по фактам о контакте. «Отправить ещё и на почту» = добавить Email в
- * `channels` И перечислить мессенджеры явно; предлагать `ADD` больше НЕ нужно.
- */
-export const coldWelcomeChannelsModeEnum = z.enum(['RESTRICT', 'ADD']);
-/**
- * Режим правила предохранителя холодных отправок.
- *
- * OFF — правило выключено; WARN — сработавшее правило только записывается в аудит, отправка
- * идёт; BLOCK — отправка останавливается. По умолчанию `active_series` = BLOCK (правило,
- * из-за нарушения которого пришла жалоба клиента), остальные = WARN.
- */
-export const guardModeEnum = z.enum(['OFF', 'WARN', 'BLOCK']);
+// Этот набор сверяется с контрактом в wave-transports.spec.ts; трогая его, смотри туда.
 export const getcourseTransportEnum = z.enum([
     'Site',
     'Email',
@@ -653,22 +856,6 @@ export const platformGetcourseDepartmentSchema = z
     label: z.string(),
 })
     .strict();
-const platformGetcourseWaveFieldBindingSchema = z
-    .object({
-    field_id: z.number().int().positive().max(2_147_483_647),
-    field_label: z.string().trim().min(1),
-})
-    .strict();
-const platformGetcourseWaveFieldBindingsSchema = z
-    .object({
-    product_value_source: z.enum(['CODE', 'NAME']),
-    launch_type: platformGetcourseWaveFieldBindingSchema.optional(),
-    product: platformGetcourseWaveFieldBindingSchema.optional(),
-    segment: platformGetcourseWaveFieldBindingSchema.optional(),
-    funnel: platformGetcourseWaveFieldBindingSchema.optional(),
-    channels: platformGetcourseWaveFieldBindingSchema.optional(),
-})
-    .strict();
 export const platformGetcourseSettingsSchema = z
     .object({
     account_domain: z.string().nullable().optional(),
@@ -678,8 +865,8 @@ export const platformGetcourseSettingsSchema = z
     departments: z.array(platformGetcourseDepartmentSchema).nullable().optional(),
     template_user_id: z.number().int().nullable().optional(),
     template_deal_id: z.number().int().nullable().optional(),
-    // School-scoped bindings: роль durable-волны → custom field ID сделки GetCourse.
-    // null очищает все bindings; undefined оставляет текущую настройку без изменений.
+    // Привязки ролей волны к полям сделки: объект ЗАМЕНЯЕТ сохранённые привязки целиком, null
+    // снимает все, отсутствие поля — «не трогать».
     wave_field_bindings: platformGetcourseWaveFieldBindingsSchema.nullable().optional(),
     // Phase 2 — маппинг «поле сделки GetCourse → платформенная переменная»: значение поля активной
     // сделки контакта читается в per-contact переменную (напр. AI_TOPIC → webinar_topic).
@@ -695,32 +882,36 @@ export const platformGetcourseSettingsSchema = z
     // Department-routing: id отдела GetCourse Inbox для авто-переноса прошедших inbound-фильтр
     // диалогов (+ авто-размьют filter-muted). null → выключено. Требует inbound-фильтр включённым.
     target_department_id: z.number().int().positive().nullable().optional(),
+    // Отдел ЖИВЫХ ЛЮДЕЙ: туда уезжает диалог, когда его передают человеку. null → передача
+    // выключена (ни одного обращения к школе).
+    // ⛔ Не путать с `target_department_id`: тот — отдел ВОРОНКИ, куда авто-перенос кладёт диалоги
+    // прошедших входящий фильтр сделки. Совпадение значений бэкенд отвергает: авто-перенос
+    // положил бы диалог прямо в очередь сотрудников, минуя все гейты передачи человеку.
+    operator_department_id: z.number().int().positive().nullable().optional(),
     // Ночная проверка доставки волн (04:00 МСК): крон читает кастомные поля сделки per-транспорт
     // (=1 → отправка была); аналитика рассылок платформы при включении учитывает только DELIVERED.
     delivery_check_enabled: z.boolean().optional(),
-    // ПРЕДОХРАНИТЕЛИ ХОЛОДНЫХ ОТПРАВОК: не писать посреди вебинарной серии, поверх работы
-    // менеджера по действующей заявке и оплатившему этот продукт. null → «не настраивали»,
-    // действующее значение берётся из дефолта (active_series = BLOCK, остальные = WARN).
-    guard_active_series: guardModeEnum.nullable().optional(),
-    guard_active_application: guardModeEnum.nullable().optional(),
-    guard_paid: guardModeEnum.nullable().optional(),
     /**
-     * ТИХИЙ ПЕРИОД площадки в сутках: не писать человеку N суток после НАШЕГО касания —
-     * отправки или шага календарной цепочки. Считается ПО ЧЕЛОВЕКУ; волна школы касанием НЕ
-     * считается. `null` = «не настраивали», действующее значение 0 (правила нет); рекомендация
-     * владельца — 7. Расписание судится своим `cooldown_days`, а не этим числом.
+     * СРОК ДОВЕРИЯ ОТВЕТУ ШКОЛЫ: сколько суток считать действующим её ответ «выбранными каналами
+     * человека не достать». Пока ответ свеж, импорт человека без карточки не заводит и школу о нём
+     * не спрашивает. `null` = «не настраивали», действующее значение 7; 0 = спрашивать школу каждый
+     * раз. Граница 0…365 — та же, что у сервера.
      */
-    quiet_days: z.number().int().min(0).nullable().optional(),
-    /**
-     * СРОК ДОВЕРИЯ ОТВЕТУ ШКОЛЫ: сколько суток считать действующим её «привязанных мессенджеров
-     * нет». Пока ответ свеж, импорт контакт не заводит и школу о нём не дёргает, а отбор
-     * расписания не берёт его в подачу. `null` = «не настраивали», действующее значение 7;
-     * 0 = спрашивать школу каждый раз.
-     */
-    reachability_ttl_days: z.number().int().min(0).max(365).nullable().optional(),
+    reachability_ttl_days: z
+        .number()
+        .int()
+        .min(0)
+        .max(GETCOURSE_REACHABILITY_TTL_DAYS_MAX)
+        .nullable()
+        .optional(),
     // «Транспорт → точное НАЗВАНИЕ кастомного поля сделки» (id в read-API GetCourse нет):
     // { "Telegram": "Отправлено ТГ", "VK": "Отправлено ВК" }. Очистка — пустым объектом {}.
-    delivery_field_map: z.record(getcourseTransportEnum, z.string()).optional(),
+    // ⚠️ ИМЕННО `partialRecord`. В zod 4 `record(enum, …)` требует ВСЕ ключи перечисления, поэтому
+    // отгруженная версия отвергала и очистку `{}`, и пример из собственного описания
+    // (`{"Telegram":"Отправлено ТГ"}`) — десять и девять ошибок соответственно, ещё до HTTP.
+    // Поле было недостижимо с момента появления; JSON-схема реестра исчерпывающесть не выражала,
+    // поэтому клиент видел «поле необязательное», а мост его отвергал.
+    delivery_field_map: z.partialRecord(getcourseTransportEnum, z.string()).optional(),
     // Ручной мьют бота по контактному полю GetCourse: оператор меняет кастом-поле контакта в GK →
     // AI молчит (снятие — когда поле снова «вкл»/пусто). manual_mute_field_id = id (числовой строкой)
     // ИЛИ имя поля; manual_mute_value = стоп-значение(я) через запятую; manual_mute_active_value —
@@ -730,421 +921,47 @@ export const platformGetcourseSettingsSchema = z
     manual_mute_value: z.string().nullable().optional(),
     manual_mute_active_value: z.string().nullable().optional(),
     // Создание отсутствующего заказа в status-волне: контакт БЕЗ единой сделки иначе не получает
-    // сообщение (поля проставлять некуда). Заказ создаётся по ПРЕДЛОЖЕНИЮ — legacy /pl/api/deals
-    // иначе заказ не создаёт; бесплатное предложение даёт нулевую сумму. Воронка и этап —
-    // необязательные уточнения (по умолчанию воронка предложения), внешние id GetCourse.
-    // Создаёт РЕАЛЬНЫЕ заказы в школе → dangerous, требует explicit_confirmation.
+    // сообщение (поля проставлять некуда). Заказ создаётся по ПРЕДЛОЖЕНИЮ; воронка и этап —
+    // необязательные уточнения и задаются только парой. Создаёт РЕАЛЬНЫЕ заказы в школе →
+    // dangerous, требует explicit_confirmation.
     create_missing_deal_enabled: z.boolean().optional(),
     create_missing_deal_offer_id: z.number().int().positive().nullable().optional(),
     create_missing_deal_funnel_id: z.number().int().positive().nullable().optional(),
     create_missing_deal_stage_id: z.number().int().positive().nullable().optional(),
-    // Офферы, оплата заказов с которыми засчитывается нам независимо от автора заказа (агент
-    // или менеджер руками). Пустой массив = выключить. Набор действует на ШКОЛУ целиком.
-    // Меняет денежную атрибуцию задним числом → dangerous, требует explicit_confirmation.
+    // Деньги канала: набор предложений, оплата которых — выручка ЭТОГО канала (буква в букву как у отгруженного
+    // клиента, иначе сравнение схем дало бы новую строку отставания), и момент начала зачёта — поле ветки v2 (у
+    // прежней системы дата жила у школы и выставлялась руками). Порядок «сначала дата, потом набор» держит сервер.
+    // Меняют деньги задним числом → explicit_confirmation. У канала виджета те же два поля — метка продажи (сервер
+    // хранит её своими ключами: метка только добавляет выручку).
     revenue_offer_ids: z.array(z.number().int().positive()).optional(),
+    revenue_offers_paid_since: z.string().datetime({ offset: true }).nullable().optional(),
 })
     .strict();
 // Knowledge tables (Group A.5)
-export const knowledgeTableSourceSchema = z.object({
+// ⛔ Отказы живут в СХЕМЕ с путём, а не в конструкторе запроса: отказ без пути не называет поле, и сверка с
+// отгруженным клиентом не может объявить его строкой отставания. `table_schema` прежний сервер лишь резервировал и не
+// читал: принимаем копию, канонический конструктор её не передаёт. NATIVE прежний сервер отвергал сам.
+export const knowledgeTableSourceSchema = z
+    .object({
     kind: z.enum(['GOOGLE_SHEETS', 'NATIVE']),
     spreadsheet_url: z.string().optional(),
     table_schema: anyObjectSchema.optional(),
-});
-export function defineTool(definition) {
-    return definition;
-}
-export function compactObject(value) {
-    return Object.fromEntries(Object.entries(value).filter(([, entryValue]) => entryValue !== undefined));
-}
-export function compactMetadata(metadata) {
-    if (!metadata) {
-        return undefined;
-    }
-    const compacted = compactObject({
-        totalTokens: metadata.total_tokens,
-        models: metadata.models,
-    });
-    return Object.keys(compacted).length === 0 ? undefined : compacted;
-}
-export function setupConfirmation(input) {
-    return compactObject({
-        explicitConfirmation: input.explicit_confirmation,
-        confirmationReason: input.confirmation_reason,
-    });
-}
-export function withInstructions(response, instructions) {
-    const text = instructions.join('\n');
-    if (response && typeof response === 'object' && !Array.isArray(response)) {
-        return {
-            ...response,
-            instructions: text,
-        };
-    }
-    return {
-        result: response,
-        instructions: text,
-    };
-}
-export function buildKnowledgeSpaceListQuery(scopeType, channelId) {
-    const params = new URLSearchParams();
-    if (scopeType)
-        params.set('scope_type', scopeType);
-    if (channelId)
-        params.set('channel_id', channelId);
-    const query = params.toString();
-    return query.length > 0 ? `?${query}` : '';
-}
-export function buildListQuery(params) {
-    const search = new URLSearchParams();
-    for (const [key, value] of Object.entries(params)) {
-        if (value === undefined) {
-            continue;
-        }
-        // ⚠️ Массив уходит ПОВТОРЯЮЩИМИСЯ параметрами (`?f=A&f=B`) — именно так его читает бэкенд.
-        // `String(['A','B'])` дал бы одну строку "A,B", и мультифильтр молча не сматчил бы ничего:
-        // ответ 200, список пуст, ошибки нет.
-        if (Array.isArray(value)) {
-            for (const item of value) {
-                search.append(key, item);
-            }
-            continue;
-        }
-        search.set(key, String(value));
-    }
-    const query = search.toString();
-    return query.length > 0 ? `?${query}` : '';
-}
-export function buildVariableListQuery(scope, platformId, filter, limit, cursor) {
-    const params = new URLSearchParams();
-    params.set('scope', scope);
-    if (platformId) {
-        params.set('platformId', platformId);
-    }
-    if (filter) {
-        params.set('filter', filter);
-    }
-    if (limit !== undefined) {
-        params.set('limit', String(limit));
-    }
-    if (cursor) {
-        params.set('cursor', cursor);
+})
+    .superRefine((source, ctx) => {
+    if (source.kind === 'NATIVE') {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['kind'],
+            message: 'NATIVE-таблицы пока не поддерживаются v2: используй GOOGLE_SHEETS; поддержка NATIVE придёт отдельным маршрутом.',
+        });
     }
-    const queryString = params.toString();
-    return queryString ? `?${queryString}` : '';
-}
-export function buildVariableScopeQuery(scope, platformId) {
-    const params = new URLSearchParams();
-    params.set('scope', scope);
-    if (platformId) {
-        params.set('platformId', platformId);
+    if (source.kind === 'GOOGLE_SHEETS' && !source.spreadsheet_url) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['spreadsheet_url'],
+            message: 'Для GOOGLE_SHEETS обязателен source.spreadsheet_url.',
+        });
     }
-    return `?${params.toString()}`;
-}
-export function buildFileListQuery(input) {
-    const params = new URLSearchParams();
-    if (input.file_type)
-        params.set('file_type', input.file_type);
-    if (input.source)
-        params.set('source', input.source);
-    if (input.section_id !== undefined)
-        params.set('section_id', input.section_id);
-    if (input.limit !== undefined)
-        params.set('limit', String(input.limit));
-    if (input.offset !== undefined)
-        params.set('offset', String(input.offset));
-    const queryString = params.toString();
-    return queryString ? `?${queryString}` : '';
-}
-// ============================================================
-// v1.5 Increment 3 — snake_case → camelCase input mappers
-// ============================================================
-export function mapRuntimeConfigInput(input) {
-    return compactObject({
-        temperature: input.temperature,
-        maxTokens: input.max_tokens,
-        memoryHistorySize: input.memory_history_size,
-        ragTopK: input.rag_top_k,
-        ragMinScore: input.rag_min_score,
-        qaMinScore: input.qa_min_score,
-        qaContextLimit: input.qa_context_limit,
-        maxResponseSymbols: input.max_response_symbols,
-        reasoningEffort: input.reasoning_effort,
-        verbosity: input.verbosity,
-        enableThinking: input.enable_thinking,
-        timezone: input.timezone,
-        languageCode: input.language_code,
-        summarizeEvery: input.summarize_every,
-        summaryMaxSize: input.summary_max_size,
-        useSummary: input.use_summary,
-        includeCrmFieldsInMemory: input.include_crm_fields_in_memory,
-        includeTriggerContext: input.include_trigger_context,
-    });
-}
-export function mapOutputConfigInput(input) {
-    const buttonGenerator = input.button_generator;
-    return compactObject({
-        displayName: input.display_name,
-        responseMode: input.response_mode,
-        buttonGenerator: buttonGenerator
-            ? compactObject({
-                enabled: buttonGenerator.enabled,
-                maxButtons: buttonGenerator.max_buttons,
-                keyboardType: buttonGenerator.keyboard_type,
-                dynamic: buttonGenerator.dynamic,
-            })
-            : undefined,
-    });
-}
-export function mapBehaviorGreetingInput(input) {
-    return compactObject({
-        botGreeting: input.bot_greeting,
-        greetingFileId: input.greeting_file_id,
-        greetingButtons: input.greeting_buttons,
-        greetingButtonsKeyboardType: input.greeting_buttons_keyboard_type,
-        popupDelaySeconds: input.popup_delay_seconds,
-    });
-}
-export function mapMediaHandlerInput(input) {
-    if (!input)
-        return undefined;
-    return compactObject({
-        behavior: input.behavior,
-        fixedResponseText: input.fixed_response_text,
-        callOperator: input.call_operator,
-        operatorComment: input.operator_comment,
-    });
-}
-export function mapBehaviorMediaHandlingInput(input) {
-    return compactObject({
-        image: mapMediaHandlerInput(input.image),
-        video: mapMediaHandlerInput(input.video),
-        audio: mapMediaHandlerInput(input.audio),
-        document: mapMediaHandlerInput(input.document),
-    });
-}
-export function mapBehaviorUrlHandlingInput(input) {
-    return compactObject({
-        behavior: input.behavior,
-        fixedResponseText: input.fixed_response_text,
-        callOperator: input.call_operator,
-        operatorComment: input.operator_comment,
-        useYoutubeDataApi: input.use_youtube_data_api,
-    });
-}
-export function mapBehaviorErrorHandlingInput(input) {
-    return compactObject({
-        aiErrorBehavior: input.ai_error_behavior,
-        aiErrorCustomMessage: input.ai_error_custom_message,
-        callOperatorWithError: input.call_operator_with_error,
-        aiErrorTargetStageId: input.ai_error_target_stage_id,
-    });
-}
-export function mapBehaviorOperatorScheduleInput(input) {
-    return compactObject({
-        enabled: input.enabled,
-        availability: input.availability,
-        unavailableMessage: input.unavailable_message,
-        botWaitingReturnHours: input.bot_waiting_return_hours,
-        followUpWaitingReturnHours: input.follow_up_waiting_return_hours,
-        skipTaskCreationOnCallOperator: input.skip_task_creation_on_call_operator,
-    });
-}
-export function mapBehaviorTypingInput(input) {
-    return compactObject({
-        waitingAnswerTime: input.waiting_answer_time,
-        canInterrupt: input.can_interrupt,
-        messageDevide: input.message_devide,
-        typingSpeed: input.typing_speed,
-        fakeDelay: input.fake_delay,
-        messageOpenDelay: input.message_open_delay,
-        goOffline: input.go_offline,
-    });
-}
-export function mapPipelineCrmBehaviorInput(input) {
-    return compactObject({
-        activePipelineIds: input.active_pipeline_ids,
-        filterEnabled: input.filter_enabled,
-        statusMovement: input.status_movement,
-        createDefaults: input.create_defaults,
-        global: input.global,
-    });
-}
-export function mapPipelineAutoFinishInput(input) {
-    return compactObject({
-        finishAutoNoanswer: input.finish_auto_noanswer,
-        finishAutoTimeout: input.finish_auto_timeout,
-        finishAutoDays: input.finish_auto_days,
-        sendFinishAutoNoteToCrm: input.send_finish_auto_note_to_crm,
-        finishAutoNoteTemplate: input.finish_auto_note_template,
-    });
-}
-export function mapPlatformAccessControlInput(input) {
-    return compactObject({
-        isActive: input.is_active,
-        isAiEnabled: input.is_ai_enabled,
-        isUserFilterEnabled: input.is_user_filter_enabled,
-        filteredUserIds: input.filtered_user_ids,
-        // v1.5 Increment 4c
-        enableCleanupCommands: input.enable_cleanup_commands,
-    });
-}
-export function mapPlatformVariablesConfigInput(input) {
-    return compactObject({
-        enableDynamicVariables: input.enable_dynamic_variables,
-        clearDynamicVarsOnHistoryClear: input.clear_dynamic_vars_on_history_clear,
-    });
-}
-export function mapPlatformCrmBehaviorInput(input) {
-    return compactObject({
-        sendToCrm: input.send_to_crm,
-        useCrossPlatformHistory: input.use_cross_platform_history,
-        responsibleAssigneeStrategy: input.responsible_assignee_strategy,
-        fixedResponsibleId: input.fixed_responsible_id,
-        sendStartNoteToCrm: input.send_start_note_to_crm,
-        startNoteTemplate: input.start_note_template,
-        sendFailedNoteToCrm: input.send_failed_note_to_crm,
-        failedNoteTemplate: input.failed_note_template,
-        sendOperatorTakeoverNoteToCrm: input.send_operator_takeover_note_to_crm,
-        operatorTakeoverNoteTemplate: input.operator_takeover_note_template,
-        // v1.5 Increment 4c — deal marker
-        dealMarkerType: input.deal_marker_type,
-        dealMarkerValue: input.deal_marker_value,
-        dealMarkerFieldId: input.deal_marker_field_id,
-        // Inbound deal-фильтр (GetCourse)
-        inboundDealFilterEnabled: input.inbound_deal_filter_enabled,
-        inboundDealFilterType: input.inbound_deal_filter_type,
-        inboundDealFilterValue: input.inbound_deal_filter_value,
-        inboundDealFilterFieldId: input.inbound_deal_filter_field_id,
-    });
-}
-export function mapPlatformWidgetMarketingInput(input) {
-    return compactObject({
-        webWidgetAllowedOrigins: input.web_widget_allowed_origins,
-        webWidgetShowPageInfo: input.web_widget_show_page_info,
-        webWidgetRateLimitPerMinute: input.web_widget_rate_limit_per_minute,
-        webWidgetCustomization: input.web_widget_customization,
-        webWidgetMarketingFieldMappings: input.web_widget_marketing_field_mappings,
-        webWidgetEntryUrlVariableMapping: input.web_widget_entry_url_variable_mapping,
-    });
-}
-export function mapPlatformInstagramCommentInput(input) {
-    return compactObject({
-        replyToInstagramComments: input.reply_to_instagram_comments,
-        instagramCommentHandlingMode: input.instagram_comment_handling_mode,
-        instagramCommentReplyMethod: input.instagram_comment_reply_method,
-        instagramCommentKeywords: input.instagram_comment_keywords,
-        replyToStoryMentions: input.reply_to_story_mentions,
-    });
-}
-const mapFunnelStageRef = (ref) => ref == null
-    ? ref
-    : {
-        pipelineCrmId: ref.pipeline_crm_id,
-        pipelineId: ref.pipeline_id,
-        statusId: ref.status_id,
-    };
-export function mapPlatformFunnelAnalyticsInput(input) {
-    // ⚠️ `compactObject` выбрасывает только `undefined`: `null` доезжает до бэкенда и означает
-    // СБРОС. Схлопни мы их — «сбросить ворота» стало бы неотличимо от «не трогать их».
-    return compactObject({
-        decisionGate: input.decision_gate === undefined
-            ? undefined
-            : input.decision_gate === null
-                ? null
-                : {
-                    submitted: mapFunnelStageRef(input.decision_gate.submitted),
-                    approved: mapFunnelStageRef(input.decision_gate.approved),
-                    rejected: mapFunnelStageRef(input.decision_gate.rejected),
-                },
-        pathTargetStage: mapFunnelStageRef(input.path_target_stage),
-        engagedInboundCount: input.engaged_inbound_count,
-        stuckThresholdHours: input.stuck_threshold_hours,
-    });
-}
-// v1.5 Increment 4c — per-channel typed section mappers
-export function mapPlatformGeneralSettingsInput(input) {
-    return compactObject({
-        name: input.name,
-        offMessage: input.off_message,
-        timezone: input.timezone,
-        isActive: input.is_active,
-    });
-}
-export function mapPlatformSalebotSettingsInput(input) {
-    return compactObject({
-        projectId: input.project_id,
-        groupId: input.group_id,
-    });
-}
-export function mapPlatformSmsgorodSettingsInput(input) {
-    return compactObject({
-        channel: input.channel,
-        sender: input.sender,
-    });
-}
-export function mapPlatformBitrix24BotSettingsInput(input) {
-    return compactObject({
-        botId: input.bot_id,
-        botCode: input.bot_code,
-        botName: input.bot_name,
-        openLineId: input.open_line_id,
-        ignoreCrmStageGate: input.ignore_crm_stage_gate,
-    });
-}
-export function mapPlatformGetcourseSettingsInput(input) {
-    const mapWaveFieldBinding = (binding) => binding
-        ? {
-            fieldId: binding.field_id,
-            fieldLabel: binding.field_label,
-        }
-        : undefined;
-    return compactObject({
-        accountDomain: input.account_domain,
-        employeeUserId: input.employee_user_id,
-        availableTransports: input.available_transports,
-        defaultTransport: input.default_transport,
-        departments: input.departments,
-        templateUserId: input.template_user_id,
-        templateDealId: input.template_deal_id,
-        waveFieldBindings: input.wave_field_bindings == null
-            ? input.wave_field_bindings
-            : compactObject({
-                productValueSource: input.wave_field_bindings.product_value_source,
-                launchType: mapWaveFieldBinding(input.wave_field_bindings.launch_type),
-                product: mapWaveFieldBinding(input.wave_field_bindings.product),
-                segment: mapWaveFieldBinding(input.wave_field_bindings.segment),
-                funnel: mapWaveFieldBinding(input.wave_field_bindings.funnel),
-                channels: mapWaveFieldBinding(input.wave_field_bindings.channels),
-            }),
-        // null → очистить маппинг; undefined → не трогать (compactObject стрипнет); массив → snake→camel.
-        fieldVariableMap: input.field_variable_map == null
-            ? input.field_variable_map
-            : input.field_variable_map.map((entry) => ({
-                getcourseFieldName: entry.getcourse_field_name,
-                variableName: entry.variable_name,
-            })),
-        targetDepartmentId: input.target_department_id,
-        deliveryCheckEnabled: input.delivery_check_enabled,
-        guardActiveSeries: input.guard_active_series,
-        guardActiveApplication: input.guard_active_application,
-        guardPaid: input.guard_paid,
-        quietDays: input.quiet_days,
-        reachabilityTtlDays: input.reachability_ttl_days,
-        // Ключи map — значения enum транспортов (совпадают с camelCase-контрактом бэка) → as-is
-        deliveryFieldMap: input.delivery_field_map,
-        // Ручной мьют GetCourse: null → очистить поле; undefined → не трогать (compactObject стрипнет).
-        manualMuteEnabled: input.manual_mute_enabled,
-        manualMuteFieldId: input.manual_mute_field_id,
-        manualMuteValue: input.manual_mute_value,
-        manualMuteActiveValue: input.manual_mute_active_value,
-        // Создание отсутствующего заказа: null → очистить, undefined → не трогать
-        createMissingDealEnabled: input.create_missing_deal_enabled,
-        createMissingDealOfferId: input.create_missing_deal_offer_id,
-        createMissingDealFunnelId: input.create_missing_deal_funnel_id,
-        createMissingDealStageId: input.create_missing_deal_stage_id,
-        // Офферы зачёта выручки: пустой массив — валидное значение «выключить», поэтому передаём
-        // как есть; undefined отстрипнет compactObject.
-        revenueOfferIds: input.revenue_offer_ids,
-    });
-}
+});
+export * from './shared-input.helpers.js';
 //# sourceMappingURL=shared.js.map