@besales/mcp 0.48.0 → 1.0.0-beta.4

package/dist/tools/definitions/telegram-personal-management.js

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+import { defineTool, uuidSchema } from './shared.js';
+import { buildListQuery, compactObject } from './shared-input.helpers.js';
+const channel = { workspace_id: uuidSchema.optional(), channel_id: uuidSchema };
+const warmupFields = {
+    enabled: z.boolean().optional(),
+    images_enabled: z.boolean().optional(),
+    messages_per_day: z.int().optional(),
+    time_variation_minutes: z.int().optional(),
+    response_delay_min_minutes: z.int().optional(),
+    response_delay_max_minutes: z.int().optional(),
+    image_chance_percent: z.int().optional(),
+    posts_to_react: z.int().optional(),
+    max_accounts_per_channel_reaction: z.int().optional(),
+    pairing_hour_utc: z.int().optional(),
+    hourly_interval_hours: z.number().optional(),
+    reaction_types: z.array(z.string()).max(100).optional(),
+    reaction_hours_utc: z.array(z.int()).max(24).optional(),
+};
+export const telegramPersonalManagementTools = [
+    defineTool({
+        name: 'besales_platform_telegram_personal_accounts',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 1024 * 1024 },
+        schema: z
+            .object({
+            ...channel,
+            search: z.string().max(200).optional(),
+            status: z
+                .enum([
+                'BANNED',
+                'CONNECTED',
+                'CONNECTING',
+                'DISCONNECTED',
+                'ERROR',
+                'NEEDS_CODE',
+                'NEEDS_PASSWORD',
+                'PENDING_VERIFICATION',
+                'SESSION_UPLOADED',
+            ])
+                .optional(),
+            page: z.int().min(1).optional(),
+            limit: z.int().min(1).max(100).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/channels/${input.channel_id}/telegram-personal/accounts${buildListQuery({
+                search: input.search,
+                status: input.status,
+                page: input.page,
+                limit: input.limit,
+            })}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_warmup',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 1024 * 1024 },
+        schema: z.object(channel).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/channels/${input.channel_id}/telegram-personal/warmup`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_warmup_update',
+        sideEffect: 'write',
+        reversible: true,
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id'],
+        schema: z.object({ ...channel, ...warmupFields }).strict(),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/channels/${input.channel_id}/telegram-personal/warmup`,
+            body: compactObject({
+                enabled: input.enabled,
+                imagesEnabled: input.images_enabled,
+                messagesPerDay: input.messages_per_day,
+                timeVariationMinutes: input.time_variation_minutes,
+                responseDelayMinMinutes: input.response_delay_min_minutes,
+                responseDelayMaxMinutes: input.response_delay_max_minutes,
+                imageChancePercent: input.image_chance_percent,
+                postsToReact: input.posts_to_react,
+                maxAccountsPerChannelReaction: input.max_accounts_per_channel_reaction,
+                pairingHourUtc: input.pairing_hour_utc,
+                hourlyIntervalHours: input.hourly_interval_hours,
+                reactionTypes: input.reaction_types,
+                reactionHoursUtc: input.reaction_hours_utc,
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_account_warmup',
+        sideEffect: 'write',
+        reversible: true,
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'account_id', 'is_warming_up'],
+        schema: z
+            .object({
+            ...channel,
+            account_id: uuidSchema,
+            is_warming_up: z.boolean(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/channels/${input.channel_id}/telegram-personal/accounts/${input.account_id}/warmup`,
+            body: {
+                isWarmingUp: input.is_warming_up,
+            },
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_ramp',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: [],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 16 * 1024 },
+        schema: z.object({ workspace_id: uuidSchema.optional() }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/telegram-outreach-settings`,
+        }),
+        enhanceResponse: (response) => ({
+            newAccountRampEnabled: response.newAccountRampEnabled,
+        }),
+    }),
+];
+//# sourceMappingURL=telegram-personal-management.js.map

package/dist/tools/definitions/telegram-personal-management.js.map

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

package/dist/tools/definitions/telegram-personal-restrictions.d.ts

@@ -0,0 +1,19 @@
+export declare const telegramPersonalRestrictionTools: (import("./shared.js").ToolDefinition<{
+    channel_id: string;
+    idempotency_key: string;
+    workspace_id?: string | undefined;
+    account_ids?: string[] | undefined;
+    all?: true | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    explicit_confirmation: true;
+    channel_id: string;
+    idempotency_key: string;
+    text?: string | undefined;
+    workspace_id?: string | undefined;
+    account_ids?: string[] | undefined;
+    all?: true | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    channel_id: string;
+    task_id: string;
+    workspace_id?: string | undefined;
+}>)[];

package/dist/tools/definitions/telegram-personal-restrictions.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { defineTool, uuidSchema, withInstructions } from './shared.js';
+const selection = {
+    workspace_id: uuidSchema.optional(),
+    channel_id: uuidSchema,
+    account_ids: z
+        .array(z.uuidv4())
+        .min(1)
+        .max(100)
+        .refine((ids) => new Set(ids.map((id) => id.toLowerCase())).size === ids.length, 'Список номеров не должен содержать дубли')
+        .optional(),
+    all: z.literal(true).optional(),
+    idempotency_key: z
+        .string()
+        .min(1)
+        .max(200)
+        .regex(/^[\x21-\x7e]+$/u),
+};
+function oneSelection(input, ctx) {
+    if ((input.account_ids !== undefined) === (input.all === true)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['account_ids'],
+            message: 'Выбери ровно одно: список номеров или all:true',
+        });
+    }
+}
+const checkSchema = z.object(selection).strict().superRefine(oneSelection);
+const appealSchema = z
+    .object({
+    ...selection,
+    text: z
+        .string()
+        .trim()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe('Необязательный текст. По умолчанию система подбирает разные английские апелляции для каждого номера.'),
+    explicit_confirmation: z
+        .literal(true)
+        .describe('Только после явного согласия человека: номер отправит апелляцию @SpamBot от своего имени; отменить отправку нельзя.'),
+})
+    .strict()
+    .superRefine(oneSelection);
+function batchRequest(input, appeal) {
+    return {
+        method: 'POST',
+        path: `/channels/${input.channel_id}/telegram-personal/restriction-${appeal ? 'appeals' : 'checks'}`,
+        body: {
+            ...(input.account_ids === undefined ? { all: true } : { accountIds: input.account_ids }),
+            ...(appeal && input.text !== undefined ? { text: input.text } : {}),
+            idempotencyKey: input.idempotency_key,
+        },
+    };
+}
+const batchInstructions = (response) => withInstructions(response, [
+    'Покажи исход каждого номера отдельно: QUEUED с taskId — принято в очередь, а не результат проверки или доставки; FAILED и SKIPPED — с кодом и сообщением.',
+    'При неизвестном исходе сначала прочитай задачу или доступность номеров. Новый ключ автоматически не создавай; для того же намерения сохраняй прежний ключ и аргументы.',
+]);
+export const telegramPersonalRestrictionTools = [
+    defineTool({
+        name: 'besales_platform_telegram_personal_restriction_check',
+        sideEffect: 'write',
+        idempotent: true,
+        closedWorld: false,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'idempotency_key'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 256 * 1024 },
+        schema: checkSchema,
+        createRequest: (input) => batchRequest(input, false),
+        enhanceResponse: batchInstructions,
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_restriction_appeal',
+        sideEffect: 'write',
+        reversible: false,
+        idempotent: true,
+        closedWorld: false,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'idempotency_key', 'explicit_confirmation'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 256 * 1024 },
+        schema: appealSchema,
+        createRequest: (input) => batchRequest(input, true),
+        enhanceResponse: batchInstructions,
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_operational_task_get',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'task_id'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 16 * 1024 },
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            channel_id: uuidSchema,
+            task_id: uuidSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/channels/${input.channel_id}/telegram-personal/operational-tasks/${input.task_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'state — состояние задачи; restrictionStatus — текущий статус ограничений номера, прочитанный после задачи. SUCCEEDED не означает отсутствие ограничений. null означает, что статус номера недоступен. Более поздние действия могли изменить статус.',
+        ]),
+    }),
+];
+//# sourceMappingURL=telegram-personal-restrictions.js.map

package/dist/tools/definitions/telegram-personal-restrictions.js.map

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

package/dist/tools/definitions/telegram-pool-policy.d.ts

@@ -0,0 +1,8 @@
+/** Единственная новая операция управления фермой; записи в Telegram не выполняет. */
+export declare const telegramPoolPolicyTools: import("./shared.js").ToolDefinition<{
+    platform_id: string;
+    operation: "set" | "get";
+    workspace_id?: string | undefined;
+    rebind_policy?: "escalate" | "rebind" | undefined;
+    idempotency_key?: string | undefined;
+}>[];

package/dist/tools/definitions/telegram-pool-policy.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { defineTool, uuidSchema } from './shared.js';
+/** Единственная новая операция управления фермой; записи в Telegram не выполняет. */
+export const telegramPoolPolicyTools = [
+    defineTool({
+        name: 'besales_platform_telegram_personal_pool_policy',
+        sideEffect: 'write',
+        reversible: true,
+        idempotent: true,
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['platform_id', 'operation'],
+        // Фиксированный ответ одного канала: две options, consequence и previousRebindPolicy
+        // после записи. Текущие ru/en/es/id/uz квитанции меньше 1 КиБ; 16 КиБ оставляют
+        // запас локализации без обрезки последствий и без фиктивного совета сузить запрос.
+        resultPolicy: { neverTruncate: true, maxResultBytes: 16 * 1024 },
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema,
+            operation: z.enum(['get', 'set']),
+            rebind_policy: z.enum(['rebind', 'escalate']).optional(),
+            idempotency_key: z
+                .string()
+                .min(1)
+                .max(200)
+                .regex(/^[\x21-\x7e]+$/u)
+                .optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            for (const key of ['rebind_policy', 'idempotency_key']) {
+                if ((input.operation === 'set') !== (input[key] !== undefined)) {
+                    ctx.addIssue({
+                        code: 'custom',
+                        path: [key],
+                        message: input.operation === 'set' ? 'Required for set' : 'Not allowed for get',
+                    });
+                }
+            }
+        }),
+        createRequest: (input) => ({
+            method: input.operation === 'get' ? 'GET' : 'PATCH',
+            path: `/channels/${input.platform_id}/telegram-personal/pool-policy`,
+            ...(input.operation === 'get'
+                ? {}
+                : {
+                    body: {
+                        rebindPolicy: input.rebind_policy,
+                        idempotencyKey: input.idempotency_key,
+                    },
+                }),
+        }),
+    }),
+];
+//# sourceMappingURL=telegram-pool-policy.js.map

package/dist/tools/definitions/telegram-pool-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-pool-policy.js","sourceRoot":"","sources":["../../../src/tools/definitions/telegram-pool-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU,CAAC;QACT,IAAI,EAAE,gDAAgD;QACtD,UAAU,EAAE,OAAO;QACnB,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,IAAI;QACjB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;QAC5C,qFAAqF;QACrF,gFAAgF;QAChF,mFAAmF;QACnF,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,GAAG,IAAI,EAAE;QAChE,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,YAAY,EAAE,UAAU,CAAC,QAAQ,EAAE;YACnC,WAAW,EAAE,UAAU;YACvB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACjC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;YACxD,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,KAAK,CAAC,iBAAiB,CAAC;iBACxB,QAAQ,EAAE;SACd,CAAC;aACD,MAAM,EAAE;aACR,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,KAAK,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAU,EAAE,CAAC;gBAChE,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;oBAC/D,GAAG,CAAC,QAAQ,CAAC;wBACX,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,GAAG,CAAC;wBACX,OAAO,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,qBAAqB;qBAChF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACJ,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzB,MAAM,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;YACnD,IAAI,EAAE,aAAa,KAAK,CAAC,WAAW,gCAAgC;YACpE,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK;gBAC3B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,IAAI,EAAE;wBACJ,YAAY,EAAE,KAAK,CAAC,aAAa;wBACjC,cAAc,EAAE,KAAK,CAAC,eAAe;qBACtC;iBACF,CAAC;SACP,CAAC;KACH,CAAC;CACH,CAAC"}

package/dist/tools/definitions/touch-history-alias.d.ts

@@ -0,0 +1,4 @@
+export declare const touchHistoryAliasTools: readonly [import("./shared.js").ToolDefinition<{
+    getcourse_user_id: number;
+    workspace_id?: string | undefined;
+}>];

package/dist/tools/definitions/touch-history-alias.js

@@ -0,0 +1,99 @@
+// Отгруженное имя истории касаний человека школы, вернувшееся в ветку `v2`.
+//
+// ⛔ Источников у v2 ЧЕТЫРЕ, а у отгруженного контракта было три, и два из четырёх — новые
+// (приветствия волны и журнал касаний шва доставки). Сводить их к отгруженной паре нельзя: ответ
+// «мы не писали» собрался бы из двух источников, не увидев третьего. Поэтому отдаётся полная
+// форма v2, а отгруженные имена ДОПИСЫВАЮТСЯ сверху — существующий читатель находит `touches`,
+// `sends`, `truncated` и `sendsTruncated` там же, где искал.
+import { z } from 'zod';
+import { defineTool, uuidSchema, withInstructions } from './shared.js';
+function section(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/**
+ * Дописать отгруженные имена поверх формы v2.
+ *
+ * ⛔ Именно дописать, а не заменить: `touches` отгруженного контракта — это ПРАВА холодного
+ * приветствия, и приравняв к ним весь ответ, мы спрятали бы приветствия волны и журнал касаний.
+ * Существующий читатель получает то, что искал, новый видит все четыре источника.
+ */
+function withShippedNames(response) {
+    if (typeof response !== 'object' || response === null || Array.isArray(response))
+        return response;
+    const row = response;
+    const claims = section(row.claims);
+    const sends = section(row.ownSends);
+    return {
+        ...row,
+        touches: (claims?.items ?? []).map(withShippedRowNames),
+        sends: (sends?.items ?? []).map(withShippedRowNames),
+        truncated: claims?.truncated ?? false,
+        sendsTruncated: sends?.truncated ?? false,
+    };
+}
+/**
+ * ⛔ Имена СТРОК тоже отгруженные, а не только имена списков. Прежний контракт называл канал
+ * `platformId`, v2 называет его `channelId`: подняв наверх список и оставив строки как есть, мы
+ * отдали бы существующему читателю строки без канала — поле просто исчезло бы, молча.
+ *
+ * Дописывается, а не переименовывается: имя v2 остаётся на месте для нового читателя.
+ */
+function withShippedRowNames(item) {
+    if (typeof item !== 'object' || item === null || Array.isArray(item))
+        return item;
+    const row = item;
+    return { ...row, platformId: row.channelId ?? null };
+}
+export const touchHistoryAliasTools = [
+    defineTool({
+        name: 'besales_contact_touch_history',
+        sideEffect: 'none',
+        closedWorld: true,
+        carriesCustomerData: true,
+        // ⛔ Обрезать ответ молча нельзя: обрезанная история читается как «больше мы не писали». Но и
+        // тупика быть не должно — сузить запрос вызывающему нечем, аргумент у инструмента один.
+        // Выход объявлен строками, которые МОЖНО выбросить: сами перечни касаний. Полнота разделов,
+        // флаги усечения и ОБА готовых ответа при этом остаются — то есть ответы на главные вопросы
+        // переживают переполнение, а подробности за ними идут каноническими инструментами.
+        resultPolicy: {
+            neverTruncate: true,
+            droppablePaths: [
+                'touchEvents.items',
+                'claims.items',
+                'waveWelcomes.items',
+                'ownSends.items',
+                'touches',
+                'sends',
+            ],
+            narrowingHint: 'История одного человека не сужается аргументами: он один. При переполнении читай разделы по отдельности каноническими инструментами разбора рассылок.',
+        },
+        requiredFields: ['getcourse_user_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            // ⛔ Носитель остаётся целым, как у отгруженного контракта: идентификаторы школы уже
+            // около 8,5·10⁸, и сервер принимает их строкой пути без потолка обычного целого.
+            getcourse_user_id: z.number().int().min(1),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/getcourse/users/${input.getcourse_user_id}/touch-history`,
+        }),
+        enhanceResponse: (response) => withInstructions(withShippedNames(response), [
+            '⚠️ Ответ несёт историю переписки с конкретным человеком, а не агрегат.',
+            '⛔ Источники НЕ складываются. Право (claims, waveWelcomes) берётся ДО отправки: строка есть и у попытки, которая никуда не ушла. Строка реестра получателей (ownSends) пишется ПОСЛЕ доставки и best-effort — её отсутствие неотправки НЕ доказывает. Сумма этих чисел не означает ничего.',
+            '⛔ У каждого раздела своя полнота (completeness) и причина словами (note). Пустой раздел с полнотой PARTIAL означает «данных нет», а НЕ «не касались»: делать вывод об отсутствии можно только по разделу с полнотой LIVE.',
+            '⛔ Готовых ответов ДВА, и они про РАЗНОЕ. deliveryProven — «есть ли доказательство, что сообщение дошло». touchHeld — «занято ли право первого касания», то есть можно ли слать автоматическое первое сообщение. Взятое право доставки НЕ доказывает: строка есть и у попытки, которая никуда не ушла. У обоих по два значения (YES и UNKNOWN); значения «нет» не существует, потому что ни один источник не полон.',
+            'Оба ответа посчитаны по ВСЕЙ выдаче, а не по показанной странице: доказанная отправка старше потолка страницы в них всё равно попадает.',
+            'Род имени касания (kind) — служебный ключ, а не текст: SEGMENT_LABEL — «этим сегментом уже слали»; SEGMENT_TEXT — «этот текст этим сегментом не дважды»; TEXT — «тот же текст не дважды»; RESEND_EPISODE — «тот же текст снова, но один раз на новую запись»; REGISTRATION — «один эпизод регистрации, одно приветствие»; LEGACY_WELCOME — восстановленное переносом. Человеку объясняй словами, сам ключ не показывай.',
+            'Пустой mailingName у старых строк — НЕ потеря данных: название рассылки начали сохранять позже. Показывай такую строку датой и родом касания словами.',
+            'Ключ — ЧЕЛОВЕК школы, а не карточка: в contactIds приходят ВСЕ карточки этого человека в рабочей области, и история собрана по ним всем.',
+            'firstWelcomeAt всегда пуст: своей колонки «самое раннее приветствие» у v2 нет вовсе. Это не потеря данных в конкретном запросе, а отсутствие носителя.',
+            '⛔ touchKey — служебное имя ПРАВА, а не текст для показа. Человеку его показывают только вместе с человеческим названием рассылки (mailingName); агенту служебные имена не показывают вовсе.',
+            'Отгруженные touches/sends/truncated/sendsTruncated дописаны поверх и указывают на разделы claims и ownSends; у строк дописано отгруженное platformId рядом с channelId. Полная картина — в четырёх разделах.',
+        ]),
+    }),
+];
+//# sourceMappingURL=touch-history-alias.js.map

package/dist/tools/definitions/touch-history-alias.js.map

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