@besales/mcp 0.37.1 → 0.39.0

package/dist/tools/definitions/getcourse-cold-welcome.js

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+import { compactObject, defineTool, uuidSchema, withInstructions } from './shared.js';
+const MESSAGE_MAX_LENGTH = 4000;
+const LABEL_MAX_LENGTH = 200;
+const MAX_CONTACTS = 5000;
+/** Потолок сегментов в пакете — паритет с бэкендом и с батчем волны. */
+const MAX_BATCH_SEGMENTS = 10;
+/**
+ * Строка предсписка: getcourseUserId + опциональный пин сделки для штампа полей.
+ *
+ * Оба поля — ЧИСЛА в строковом виде, и проверяется именно форма: паритет с сестринской
+ * `besales_getcourse_wave_run_start`. Непустоты мало — «AB-123» доезжал до штампа уже ПОСЛЕ
+ * доставки сообщения, а «user@mail.ru» молча выпадал в отбракованные строки.
+ */
+const numericIdSchema = (field) => z
+    .string()
+    .trim()
+    .regex(/^\d+$/, `${field} обязан быть числовым идентификатором GetCourse`);
+const contactSchema = z
+    .object({
+    contact_id: numericIdSchema('contact_id'),
+    deal_id: numericIdSchema('deal_id').optional(),
+})
+    .strict();
+const toContacts = (contacts) => contacts?.map((contact) => ({ contactId: contact.contact_id, dealId: contact.deal_id }));
+/**
+ * Рассылка «Первое сообщение» (холодное приветствие GetCourse): МЫ пишем первыми контактам без
+ * открытого диалога. Отправка НЕОБРАТИМА и не идемпотентна на стороне GetCourse — повтор создал
+ * бы второе сообщение живому человеку, поэтому старт требует explicit_confirmation и всегда
+ * предваряется preview.
+ */
+export const getcourseColdWelcomeTools = [
+    defineTool({
+        name: 'besales_getcourse_cold_welcome_preview',
+        requiredFields: ['platform_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema,
+            created_after: z.string().datetime({ offset: true }).optional(),
+            contacts: z.array(contactSchema).min(1).max(MAX_CONTACTS).optional(),
+        })
+            .strict()
+            .refine((input) => (input.created_after !== undefined) !== (input.contacts !== undefined), {
+            message: 'Ровно одна аудитория: created_after (по дате) ЛИБО contacts (по файлу)',
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/preview`,
+            body: compactObject({
+                platformId: input.platform_id,
+                createdAfter: input.created_after,
+                contacts: toContacts(input.contacts),
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'totalContacts — сколько ЕЩЁ может получить первое сообщение; alreadyWelcomed — сколько уже получали его раньше (оно одноразово НА КОНТАКТ, не на рассылку).',
+            'Для аудитории по файлу дополнительно приходят alreadyInDialog и notInBase: контакты предсписка обязаны быть импортированы (Шаг 1) до запуска.',
+            'Всегда показывай пользователю totalContacts и alreadyWelcomed ДО старта: отправку нельзя отозвать.',
+            'Часть контактов отсеется уже в прогоне (мьют бота, нет даты эфира, недостижимость) — разбивка по причинам будет в outcomes задачи.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_cold_welcome_start',
+        requiredFields: ['explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema.optional(),
+            created_after: z.string().datetime({ offset: true }).optional(),
+            contacts: z.array(contactSchema).min(1).max(MAX_CONTACTS).optional(),
+            deal_fields: z
+                .record(z.string().regex(/^\d+$/, 'Ключ deal_fields обязан быть числовым fieldId GetCourse'), z.union([z.string(), z.number(), z.boolean(), z.null()]))
+                .optional(),
+            message: z.string().trim().min(1).max(MESSAGE_MAX_LENGTH).optional(),
+            mailing_variant_id: uuidSchema.optional(),
+            segment: z.string().max(LABEL_MAX_LENGTH).optional(),
+            product_code: z.string().max(LABEL_MAX_LENGTH).optional(),
+            funnel: z.string().max(LABEL_MAX_LENGTH).optional(),
+            explicit_confirmation: z.literal(true),
+        })
+            .strict()
+            .refine((input) => (input.message !== undefined) !== (input.mailing_variant_id !== undefined), {
+            message: 'Ровно один источник текста: message (разовый) ЛИБО mailing_variant_id (сохранённая рассылка)',
+        })
+            .refine((input) => (input.created_after !== undefined) !== (input.contacts !== undefined), {
+            message: 'Ровно одна аудитория: created_after (по дате) ЛИБО contacts (по файлу)',
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome`,
+            body: compactObject({
+                platformId: input.platform_id,
+                createdAfter: input.created_after,
+                contacts: toContacts(input.contacts),
+                dealFields: input.deal_fields,
+                message: input.message,
+                mailingVariantId: input.mailing_variant_id,
+                segment: input.segment,
+                productCode: input.product_code,
+                funnel: input.funnel,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Рассылка запущена фоном: прогресс и разбивка исходов — в задаче импорта (jobId).',
+            'Текст заморожен снимком: правка рассылки НЕ меняет идущий запуск.',
+            'Если у рассылки заданы message_text_by_segment и segment совпал — уедет ТЕКСТ СЕГМЕНТА. Назови пользователю, какой текст выбран, ДО подтверждения: отправку не отозвать.',
+            '⚠️ Метка segment аудиторию НЕ отбирает. Поэтому посегментный текст разрешён только с contacts (файл): с created_after он ушёл бы ВСЕЙ когорте после даты и выжег бы отметку приветствия — второй сегмент получил бы нулевой охват. Такой запуск отвергается 400.',
+            'Повторный запуск по той же границе безопасен: уже получившие первое сообщение не получат второе.',
+            'platform_id и deal_fields можно опустить, если они заданы в рассылке как «по умолчанию» — сервер подставит их сам.',
+            'Пустой объект deal_fields — НЕ то же, что отсутствие ключа: он означает «на этом запуске без полей» и гасит дефолты рассылки.',
+            'deal_fields штампуются ПОСЛЕ успешной отправки (пин из строки файла, иначе закреплённая сделка контакта); их отказ не отменяет отправку и виден счётчиком dealStamp.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_cold_welcome_batch_start',
+        requiredFields: ['segments', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema.optional(),
+            message: z.string().trim().min(1).max(MESSAGE_MAX_LENGTH).optional(),
+            mailing_variant_id: uuidSchema.optional(),
+            segments: z
+                .array(z
+                .object({
+                segment: z.string().max(LABEL_MAX_LENGTH).optional(),
+                product_code: z.string().max(LABEL_MAX_LENGTH).optional(),
+                funnel: z.string().max(LABEL_MAX_LENGTH).optional(),
+                deal_fields: z
+                    .record(z
+                    .string()
+                    .regex(/^\d+$/, 'Ключ deal_fields обязан быть числовым fieldId GetCourse'), z.union([z.string(), z.number(), z.boolean(), z.null()]))
+                    .optional(),
+                contacts: z.array(contactSchema).min(1).max(MAX_CONTACTS),
+            })
+                .strict())
+                .min(1)
+                .max(MAX_BATCH_SEGMENTS),
+            explicit_confirmation: z.literal(true),
+        })
+            .strict()
+            .refine((input) => (input.message !== undefined) !== (input.mailing_variant_id !== undefined), {
+            message: 'Ровно один источник текста: message (разовый) ЛИБО mailing_variant_id (сохранённая рассылка)',
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch`,
+            body: compactObject({
+                platformId: input.platform_id,
+                message: input.message,
+                mailingVariantId: input.mailing_variant_id,
+                segments: input.segments.map((segment) => compactObject({
+                    segment: segment.segment,
+                    productCode: segment.product_code,
+                    funnel: segment.funnel,
+                    dealFields: segment.deal_fields,
+                    contacts: toContacts(segment.contacts),
+                })),
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Пакет: несколько сегментов одним вызовом, у каждого свой список контактов, свои метки и свои поля сделки.',
+            'Сегменты идут ПО ОЧЕРЕДИ — задачи импорта не могут выполняться параллельно. Прогресс смотри через besales_getcourse_cold_welcome_batch_status по batchId.',
+            'Весь пакет проверяется ДО первой отправки: сегмент без текста отменяет пакет целиком, пока никому ничего не ушло.',
+            'Отказ одного сегмента НЕ останавливает остальные — смотри разбивку в статусе.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_cold_welcome_batch_status',
+        requiredFields: ['batch_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({ workspace_id: uuidSchema.optional(), batch_id: uuidSchema })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch/${input.batch_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'state — агрегат по пакету, segments[] — разбивка: у каждого свой статус, свой importJobId и своя причина отказа.',
+            'stalled=true означает, что драйвер оборвался (рестарт инстанса). НЕ запускай пакет заново — зови besales_getcourse_cold_welcome_batch_resume по тому же batch_id: источник текста хранится в плане, пересобирать списки не нужно, а уже отправленным контактам повтор не уйдёт (приветствие одноразово НА КОНТАКТ).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_cold_welcome_batch_resume',
+        requiredFields: ['batch_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({ workspace_id: uuidSchema.optional(), batch_id: uuidSchema })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch/${input.batch_id}/resume`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Поднимает драйвер для НЕ НАЧАТЫХ сегментов пакета. Подтверждения не требует: повтора отправки не будет — приветствие одноразово НА КОНТАКТ, а уже начатые сегменты не перезапускаются.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_cold_welcome_batch_cancel',
+        requiredFields: ['batch_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            batch_id: uuidSchema,
+            explicit_confirmation: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch/${input.batch_id}/cancel`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Отменяет ОСТАТОК пакета: не начатые сегменты и идущую задачу. Уже отправленное не отзывается.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_cold_welcome_cancel',
+        requiredFields: ['job_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            job_id: uuidSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/${input.job_id}/cancel`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Останавливает ОСТАТОК когорты в пределах ~10 секунд; уже отправленное не отзывается.',
+        ]),
+    }),
+];
+//# sourceMappingURL=getcourse-cold-welcome.js.map

package/dist/tools/definitions/getcourse-cold-welcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getcourse-cold-welcome.js","sourceRoot":"","sources":["../../../src/tools/definitions/getcourse-cold-welcome.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/link-tracking.d.ts

@@ -0,0 +1,34 @@
+export declare const linkTrackingTools: (import("./shared.js").ToolDefinition<{
+    workspace_id?: string | undefined;
+    include_archived?: boolean | undefined;
+    days?: number | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    name: string;
+    slug: string;
+    target_url: string;
+    workspace_id?: string | undefined;
+    product_code?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    link_id: string;
+    workspace_id?: string | undefined;
+    name?: string | undefined;
+    target_url?: string | undefined;
+    product_code?: string | undefined;
+    restore?: true | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    link_id: string;
+    explicit_confirmation: true;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    link_id: string;
+    workspace_id?: string | undefined;
+    days?: number | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    link_id: string;
+    workspace_id?: string | undefined;
+    days?: number | undefined;
+    page?: number | undefined;
+    page_size?: number | undefined;
+}>)[];

package/dist/tools/definitions/link-tracking.js

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+import { buildListQuery, compactObject, defineTool, uuidSchema, withInstructions } from './shared.js';
+const NAME_MAX_LENGTH = 200;
+const TARGET_URL_MAX_LENGTH = 2048;
+const PRODUCT_CODE_MAX_LENGTH = 64;
+/** Форма слага — паритет с `CreateTrackedLinkDto`: латиница, цифры, дефис, подчёркивание. */
+const SLUG_PATTERN = /^[a-zA-Z0-9_-]{1,64}$/;
+/** Потолок глубины аналитики — паритет с `LINK_ANALYTICS_MAX_DAYS`. */
+const ANALYTICS_MAX_DAYS = 366;
+/** Потолок страницы каталога и ленты кликов — паритет с `LINK_CATALOG_PAGE_SIZE_MAX`. */
+const PAGE_SIZE_MAX = 200;
+/** Схемы целевого адреса — паритет с `LINK_ALLOWED_PROTOCOLS`. */
+const ALLOWED_TARGET_PROTOCOLS = ['http:', 'https:'];
+const slugSchema = z
+    .string()
+    .regex(SLUG_PATTERN, 'slug: латиница, цифры, дефис и подчёркивание, до 64 символов');
+/**
+ * Целевой адрес обязан быть абсолютным http(s). Проверяем здесь, а не только на бэкенде:
+ * `javascript:`-адрес через наш общий домен — это фишинг, и узнавать о запрете из 400-й
+ * после того, как агент уже сочинил каталог ссылок, дороже, чем отвергнуть на входе.
+ *
+ * ⚠️ Разбираем `new URL()`, а не сверяем префикс: бэкендский `isAllowedTargetUrl` устроен
+ * именно так, и проверка префиксом принимала бы `http://` без хоста — значение, которое
+ * клиент считает валидным, а сервер отвергает 400-й.
+ */
+const targetUrlSchema = z
+    .string()
+    .max(TARGET_URL_MAX_LENGTH)
+    .refine((value) => {
+    try {
+        return ALLOWED_TARGET_PROTOCOLS.includes(new URL(value).protocol);
+    }
+    catch {
+        return false;
+    }
+}, { message: 'target_url должен быть абсолютным http(s)-адресом' });
+const daysSchema = z.number().int().min(1).max(ANALYTICS_MAX_DAYS);
+export const linkTrackingTools = [
+    defineTool({
+        name: 'besales_tracked_link_list',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            include_archived: z.boolean().optional(),
+            days: daysSchema.optional(),
+            limit: z.number().int().min(1).max(PAGE_SIZE_MAX).optional(),
+            offset: z.number().int().min(0).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/tracked-links${buildListQuery({
+                includeArchived: input.include_archived,
+                days: input.days,
+                limit: input.limit,
+                offset: input.offset,
+            })}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Каталог коротких ссылок воркспейса со сводкой «выдано → клики → ответы → заявки → оплаты».',
+            'Поле placeholder — готовый токен ссылки. Копируй его ДОСЛОВНО в текст дожима, рассылки или шаблона; сырой URL мимо каталога не трекается.',
+            '⚠️ Токен не пиши руками и не подставляй в него свой слаг: несуществующий слаг вырезается вместе с маркером, и клиент получит фразу ВООБЩЕ без ссылки — молча, только с ошибкой в логах. В промпт агента токен не клади вовсе (модель воспроизведёт его неточно) — там используй staticUrl.',
+            'staticUrl — анонимный короткий адрес для мест, где персональной выдачи нет: промпт агента (модель не воспроизведёт токен дословно), письмо школы, подпись вложения. Клики по нему считаются без привязки к человеку.',
+            'hasMore=true означает, что каталог не дочитан: увеличивай offset. Вывод «такого слага нет» по неполной странице недействителен.',
+            'Архивные ссылки по умолчанию скрыты — чтобы их увидеть, передай include_archived=true. Их слаги ЗАНЯТЫ: создание с тем же слагом даст 409. При include_archived=true архивные идут ПЕРВЫМИ.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_tracked_link_create',
+        requiredFields: ['name', 'slug', 'target_url'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            name: z.string().trim().min(1).max(NAME_MAX_LENGTH),
+            slug: slugSchema,
+            target_url: targetUrlSchema,
+            product_code: z.string().max(PRODUCT_CODE_MAX_LENGTH).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/tracked-links`,
+            body: compactObject({
+                name: input.name,
+                slug: input.slug,
+                targetUrl: input.target_url,
+                productCode: input.product_code,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Ссылка заведена. Возьми из ответа поле placeholder и вставь его в тексты ДОСЛОВНО — сырой URL мимо каталога не трекается, а собранный вручную токен с неточным слагом вырежется, и клиент получит фразу без ссылки.',
+            'Слаг НЕИЗМЕНЯЕМ: он уходит в отправленные сообщения. Выбирай осмысленный и стабильный (например shzh-w1-15), переименовать потом можно только name.',
+            '409 означает, что слаг занят — возможно, АРХИВНОЙ ссылкой. Тогда не выдумывай новый слаг: найди её через besales_tracked_link_list(include_archived=true) и восстанови besales_tracked_link_update(restore=true).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_tracked_link_update',
+        requiredFields: ['link_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            link_id: uuidSchema,
+            name: z.string().trim().min(1).max(NAME_MAX_LENGTH).optional(),
+            target_url: targetUrlSchema.optional(),
+            product_code: z.string().max(PRODUCT_CODE_MAX_LENGTH).optional(),
+            restore: z.literal(true).optional(),
+        })
+            .strict()
+            .refine((input) => input.name !== undefined ||
+            input.target_url !== undefined ||
+            input.product_code !== undefined ||
+            input.restore !== undefined, { message: 'Передай хотя бы одно поле для изменения' }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/tracked-links/${input.link_id}`,
+            body: compactObject({
+                name: input.name,
+                targetUrl: input.target_url,
+                productCode: input.product_code,
+                restore: input.restore,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            '⚠️ Правка target_url действует ТОЛЬКО ВПЕРЁД, и это три разных случая. Персональные коды, УЖЕ ушедшие людям, остаются на СТАРОМ адресе: каждая выдача хранит снимок адреса на момент отправки, и резолвер читает именно его. Новые выдачи получат новый адрес. Анонимный staticUrl переключается на новый адрес сразу.',
+            'Отсюда следствие: правкой target_url НЕЛЬЗЯ перенаправить тех, кому ссылка уже отправлена, — для этого нужна новая ссылка в новом тексте. Снимок ещё и делает отчёты доказуемыми: видно, куда вело конкретное сообщение.',
+            'Поля ответа сюда не копируются: slug неизменяем, а archivedAt не поле записи — снятие из архива это restore=true, архивация — besales_tracked_link_archive. Счётчики (issued/clicked/...) и placeholder/staticUrl только читаются.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_tracked_link_archive',
+        requiredFields: ['link_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            link_id: uuidSchema,
+            explicit_confirmation: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/tracked-links/${input.link_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Это АРХИВАЦИЯ, а не удаление: hard-delete у ссылок отсутствует в принципе. Код уже лежит в отправленных людям сообщениях, и удаление превратило бы живую ссылку в 404.',
+            'Архивная ссылка перестаёт подставляться в новые тексты, но её код продолжает резолвиться, клики продолжают считаться, а слаг остаётся занятым.',
+            'Восстановление — besales_tracked_link_update(restore=true). explicit_confirmation=true передавай только после явного подтверждения пользователя.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_tracked_link_breakdown',
+        requiredFields: ['link_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            link_id: uuidSchema,
+            days: daysSchema.optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/tracked-links/${input.link_id}/breakdown${buildListQuery({ days: input.days })}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Разрез одной ссылки по источникам выдачи: WAVE (волна), FOLLOWUP (дожим), CAMPAIGN (кампания), GREETING (приветствие), AGENT (обычный ответ агента).',
+            'sourceId у волны пуст: welcome запускается переходом сделки, а не джобом импорта, поэтому разрез отвечает «после волны», но не «после какой именно».',
+            'Оплата атрибутируется last-touch по ближайшему клику, поэтому суммы по разным ссылкам не складываются в общую выручку дважды.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_tracked_link_clicks',
+        requiredFields: ['link_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            link_id: uuidSchema,
+            days: daysSchema.optional(),
+            page: z.number().int().min(1).optional(),
+            page_size: z.number().int().min(1).max(PAGE_SIZE_MAX).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/tracked-links/${input.link_id}/clicks${buildListQuery({ days: input.days, page: input.page, pageSize: input.page_size })}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Лента переходов живых людей: контакт, сообщение, источник, время. Клики-предпросмотры мессенджеров отсеяны и сюда не попадают.',
+            '⚠️ Анонимные переходы по staticUrl В ЛЕНТЕ ЕСТЬ — строками, где chatUserId, contactName, messageId, issuedAt и sourceKind равны null. Это не битый ответ: у анонимного кода человека нет по построению. Не считай такие строки людьми; их суммарное число отдельно лежит в каталоге полем anonymousClicks.',
+            '⚠️ total — это число КЛИКОВ (включая повторные и анонимные), а поле clicked в каталоге — число ВЫДАЧ с первым живым кликом. Величины разные, сходиться не обязаны и по-разному отвечают на «сколько человек перешло».',
+            'Для следующей страницы увеличивай page; максимальный page_size — 200.',
+        ]),
+    }),
+];
+//# sourceMappingURL=link-tracking.js.map

package/dist/tools/definitions/link-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-tracking.js","sourceRoot":"","sources":["../../../src/tools/definitions/link-tracking.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/platform-setup.d.ts

@@ -613,6 +613,7 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
         create_missing_deal_offer_id?: number | null | undefined;
         create_missing_deal_funnel_id?: number | null | undefined;
         create_missing_deal_stage_id?: number | null | undefined;
+        revenue_offer_ids?: number[] | undefined;
     } | undefined;
 }> | import("./shared.js").ToolDefinition<{
     audit_log_id: string;

package/dist/tools/definitions/shared.d.ts

@@ -800,6 +800,7 @@ export declare const platformGetcourseSettingsSchema: z.ZodObject<{
     create_missing_deal_offer_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     create_missing_deal_funnel_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     create_missing_deal_stage_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    revenue_offer_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
 }, z.core.$strict>;
 export declare const knowledgeTableSourceSchema: z.ZodObject<{
     kind: z.ZodEnum<{

package/dist/tools/definitions/shared.js

@@ -427,6 +427,10 @@ export const pipelineAutoFinishSchema = z.object({
 // Platform settings typed sections (Group C.2 + Increment 4c per-channel)
 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(),
@@ -605,6 +609,10 @@ export const platformGetcourseSettingsSchema = z
     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.
+    revenue_offer_ids: z.array(z.number().int().positive()).optional(),
 })
     .strict();
 // Knowledge tables (Group A.5)
@@ -969,6 +977,9 @@ export function mapPlatformGetcourseSettingsInput(input) {
         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,
     });
 }
 //# sourceMappingURL=shared.js.map