@pachca/cli 2026.10.2 → 2026.10.3

package/dist/commands/chats/create.js

@@ -4,10 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ChatsCreate extends BaseCommand {
     static description = "Новый чат";
-    static examples = [
-        "Создать канал и пригласить участников — Создай канал с участниками:\n  $ pachca chats create",
-        "Создать проектную беседу из шаблона — Создай беседу с участниками из тега:\n  $ pachca chats create"
-    ];
     static scope = "chats:create";
     static apiMethod = "POST";
     static apiPath = "/chats";
@@ -17,7 +13,7 @@ export default class ChatsCreate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'name': Flags.string({
-            description: "Название. Пустое название заменяется именем и фамилией владельца токена (у бота — его именем), а если их нет — никнеймом. (макс. 255 символов)",
+            description: "Название беседы или канала. Пустое название или название из одних пробелов отвечает `422` с кодом `blank`. (макс. 255 символов)",
         }),
         'member-ids': Flags.string({
             description: "Массив идентификаторов пользователей, которые станут участниками",
@@ -38,7 +34,7 @@ export default class ChatsCreate extends BaseCommand {
         const { args, flags } = await this.parse(ChatsCreate);
         this.parsedFlags = flags;
         const missingRequired = [
-            { flag: 'name', label: "Название. Пустое название заменяется именем и фамилией владельца токена (у бота — его именем), а если их нет — никнеймом.", type: 'string' },
+            { flag: 'name', label: "Название беседы или канала. Пустое название или название из одних пробелов отвечает `422` с кодом `blank`.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {
@@ -92,5 +88,6 @@ export default class ChatsCreate extends BaseCommand {
         const result = responseBody.data ?? responseBody;
         this.output(result);
         this.warnMetaList(responseBody.meta, "not_found_member_ids", "Не удалось добавить в чат", "Таких сотрудников нет в пространстве, либо они приостановлены или удалены.");
+        this.warnMetaList(responseBody.meta, "not_found_group_tag_ids", "Не удалось подключить теги", "Таких тегов нет в пространстве.");
     }
 }

package/dist/commands/chats/download-export.js

@@ -5,9 +5,6 @@ import { downloadFile } from '../../client.js';
 import { formatSize } from '../../utils.js';
 export default class ChatsDownloadExport extends BaseCommand {
     static description = "Скачать архив экспорта";
-    static examples = [
-        "Экспорт истории чата — Скачай файл экспорта:\n  $ pachca chats download-export"
-    ];
     static hiddenAliases = ["common:get-exports"];
     static scope = "chat_exports:read";
     static plan = "corporation";

package/dist/commands/chats/list-company.js

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ChatsListCompany extends BaseCommand {
     static description = "Список чатов пространства";
-    static examples = [
-        "Выгрузить все чаты пространства, включая закрытые — Получи беседы и каналы всего пространства, включая закрытые, где владелец токена не состоит:\n  $ pachca chats list-company"
-    ];
     static scope = "company_chats:read";
     static plan = "corporation";
     static apiMethod = "GET";

package/dist/commands/chats/list.js

@@ -3,11 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ChatsList extends BaseCommand {
     static description = "Список чатов";
-    static examples = [
-        "Найти активные чаты за период — Получи чаты с активностью после указанной даты:\n  $ pachca chats list",
-        "Найти и заархивировать неактивные чаты — Получи чаты без активности с нужной даты:\n  $ pachca chats list",
-        "Выгрузить все чаты пространства, включая закрытые — Если метод ответил `403` — у токена нет скоупа `company_chats:read`, либо владелец токена не владелец пространства, либо у пространства нет тарифа «Корпорация». Тогда возьми открытые чаты обычным списком:\n  $ pachca chats list"
-    ];
     static scope = "chats:read";
     static apiMethod = "GET";
     static apiPath = "/chats";
@@ -21,7 +16,7 @@ export default class ChatsList extends BaseCommand {
             default: "id",
         }),
         'order': Flags.string({
-            description: "Направление сортировки",
+            description: "Направление сортировки. Применяется вместе с `sort`, например `sort=last_message_at&order=desc`. Без `sort` чаты идут по убыванию `id` при любом `order`.",
             options: ["asc", "desc"],
             default: "desc",
         }),

package/dist/commands/chats/remove-avatar.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ChatsRemoveAvatar extends BaseCommand {
     static description = "Удаление аватара чата";
-    static examples = [
-        "Поставить или убрать аватар чата — Чтобы убрать аватар, удали его:\n  $ pachca chats remove-avatar"
-    ];
     static scope = "chats:update";
     static apiMethod = "DELETE";
     static apiPath = "/chats/{id}/avatar";

package/dist/commands/chats/request-export.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ChatsRequestExport extends BaseCommand {
     static description = "Экспорт сообщений";
-    static examples = [
-        "Экспорт истории чата — Запроси экспорт и возьми номер выгрузки из `data.id`:\n  $ pachca chats request-export"
-    ];
     static hiddenAliases = ["common:request-export"];
     static scope = "chat_exports:write";
     static plan = "corporation";

package/dist/commands/chats/unarchive.js

@@ -3,9 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ChatsUnarchive extends BaseCommand {
     static description = "Разархивация чата";
-    static examples = [
-        "Архивация и управление чатом — Разархивировать чат:\n  $ pachca chats unarchive"
-    ];
     static scope = "chats:archive";
     static apiMethod = "PUT";
     static apiPath = "/chats/{id}/unarchive";

package/dist/commands/chats/update-avatar.js

@@ -5,9 +5,6 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 export default class ChatsUpdateAvatar extends BaseCommand {
     static description = "Загрузка аватара чата";
-    static examples = [
-        "Поставить или убрать аватар чата — Загрузи аватар беседы или канала:\n  $ pachca chats update-avatar"
-    ];
     static scope = "chats:update";
     static apiMethod = "PUT";
     static apiPath = "/chats/{id}/avatar";

package/dist/commands/chats/update.js

@@ -3,9 +3,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ChatsUpdate extends BaseCommand {
     static description = "Редактирование чата";
-    static examples = [
-        "Переименовать или обновить чат — Обнови чат:\n  $ pachca chats update"
-    ];
     static scope = "chats:update";
     static apiMethod = "PUT";
     static apiPath = "/chats/{id}";

package/dist/commands/custom-properties/list.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class CustomPropertiesList extends BaseCommand {
     static description = "Список дополнительных полей";
-    static examples = [
-        "Получить кастомные поля профиля — Получи список дополнительных полей для сотрудников:\n  $ pachca custom-properties list"
-    ];
     static hiddenAliases = ["common:custom-properties"];
     static scope = "custom_properties:read";
     static apiMethod = "GET";

package/dist/commands/drafts/create.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class DraftsCreate extends BaseCommand {
     static description = "Новый черновик";
-    static examples = [
-        "Отправить сообщение позже или по расписанию — Создай отложенное сообщение: `schedule.start_date` — когда отправить, `schedule.repetition.interval` — как повторять (`once`, если один раз):\n  $ pachca drafts create"
-    ];
     static scope = "drafts:write";
     static apiMethod = "POST";
     static apiPath = "/drafts";
@@ -22,7 +19,7 @@ export default class DraftsCreate extends BaseCommand {
             description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника (pachca chats list | pachca users list)",
         }),
         'content': Flags.string({
-            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. До 40 000 байт в UTF-8, а у отложенного сообщения в пространстве с продвинутым шифрованием — до 27 000.",
+            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. До 40 000 байт в UTF-8.",
         }),
         'parent-message-id': Flags.integer({
             description: "Идентификатор сообщения, ответом на которое уйдёт черновик. Сообщение должно быть в том же чате.",

package/dist/commands/drafts/delete.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class DraftsDelete extends BaseCommand {
     static description = "Удаление черновика";
-    static examples = [
-        "Отправить сообщение позже или по расписанию — Чтобы отменить отправку — удали отложенное сообщение:\n  $ pachca drafts delete"
-    ];
     static scope = "drafts:write";
     static apiMethod = "DELETE";
     static apiPath = "/drafts/{id}";

package/dist/commands/drafts/update.js

@@ -16,7 +16,7 @@ export default class DraftsUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'content': Flags.string({
-            description: "Текст черновика. До 40 000 байт в UTF-8, а у отложенного сообщения в пространстве с продвинутым шифрованием — до 27 000.",
+            description: "Текст черновика. До 40 000 байт в UTF-8.",
         }),
         'parent-message-id': Flags.integer({
             description: "Идентификатор сообщения, ответом на которое уйдёт черновик. `null` снимает ответ.",

package/dist/commands/files/uploads.js

@@ -1,9 +1,6 @@
 import { BaseCommand } from '../../base-command.js';
 export default class FilesUploads extends BaseCommand {
     static description = "Получение подписи, ключа и других параметров";
-    static examples = [
-        "Изменить вложения сообщения — Если нужно добавить новый файл — загрузи его:\n  $ pachca files uploads"
-    ];
     static hiddenAliases = ["common:uploads"];
     static scope = "uploads:write";
     static apiMethod = "POST";

package/dist/commands/group-tags/create.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class GroupTagsCreate extends BaseCommand {
     static description = "Новый тег";
-    static examples = [
-        "Массовое создание сотрудников с тегами — Создай тег (если нужен):\n  $ pachca group-tags create"
-    ];
     static scope = "group_tags:write";
     static apiMethod = "POST";
     static apiPath = "/group_tags";

package/dist/commands/group-tags/list-users.js

@@ -3,9 +3,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class GroupTagsListUsers extends BaseCommand {
     static description = "Список сотрудников тега";
-    static examples = [
-        "Получить всех сотрудников тега/департамента — Получи всех участников тега:\n  $ pachca group-tags list-users"
-    ];
     static scope = "group_tags:read";
     static apiMethod = "GET";
     static apiPath = "/group_tags/{id}/users";

package/dist/commands/group-tags/list.js

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class GroupTagsList extends BaseCommand {
     static description = "Список тегов";
-    static examples = [
-        "Получить всех сотрудников тега/департамента — Найди тег по названию, возьми `id`:\n  $ pachca group-tags list"
-    ];
     static scope = "group_tags:read";
     static apiMethod = "GET";
     static apiPath = "/group_tags";

package/dist/commands/important-messages/create.js

@@ -0,0 +1,64 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as clack from '@clack/prompts';
+export default class ImportantMessagesCreate extends BaseCommand {
+    static description = "Добавление сообщения в важные";
+    static scope = "important_messages:write";
+    static apiMethod = "POST";
+    static apiPath = "/important_messages";
+    static requiredFlags = ["message-id"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'message-id': Flags.integer({
+            description: "Идентификатор сообщения (pachca messages list)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ImportantMessagesCreate);
+        this.parsedFlags = flags;
+        const missingRequired = [
+            { flag: 'message-id', label: "Идентификатор сообщения", type: 'integer' },
+        ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
+        if (missingRequired.length > 0) {
+            if (this.isInteractive()) {
+                for (const field of missingRequired) {
+                    const value = await clack.text({ message: field.label, validate: (v) => v.length === 0 ? 'Обязательное поле' : undefined });
+                    if (clack.isCancel(value)) {
+                        process.stderr.write('Отменено.\n');
+                        this.exit(0);
+                    }
+                    if (field.type === 'integer') {
+                        flags[field.flag] = Number.parseInt(value, 10);
+                    }
+                    else if (field.type === 'boolean') {
+                        flags[field.flag] = value === 'true';
+                    }
+                    else {
+                        flags[field.flag] = value;
+                    }
+                }
+            }
+            else {
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --message-id <integer>. pachca introspect important-messages create" });
+            }
+        }
+        const body = {
+            message_id: flags['message-id'],
+        };
+        // Clean undefined fields
+        for (const [k, v] of Object.entries(body)) {
+            if (v === undefined)
+                delete body[k];
+        }
+        const { data } = await this.apiRequest({
+            method: 'POST',
+            path: '/important_messages',
+            body,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/important-messages/delete.js

@@ -0,0 +1,42 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as clack from '@clack/prompts';
+export default class ImportantMessagesDelete extends BaseCommand {
+    static description = "Удаление сообщения из важных";
+    static scope = "important_messages:write";
+    static apiMethod = "DELETE";
+    static apiPath = "/important_messages/{id}";
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор сообщения",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            description: 'Пропустить подтверждение',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ImportantMessagesDelete);
+        this.parsedFlags = flags;
+        if (!flags.force) {
+            if (!this.isInteractive()) {
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca important-messages delete <id> --force" });
+            }
+            const confirm = await clack.confirm({ message: 'Вы уверены?' });
+            if (clack.isCancel(confirm) || !confirm) {
+                process.stderr.write('Отменено.\n');
+                this.exit(0);
+            }
+        }
+        const { data } = await this.apiRequest({
+            method: 'DELETE',
+            path: `/important_messages/${args.id}`,
+        });
+        this.success('Удалено');
+    }
+}

package/dist/commands/important-messages/list.js

@@ -0,0 +1,89 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ImportantMessagesList extends BaseCommand {
+    static description = "Список важных сообщений";
+    static scope = "important_messages:read";
+    static apiMethod = "GET";
+    static apiPath = "/important_messages";
+    static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        limit: Flags.integer({
+            description: 'Количество результатов на страницу',
+        }),
+        cursor: Flags.string({
+            description: 'Курсор для следующей страницы',
+        }),
+        all: Flags.boolean({
+            description: 'Загрузить все страницы автоматически',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ImportantMessagesList);
+        this.parsedFlags = flags;
+        if (flags.all) {
+            // Auto-pagination
+            const allData = [];
+            let nextCursor = undefined;
+            let pages = 0;
+            const seenCursors = new Set();
+            while (pages < 500) {
+                const query = {
+                    limit: flags.limit,
+                    cursor: nextCursor,
+                };
+                const response = await this.apiRequest({ method: 'GET', path: '/important_messages', query });
+                const body = response.data;
+                const items = body.data;
+                if (items)
+                    allData.push(...items);
+                const meta = body.meta;
+                const paginate = meta?.paginate;
+                nextCursor = paginate?.next_page;
+                pages++;
+                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                const hasNext = paginate?.has_next;
+                if (typeof hasNext === 'boolean') {
+                    if (!hasNext)
+                        break;
+                }
+                else if (!items || items.length === 0) {
+                    break;
+                }
+                if (process.stderr.isTTY) {
+                    const total = paginate?.total;
+                    const progress = total ? `${allData.length} / ${total}` : String(allData.length);
+                    process.stderr.write(`\r  Загружено: ${progress}...`);
+                }
+                if (!nextCursor)
+                    break;
+                if (seenCursors.has(nextCursor)) {
+                    process.stderr.write('\n⚠ Обнаружен цикл пагинации, остановка.\n');
+                    break;
+                }
+                seenCursors.add(nextCursor);
+            }
+            if (pages >= 500) {
+                process.stderr.write('\n⚠ Достигнут лимит 500 страниц.\n');
+            }
+            if (process.stderr.isTTY)
+                process.stderr.write('\n');
+            this.output(allData);
+            return;
+        }
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: '/important_messages',
+            query: {
+                limit: flags.limit,
+                cursor: flags.cursor,
+            },
+        });
+        const responseBody = (data ?? {});
+        const items = responseBody.data ?? responseBody;
+        this.output(items);
+    }
+}

package/dist/commands/members/add.js

@@ -4,11 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersAdd extends BaseCommand {
     static description = "Добавление участников";
-    static examples = [
-        "Подписаться на тред сообщения — Добавь бота в участники чата треда:\n  $ pachca members add",
-        "Создать канал и пригласить участников — Или добавь участников позже:\n  $ pachca members add",
-        "Онбординг нового сотрудника — Добавь в нужные каналы:\n  $ pachca members add"
-    ];
     static scope = "chat_members:write";
     static apiMethod = "POST";
     static apiPath = "/chats/{id}/members";

package/dist/commands/members/leave.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersLeave extends BaseCommand {
     static description = "Выход из чата";
-    static examples = [
-        "Архивация и управление чатом — Покинуть чат:\n  $ pachca members leave"
-    ];
     static scope = "chats:leave";
     static apiMethod = "DELETE";
     static apiPath = "/chats/{id}/leave";

package/dist/commands/members/list.js

@@ -3,10 +3,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class MembersList extends BaseCommand {
     static description = "Список участников чата";
-    static examples = [
-        "Упомянуть пользователя — Ищи среди участников целевого чата:\n  $ pachca members list",
-        "Упомянуть пользователя — Если пишешь в тред: также проверь участников родительского чата:\n  $ pachca members list"
-    ];
     static scope = "chat_members:read";
     static apiMethod = "GET";
     static apiPath = "/chats/{id}/members";

package/dist/commands/members/remove.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersRemove extends BaseCommand {
     static description = "Исключение участника";
-    static examples = [
-        "Архивация и управление чатом — Удалить участника:\n  $ pachca members remove"
-    ];
     static scope = "chat_members:write";
     static apiMethod = "DELETE";
     static apiPath = "/chats/{id}/members/{user_id}";

package/dist/commands/members/update.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersUpdate extends BaseCommand {
     static description = "Редактирование роли участника";
-    static examples = [
-        "Архивация и управление чатом — Изменить роль участника:\n  $ pachca members update"
-    ];
     static scope = "chat_members:write";
     static apiMethod = "PUT";
     static apiPath = "/chats/{id}/members/{user_id}";

package/dist/commands/messages/create.js

@@ -4,11 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MessagesCreate extends BaseCommand {
     static description = "Новое сообщение";
-    static examples = [
-        "Найти чат по имени и отправить сообщение — Отправь сообщение в найденный чат:\n  $ pachca messages create",
-        "Отправить сообщение в канал или беседу (если chat_id известен) — Отправь сообщение в чат:\n  $ pachca messages create",
-        "Отправить личное сообщение пользователю — Отправь личное сообщение:\n  $ pachca messages create"
-    ];
     static scope = "messages:create";
     static apiMethod = "POST";
     static apiPath = "/messages";
@@ -24,13 +19,13 @@ export default class MessagesCreate extends BaseCommand {
             description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо пользователя. У треда их два: `id` треда указывают с `entity_type: \"thread\"`, а его `chat_id` — с `discussion`, как у любого чата. (pachca chats list | pachca users list)",
         }),
         'content': Flags.string({
-            description: "Текст сообщения. Обязателен, если к сообщению не приложены файлы. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). `@all` упоминает всех участников чата, `@here` — тех, кто сейчас в сети, а `@` с названием тега без пробелов — сотрудников этого тега. Имя без `@` и упоминание внутри строчного кода или блока кода упоминанием не считаются. У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. В пространстве с продвинутым шифрованием — до 27 000 байт. Сообщение уходит под именем владельца токена, у бота — с бейджем «Бот».",
+            description: "Текст сообщения. Обязателен, если к сообщению не приложены файлы. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). `@all` упоминает всех участников чата, `@here` — тех, кто сейчас в сети, а `@` с названием тега без пробелов — сотрудников этого тега. Имя без `@` и упоминание внутри строчного кода или блока кода упоминанием не считаются. У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. Сообщение уходит под именем владельца токена, у бота — с бейджем «Бот».",
         }),
         'files': Flags.string({
             description: "Прикрепляемые файлы",
         }),
         'buttons': Flags.string({
-            description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке. Кнопки показываются под текстом и работают только у сообщений, отправленных токеном бота: нажатие на кнопку с `data` приходит событием `button_click` тому самому боту, а вместе с ним `trigger_id` — на открытие формы по нему есть 3 секунды, метод [Открытие представления](POST /views/open). Кнопка с `url` просто ведёт по ссылке и события не создаёт. Подробности — в разделе [Кнопки](https://dev.pachca.com/guides/buttons).",
+            description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке. Кнопки показываются под текстом. Кнопка с `url` ведёт по ссылке, кто бы ни отправил сообщение, и события не создаёт. Кнопка с `data` работает в сообщении бота: нажатие на неё приходит событием `button_click` тому боту, который отправил сообщение, а вместе с ним `trigger_id` — на открытие формы по нему есть 3 секунды, метод [Открытие представления](POST /views/open). Подробности — в разделе [Кнопки](https://dev.pachca.com/guides/buttons).",
         }),
         'parent-message-id': Flags.integer({
             description: "Идентификатор сообщения, на которое вы отвечаете с цитатой. Ответить можно на сообщение в любом чате, в том числе в треде: ответ отправляют в тот же чат или тред, где лежит это сообщение, иначе запрос вернёт ошибку `422`. Чтобы написать в тред под сообщением, укажите `entity_type: \"thread\"` и `id` треда в `entity_id`.",
@@ -42,7 +37,7 @@ export default class MessagesCreate extends BaseCommand {
             description: "Полное специальное имя отправителя для этого сообщения. Вместе с `display_avatar_url` бот подписывает сообщение чужим именем и аватаром, и только это сообщение. Бейдж «Бот» остаётся, а в профиле отправителя видно настоящего бота. Так показывают автора из другой системы, когда переносят в Пачку чужую переписку. С личным токеном поле недоступно, ответ `403`. Подробности — в разделе [Боты](https://dev.pachca.com/guides/bots/overview). (макс. 255 символов)",
         }),
         'skip-invite-mentions': Flags.boolean({
-            description: "Пропуск добавления упомянутых сотрудников в тред. В треде упоминание работает ещё и как приглашение: упомянутого сотрудника, которого в треде нет, Пачка туда добавляет, и он получает доступ к треду и родительскому сообщению. В беседе и канале упоминание никого не добавляет, и этот параметр там ничего не меняет.",
+            description: "Пропуск добавления упомянутых сотрудников в тред. В треде упоминание работает ещё и как приглашение: упомянутого сотрудника, которого в треде нет, Пачка туда добавляет, и он получает доступ к треду и родительскому сообщению. Если в пространстве включена настройка «Использовать сквозные треды» (так по умолчанию), упоминание добавляет и сотрудника не из родительского чата, а с `true` в этом поле упоминание никого не добавляет. Упоминание от гостя или мульти-гостя при этом добавляет только тех, с кем у автора есть общий чат. Если настройка выключена, упоминание добавляет только участников родительского чата, и это поле ничего не меняет. В беседе и канале упоминание никого не добавляет, и этот параметр там ничего не меняет.",
             allowNo: true,
         }),
         'link-preview': Flags.boolean({

package/dist/commands/messages/delete.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MessagesDelete extends BaseCommand {
     static description = "Удаление сообщения";
-    static examples = [
-        "Удалить сообщение — Удали сообщение:\n  $ pachca messages delete"
-    ];
     static scope = "messages:delete";
     static apiMethod = "DELETE";
     static apiPath = "/messages/{id}";

package/dist/commands/messages/get.js

@@ -3,11 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class MessagesGet extends BaseCommand {
     static description = "Информация о сообщении";
-    static examples = [
-        "Получить вложения из сообщения — Получи сообщение — в `files[]` каждый объект содержит `url`, `name`, `file_type`, `size`:\n  $ pachca messages get",
-        "Изменить вложения сообщения — Получи текущие вложения из `files[]`:\n  $ pachca messages get",
-        "Обработать входящий вебхук-событие — Для полной информации запроси сообщение — особенно для вложений (`files[]`):\n  $ pachca messages get"
-    ];
     static scope = "messages:read";
     static apiMethod = "GET";
     static apiPath = "/messages/{id}";

package/dist/commands/messages/list.js

@@ -4,10 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MessagesList extends BaseCommand {
     static description = "Список сообщений чата";
-    static examples = [
-        "Получить историю сообщений чата — Получи сообщения чата с пагинацией:\n  $ pachca messages list",
-        "Получить список активных тредов за период — Для каждого треда возьми `chat_id` и подтяни сообщения:\n  $ pachca messages list"
-    ];
     static scope = "messages:read";
     static apiMethod = "GET";
     static apiPath = "/messages";
@@ -30,7 +26,7 @@ export default class MessagesList extends BaseCommand {
             default: "id",
         }),
         'order': Flags.string({
-            description: "Направление сортировки",
+            description: "Направление сортировки. Применяется вместе с `sort`: сообщения от старых к новым дают `sort=id` и `order=asc`. Без `sort` сообщения идут от новых к старым при любом `order`.",
             options: ["asc", "desc"],
             default: "desc",
         }),

package/dist/commands/messages/pin.js

@@ -3,9 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class MessagesPin extends BaseCommand {
     static description = "Закрепление сообщения";
-    static examples = [
-        "Закрепить/открепить сообщение — Закрепить сообщение:\n  $ pachca messages pin"
-    ];
     static scope = "pins:write";
     static apiMethod = "POST";
     static apiPath = "/messages/{id}/pin";

package/dist/commands/messages/unfurl.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MessagesUnfurl extends BaseCommand {
     static description = "Unfurl (разворачивание ссылок)";
-    static examples = [
-        "Разворачивание ссылок (unfurling) — Отправь превью-данные:\n  $ pachca messages unfurl"
-    ];
     static hiddenAliases = ["link-previews:add"];
     static scope = "link_previews:write";
     static apiMethod = "POST";

package/dist/commands/messages/unpin.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MessagesUnpin extends BaseCommand {
     static description = "Открепление сообщения";
-    static examples = [
-        "Закрепить/открепить сообщение — Открепить сообщение:\n  $ pachca messages unpin"
-    ];
     static scope = "pins:write";
     static apiMethod = "DELETE";
     static apiPath = "/messages/{id}/pin";