@besales/mcp 1.0.0-beta.4 → 1.0.0-beta.7

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

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { defineTool, uuidSchema, withInstructions } from './shared.js';
+import { compactObject } from './shared-input.helpers.js';
+// Границы зеркалят DTO ядра (telegram-personal-profile.dto.ts, telegram-personal-usernames.ts):
+// мост не строже ядра там, где решает ферма номеров.
+const MAX_ACCOUNTS = 100;
+const BIO_MAX_LENGTH = 140;
+const USERNAME_PATTERN = /^(?!.*__)[A-Za-z][A-Za-z0-9_]{3,30}[A-Za-z0-9]$/u;
+const username = z.string().min(5).max(32).regex(USERNAME_PATTERN);
+const birthday = z
+    .object({
+    day: z.int().min(1).max(31),
+    month: z.int().min(1).max(12),
+    year: z.int().min(1).max(9999).optional(),
+})
+    .strict();
+const shape = {
+    workspace_id: uuidSchema.optional(),
+    channel_id: uuidSchema,
+    account_ids: z
+        .array(z.uuidv4())
+        .min(1)
+        .max(MAX_ACCOUNTS)
+        .refine((ids) => new Set(ids.map((id) => id.toLowerCase())).size === ids.length, 'Список номеров не должен содержать дубли')
+        .optional(),
+    all: z.literal(true).optional(),
+    first_name: z.string().max(64).optional(),
+    last_name: z.string().max(64).optional(),
+    bio: z
+        .string()
+        .refine((value) => Array.from(value).length <= BIO_MAX_LENGTH, `Описание — не больше ${BIO_MAX_LENGTH} знаков`)
+        .optional(),
+    birthday: birthday.nullable().optional(),
+    usernames: z
+        .array(z.object({ account_id: z.uuidv4(), username }).strict())
+        .min(1)
+        .max(MAX_ACCOUNTS)
+        .optional(),
+    username_base: username.optional(),
+    idempotency_key: z
+        .string()
+        .min(1)
+        .max(200)
+        .regex(/^[\x21-\x7e]+$/u),
+};
+/** Правила режимов повторяют bulkUsernameMode ядра: нарушение отвергается до HTTP. */
+function checkProfileBulk(input, ctx) {
+    const refuse = (path, message) => ctx.addIssue({ code: 'custom', path: [path], message });
+    if (input.usernames !== undefined) {
+        if (input.username_base !== undefined) {
+            refuse('username_base', 'Ники — ровно один режим: usernames по номерам или username_base, но не оба сразу');
+        }
+        if (input.account_ids !== undefined) {
+            refuse('account_ids', 'С usernames номера выбирает сам список: account_ids не передаётся');
+        }
+        if (input.all !== undefined) {
+            refuse('all', 'С usernames номера выбирает сам список: all не передаётся');
+        }
+        const accounts = new Set(input.usernames.map((entry) => entry.account_id.toLowerCase()));
+        const names = new Set(input.usernames.map((entry) => entry.username.toLowerCase()));
+        if (accounts.size !== input.usernames.length || names.size !== input.usernames.length) {
+            refuse('usernames', 'В usernames номера и ники не должны повторяться');
+        }
+    }
+    else if ((input.account_ids !== undefined) === (input.all === true)) {
+        refuse('account_ids', 'Выбери ровно одно: список номеров account_ids или all:true');
+    }
+    const changes = input.first_name !== undefined ||
+        input.last_name !== undefined ||
+        input.bio !== undefined ||
+        input.birthday !== undefined ||
+        input.usernames !== undefined ||
+        input.username_base !== undefined;
+    if (!changes) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'Нечего менять: передай хотя бы одно поле профиля или ники',
+        });
+    }
+}
+const profileBulkSchema = z.object(shape).strict().superRefine(checkProfileBulk);
+function profileBulkRequest(input) {
+    const body = {
+        patch: compactObject({
+            firstName: input.first_name,
+            lastName: input.last_name,
+            bio: input.bio,
+            birthday: input.birthday,
+        }),
+    };
+    if (input.usernames !== undefined) {
+        body.usernames = input.usernames.map((entry) => ({
+            accountId: entry.account_id,
+            username: entry.username,
+        }));
+    }
+    else if (input.account_ids !== undefined) {
+        body.accountIds = input.account_ids;
+    }
+    else {
+        body.all = true;
+    }
+    if (input.username_base !== undefined)
+        body.usernameBase = input.username_base;
+    return {
+        method: 'POST',
+        path: `/channels/${input.channel_id}/telegram-personal/profile/bulk`,
+        body,
+        // Маршрут ядра читает ключ из x-idempotency-key; общий Idempotency-Key он не видит.
+        idempotencyKey: input.idempotency_key,
+        idempotencyKeyHeader: 'X-Idempotency-Key',
+    };
+}
+export const telegramPersonalProfileTools = [
+    defineTool({
+        name: 'besales_platform_telegram_personal_profile_bulk',
+        sideEffect: 'write',
+        idempotent: true,
+        closedWorld: false,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'idempotency_key'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 16 * 1024 },
+        schema: profileBulkSchema,
+        createRequest: profileBulkRequest,
+        enhanceResponse: (response) => withInstructions(response, [
+            'Ответ — принятие задания фермы, а не итог: state PENDING значит «принято», total — число номеров. Итог по каждому номеру читай в besales_platform_telegram_personal_profile_job по job_id.',
+            'При неизвестном исходе новый ключ автоматически не создавай: повтори вызов с тем же idempotency_key и теми же аргументами — ядро вернёт прежний ответ, профиль второй раз не изменится.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_profile_job',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'job_id'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 256 * 1024 },
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            channel_id: uuidSchema,
+            job_id: z.string().min(1).max(128),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/channels/${input.channel_id}/telegram-personal/profile/bulk/${encodeURIComponent(input.job_id)}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Пока state не COMPLETED, итог неполный: повтори чтение позже. Исход номера — items[].state; при SUCCEEDED смотри ещё outcome.fields.<поле>: частичный успех остаётся SUCCEEDED, а отдельное поле может быть FAILED с failure_code.',
+            'TELEGRAM_BIO_TOO_LONG — описание длиннее лимита Telegram (до 70 знаков без Premium, до 140 с Premium). PROFILE_PROVIDER_OUTCOME_UNKNOWN — исход у Telegram неизвестен: не повторяй вслепую, сначала сверь профиль номера.',
+        ]),
+    }),
+];
+//# sourceMappingURL=telegram-personal-profile.js.map

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

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

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

@@ -0,0 +1,42 @@
+export declare const telegramPersonalProxyTools: (import("./shared.js").ToolDefinition<{
+    channel_id: string;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    session_id: string;
+    channel_id: string;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    proxy_id: string;
+    explicit_confirmation: true;
+    channel_id: string;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    account_id: string;
+    action_id: string;
+    proxy_id: string;
+    country_change_confirmed: boolean;
+    explicit_confirmation: true;
+    channel_id: string;
+    workspace_id?: string | undefined;
+}>)[];
+export declare const telegramPersonalChannelProxyTools: (import("./shared.js").ToolDefinition<{
+    channel_id: string;
+    status?: "ACTIVE" | "CHECKING" | "ERROR" | "INACTIVE" | undefined;
+    country_code?: string | undefined;
+    search?: string | undefined;
+    cursor?: string | undefined;
+    limit?: number | undefined;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    action_id: string;
+    channel_id: string;
+    proxy_ids?: string[] | undefined;
+    count?: number | undefined;
+    country_code?: string | undefined;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    proxy_id: string;
+    action_id: string;
+    channel_id: string;
+    workspace_id?: string | undefined;
+}>)[];

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

@@ -0,0 +1,204 @@
+import { z } from 'zod';
+import { defineTool, uuidSchema, withInstructions } from './shared.js';
+import { telegramProxyListFields, telegramProxyListQuery } from './telegram-proxy-stock.js';
+const channel = { workspace_id: uuidSchema.optional(), channel_id: uuidSchema };
+const resultPolicy = { neverTruncate: true, maxResultBytes: 16 * 1024 };
+const takeSchema = z.object({
+    ...channel,
+    action_id: uuidSchema,
+    proxy_ids: z.array(uuidSchema).min(1).max(50).refine((ids) => new Set(ids.map((id) => id.toLowerCase())).size === ids.length, 'proxy_ids должны быть разными').optional(),
+    count: z.int().min(1).max(50).optional(),
+    country_code: z.string().regex(/^[A-Z]{2}$/u).optional(),
+}).strict().superRefine((input, ctx) => {
+    if (input.proxy_ids !== undefined
+        ? input.count !== undefined || input.country_code !== undefined
+        : input.count === undefined) {
+        ctx.addIssue({ code: 'custom', message: 'Ровно одна форма: proxy_ids или count с необязательной country_code' });
+    }
+});
+export const telegramPersonalProxyTools = [
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_import_link',
+        sideEffect: 'write',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id'],
+        resultPolicy,
+        schema: z.object(channel).strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/channels/${input.channel_id}/telegram-proxy-import-sessions`,
+        }),
+        enhanceResponse: (response) => {
+            const link = response;
+            return withInstructions({
+                session_id: link.session_id,
+                setup_page_url: link.setup_page_url,
+                expires_at: link.expires_at,
+            }, [
+                'Отдай ссылку человеку: он входит в приложение и вводит логины и пароли прокси на защищённой странице, не в чате. Ссылка одноразовая, живёт до expires_at.',
+                'Итог по session_id читай через besales_platform_telegram_personal_proxy_import_status; выдача ссылки ещё не означает загрузку прокси.',
+            ]);
+        },
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_import_status',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'session_id'],
+        resultPolicy,
+        schema: z.object({ ...channel, session_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/channels/${input.channel_id}/telegram-proxy-import-sessions/${input.session_id}`,
+        }),
+        enhanceResponse: (response) => {
+            const status = response;
+            const summary = status.summary;
+            return withInstructions({
+                sessionId: status.sessionId,
+                status: status.status,
+                expiresAt: status.expiresAt,
+                summary: summary && {
+                    total: summary.total,
+                    pending: summary.pending,
+                    accepted: summary.accepted,
+                    duplicates: summary.duplicates,
+                    invalid: summary.invalid,
+                    checkFailed: summary.checkFailed,
+                    rejected: summary.rejected,
+                    registered: summary.registered,
+                },
+            }, [
+                'Ответ содержит только состояние и счётчики, без строк прокси. COMPLETED — итог обработки; UNKNOWN не означает успех: повтори чтение позже. EXPIRED и CANCELLED — сессия закрыта.',
+            ]);
+        },
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_delete',
+        sideEffect: 'write',
+        reversible: false,
+        closedWorld: false,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'proxy_id', 'explicit_confirmation'],
+        resultPolicy,
+        schema: z
+            .object({
+            ...channel,
+            proxy_id: uuidSchema,
+            explicit_confirmation: z.literal(true).describe('Явное согласие человека на удаление прокси.'),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/channels/${input.channel_id}/telegram-personal/proxies/${input.proxy_id}`,
+        }),
+        enhanceResponse: () => ({ deleted: true }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_account_proxy_change',
+        sideEffect: 'write',
+        idempotent: true,
+        closedWorld: false,
+        defaultWorkspaceId: true,
+        requiredFields: [
+            'channel_id',
+            'account_id',
+            'action_id',
+            'proxy_id',
+            'country_change_confirmed',
+            'explicit_confirmation',
+        ],
+        resultPolicy,
+        schema: z
+            .object({
+            ...channel,
+            account_id: uuidSchema,
+            action_id: uuidSchema,
+            proxy_id: uuidSchema,
+            country_change_confirmed: z.boolean(),
+            explicit_confirmation: z.literal(true).describe('Явное согласие человека: номер переподключится.'),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/channels/${input.channel_id}/telegram-personal/accounts/${input.account_id}/change-proxy`,
+            body: {
+                actionId: input.action_id,
+                proxyId: input.proxy_id,
+                countryChangeConfirmed: input.country_change_confirmed,
+            },
+        }),
+        enhanceResponse: (response) => {
+            const receipt = response;
+            return withInstructions({
+                message: receipt.message,
+                action_id: receipt.action_id,
+                state: receipt.state,
+                code: receipt.code,
+                retry_after_ms: receipt.retry_after_ms,
+            }, [
+                'Номер переключён только при state=SUCCEEDED. UNKNOWN и PENDING — исход ещё не подтверждён; FAILED и EXPIRED — отказ, смотри code. Учитывай retry_after_ms.',
+                'Для повтора того же намерения сохрани action_id и все аргументы. Новый action_id автоматически не создавай: номер переподключится.',
+            ]);
+        },
+    }),
+];
+export const telegramPersonalChannelProxyTools = [
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxies',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id'],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 1024 * 1024 },
+        schema: z.object({ ...channel, ...telegramProxyListFields }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/channels/${input.channel_id}/telegram-personal/proxies${telegramProxyListQuery(input)}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_take_from_stock',
+        sideEffect: 'write',
+        idempotent: true,
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'action_id'],
+        resultPolicy,
+        schema: takeSchema,
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/channels/${input.channel_id}/telegram-personal/proxies/take-from-stock`,
+            idempotencyKey: input.action_id,
+            idempotencyKeyHeader: 'X-Idempotency-Key',
+            body: input.proxy_ids !== undefined
+                ? { proxyIds: input.proxy_ids }
+                : { count: input.count, ...(input.country_code === undefined ? {} : { countryCode: input.country_code }) },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Переносится весь прокси, атомарно: любой отказ означает, что ничего не перенесено. action_id создаётся один на намерение; новое намерение человека — новый action_id. При 503 исход неизвестен — повтори то же намерение с тем же action_id и теми же аргументами.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_return_to_stock',
+        sideEffect: 'write',
+        idempotent: true,
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['channel_id', 'proxy_id', 'action_id'],
+        resultPolicy,
+        schema: z.object({ ...channel, proxy_id: uuidSchema, action_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/channels/${input.channel_id}/telegram-personal/proxies/${input.proxy_id}/return-to-stock`,
+            idempotencyKey: input.action_id,
+            idempotencyKeyHeader: 'X-Idempotency-Key',
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Возвращается только свободный прокси. TELEGRAM_PROXY_NOT_EMPTY — освободи его; TELEGRAM_PROXY_ADDRESS_IN_USE — такой адрес уже в запасе, предложи удалить этот прокси из канала. action_id создаётся один на намерение; новое намерение человека — новый action_id. При 503 исход неизвестен: повтори то же намерение с тем же action_id и теми же аргументами.',
+        ]),
+    }),
+];
+//# sourceMappingURL=telegram-personal-proxies.js.map

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

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

package/dist/tools/definitions/telegram-proxy-stock.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const telegramProxyListFields: {
+    status: z.ZodOptional<z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        CHECKING: "CHECKING";
+        ERROR: "ERROR";
+        INACTIVE: "INACTIVE";
+    }>>;
+    country_code: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodInt>;
+};
+export declare function telegramProxyListQuery(input: z.infer<z.ZodObject<typeof telegramProxyListFields>>): string;
+export declare const telegramProxyStockTools: (import("./shared.js").ToolDefinition<{
+    status?: "ACTIVE" | "CHECKING" | "ERROR" | "INACTIVE" | undefined;
+    country_code?: string | undefined;
+    search?: string | undefined;
+    cursor?: string | undefined;
+    limit?: number | undefined;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    session_id: string;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    proxy_id: string;
+    explicit_confirmation: true;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    proxy_id: string;
+    workspace_id?: string | undefined;
+}>)[];

package/dist/tools/definitions/telegram-proxy-stock.js

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+import { defineTool, uuidSchema, withInstructions } from './shared.js';
+import { buildListQuery } from './shared-input.helpers.js';
+const workspace = { workspace_id: uuidSchema.optional() };
+const resultPolicy = { neverTruncate: true, maxResultBytes: 16 * 1024 };
+export const telegramProxyListFields = {
+    status: z.enum(['ACTIVE', 'CHECKING', 'ERROR', 'INACTIVE']).optional(),
+    country_code: z.string().regex(/^[A-Z]{2}$/u).optional(),
+    search: z.string().max(200).optional(),
+    cursor: uuidSchema.optional(),
+    limit: z.int().min(1).max(100).optional(),
+};
+export function telegramProxyListQuery(input) {
+    return buildListQuery({
+        status: input.status,
+        countryCode: input.country_code,
+        search: input.search,
+        cursor: input.cursor,
+        limit: input.limit,
+    });
+}
+export const telegramProxyStockTools = [
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_stock_list',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: [],
+        resultPolicy: { neverTruncate: true, maxResultBytes: 1024 * 1024 },
+        schema: z.object({ ...workspace, ...telegramProxyListFields }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/telegram-proxy-stock/proxies${telegramProxyListQuery(input)}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_stock_import_link',
+        sideEffect: 'write',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: [],
+        resultPolicy,
+        schema: z.object(workspace).strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/telegram-proxy-stock/import-sessions`,
+        }),
+        enhanceResponse: (response) => {
+            const link = response;
+            return withInstructions({ session_id: link.session_id, setup_page_url: link.setup_page_url, expires_at: link.expires_at }, [
+                'Отдай ссылку человеку: он входит в приложение и вводит логины и пароли прокси на защищённой странице общего запаса пространства, не в чате. Ссылка одноразовая, живёт до expires_at.',
+                'Выдача ссылки ещё не означает загрузку. Итог по session_id читай через besales_platform_telegram_personal_proxy_stock_import_status; после обрыва автоматически новую ссылку не создавай.',
+            ]);
+        },
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_stock_import_status',
+        sideEffect: 'none',
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['session_id'],
+        resultPolicy,
+        schema: z.object({ ...workspace, session_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/telegram-proxy-stock/import-sessions/${input.session_id}`,
+        }),
+        enhanceResponse: (response) => {
+            const status = response;
+            const summary = status.summary;
+            return withInstructions({
+                sessionId: status.sessionId,
+                status: status.status,
+                expiresAt: status.expiresAt,
+                summary: summary && {
+                    total: summary.total, pending: summary.pending, accepted: summary.accepted,
+                    duplicates: summary.duplicates, invalid: summary.invalid, checkFailed: summary.checkFailed,
+                    rejected: summary.rejected, registered: summary.registered,
+                },
+            }, ['Ответ содержит только состояние и счётчики, без строк прокси. COMPLETED — обработка завершена, смотри счётчики; UNKNOWN не означает успех: повтори чтение позже. EXPIRED и CANCELLED — сессия закрыта.']);
+        },
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_stock_delete',
+        sideEffect: 'write',
+        reversible: false,
+        closedWorld: true,
+        defaultWorkspaceId: true,
+        requiredFields: ['proxy_id', 'explicit_confirmation'],
+        resultPolicy,
+        schema: z.object({
+            ...workspace,
+            proxy_id: uuidSchema,
+            explicit_confirmation: z.literal(true).describe('Явное согласие человека на удаление прокси из запаса.'),
+        }).strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/telegram-proxy-stock/proxies/${input.proxy_id}`,
+        }),
+        enhanceResponse: () => ({ deleted: true }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_stock_check',
+        sideEffect: 'write',
+        closedWorld: false,
+        defaultWorkspaceId: true,
+        requiredFields: ['proxy_id'],
+        resultPolicy,
+        schema: z.object({ ...workspace, proxy_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/telegram-proxy-stock/proxies/${input.proxy_id}/check`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_telegram_personal_proxy_stock_check_all',
+        sideEffect: 'write',
+        closedWorld: false,
+        defaultWorkspaceId: true,
+        requiredFields: [],
+        resultPolicy,
+        schema: z.object(workspace).strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/telegram-proxy-stock/proxies/check-all`,
+        }),
+    }),
+];
+//# sourceMappingURL=telegram-proxy-stock.js.map

package/dist/tools/definitions/telegram-proxy-stock.js.map

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