@pachca/cli 2026.10.2 → 2026.10.4

package/dist/commands/members/add.js

@@ -4,18 +4,13 @@ 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";
     static requiredFlags = ["member-ids"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор чата (беседа, канал или чат треда)",
+            description: "Идентификатор чата (беседа, канал или чат треда). В тред метод добавляет всех обычными участниками и без уведомления, поэтому упомяните добавленных в сообщении треда. Сотрудников не из родительского чата он добавляет туда при любой настройке «Использовать сквозные треды».",
             required: true,
         }),
     };

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";
@@ -44,6 +40,7 @@ export default class MembersList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     role: flags['role'],
@@ -59,7 +56,7 @@ export default class MembersList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -69,7 +66,8 @@ export default class MembersList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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`). Ник берут из ответа метода, а `user_id` — из данных: ник, составленный из имени, никого не упоминает. `@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({
@@ -59,7 +54,9 @@ export default class MessagesCreate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const missingRequired = [
             { flag: 'entity-id', label: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо пользователя. У треда их два: `id` треда указывают с `entity_type: \"thread\"`, а его `chat_id` — с `discussion`, как у любого чата.", type: 'integer' },

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",
         }),
@@ -83,6 +79,7 @@ export default class MessagesList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'chat_id': flags['chat-id'],
@@ -100,7 +97,7 @@ export default class MessagesList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -110,7 +107,8 @@ export default class MessagesList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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";

package/dist/commands/messages/update.js

@@ -3,11 +3,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class MessagesUpdate extends BaseCommand {
     static description = "Редактирование сообщения";
-    static examples = [
-        "Отредактировать сообщение — Обнови сообщение:\n  $ pachca messages update",
-        "Изменить вложения сообщения — Обнови сообщение с новым массивом `files`:\n  $ pachca messages update",
-        "Обработать нажатие кнопки (callback) — Опционально: обнови исходное сообщение:\n  $ pachca messages update"
-    ];
     static scope = "messages:update";
     static apiMethod = "PUT";
     static apiPath = "/messages/{id}";
@@ -21,10 +16,10 @@ export default class MessagesUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'content': Flags.string({
-            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. В пространстве с продвинутым шифрованием — до 27 000 байт.",
+            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). Ник берут из ответа метода, а `user_id` — из данных: ник, составленный из имени, никого не упоминает. У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов.",
         }),
         'files': Flags.string({
-            description: "Прикрепляемые файлы. Переданный набор заменяет прежний: чтобы оставить уже приложенный файл, передайте его снова с тем же `key`.",
+            description: "Прикрепляемые файлы. Переданный набор заменяет прежний: чтобы оставить уже приложенный файл, передайте его снова с тем же `key`. Такой файл остаётся прежним вложением с тем же `id` и названием, а его поля из запроса не применяются. Чтобы показать файл под другим названием, загрузите его заново.",
         }),
         'buttons': Flags.string({
             description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке. Для удаления кнопок пришлите пустой массив.",
@@ -45,7 +40,9 @@ export default class MessagesUpdate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const body = { message: {
                 content: flags['content'],

package/dist/commands/oauth/token-info.js

@@ -1,9 +1,6 @@
 import { BaseCommand } from '../../base-command.js';
 export default class OauthTokenInfo extends BaseCommand {
     static description = "Информация о токене";
-    static examples = [
-        "Проверить свой токен — Получи информацию о токене: скоупы, дату создания, срок жизни:\n  $ pachca oauth token-info"
-    ];
     static hiddenAliases = ["profile:get-info"];
     static apiMethod = "GET";
     static apiPath = "/oauth/token/info";

package/dist/commands/profile/delete-avatar.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ProfileDeleteAvatar extends BaseCommand {
     static description = "Удаление своего аватара";
-    static examples = [
-        "Удалить аватар профиля — Удали аватар:\n  $ pachca profile delete-avatar"
-    ];
     static scope = "profile_avatar:write";
     static apiMethod = "DELETE";
     static apiPath = "/profile/avatar";

package/dist/commands/profile/delete-status.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ProfileDeleteStatus extends BaseCommand {
     static description = "Удаление своего статуса";
-    static examples = [
-        "Сбросить статус — Удали статус:\n  $ pachca profile delete-status"
-    ];
     static scope = "profile_status:write";
     static apiMethod = "DELETE";
     static apiPath = "/profile/status";

package/dist/commands/profile/get.js

@@ -1,10 +1,6 @@
 import { BaseCommand } from '../../base-command.js';
 export default class ProfileGet extends BaseCommand {
     static description = "Свой профиль";
-    static examples = [
-        "Получить свой профиль — Получи информацию о текущем пользователе:\n  $ pachca profile get",
-        "Получить кастомные поля профиля — Получи профиль — в `custom_properties` содержатся значения полей:\n  $ pachca profile get"
-    ];
     static scope = "profile:read";
     static apiMethod = "GET";
     static apiPath = "/profile";

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

@@ -5,9 +5,6 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 export default class ProfileUpdateAvatar extends BaseCommand {
     static description = "Загрузка своего аватара";
-    static examples = [
-        "Загрузить аватар профиля — Загрузи аватар из файла:\n  $ pachca profile update-avatar"
-    ];
     static scope = "profile_avatar:write";
     static apiMethod = "PUT";
     static apiPath = "/profile/avatar";

package/dist/commands/profile/update-status.js

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ProfileUpdateStatus extends BaseCommand {
     static description = "Новый свой статус";
-    static examples = [
-        "Установить статус — Установи статус:\n  $ pachca profile update-status"
-    ];
     static scope = "profile_status:write";
     static apiMethod = "PUT";
     static apiPath = "/profile/status";
@@ -14,7 +11,7 @@ export default class ProfileUpdateStatus extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'emoji': Flags.string({
-            description: "Emoji символ статуса. Обязателен, если статуса ещё нет.",
+            description: "Emoji символ статуса. Обязателен, если статуса ещё нет. Эмодзи в текстовой форме (без U+FE0F или с U+FE0E) сохраняется и возвращается с U+FE0F. Пустое значение отвечает `400` с кодом `blank`, несколько эмодзи — с кодом `invalid`, текст вместо эмодзи или рядом с ним — с кодом `wrong_emoji`.",
         }),
         'title': Flags.string({
             description: "Текст статуса. Обязателен, если статуса ещё нет. (макс. 50 символов)",

package/dist/commands/reactions/add.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ReactionsAdd extends BaseCommand {
     static description = "Добавление реакции";
-    static examples = [
-        "Добавить реакцию на сообщение — Добавь реакцию:\n  $ pachca reactions add"
-    ];
     static scope = "reactions:write";
     static apiMethod = "POST";
     static apiPath = "/messages/{id}/reactions";
@@ -21,17 +18,17 @@ export default class ReactionsAdd extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'code': Flags.string({
-            description: "Emoji символ реакции. Именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.",
+            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение: оно сохраняется как передано.",
         }),
         'name': Flags.string({
-            description: "Текстовое имя эмодзи (используется для кастомных эмодзи)",
+            description: "Имя кастомного эмодзи пространства. С ним реакцией ставится этот эмодзи, а если его в пространстве нет, ответ `404`.",
         }),
     };
     async run() {
         const { args, flags } = await this.parse(ReactionsAdd);
         this.parsedFlags = flags;
         const missingRequired = [
-            { flag: 'code', label: "Emoji символ реакции. Именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.", type: 'string' },
+            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение: оно сохраняется как передано.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {

package/dist/commands/reactions/list.js

@@ -35,6 +35,7 @@ export default class ReactionsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     limit: flags.limit,
@@ -49,7 +50,7 @@ export default class ReactionsList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -59,7 +60,8 @@ export default class ReactionsList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/reactions/remove.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ReactionsRemove extends BaseCommand {
     static description = "Удаление реакции";
-    static examples = [
-        "Добавить реакцию на сообщение — Убрать реакцию:\n  $ pachca reactions remove"
-    ];
     static scope = "reactions:write";
     static apiMethod = "DELETE";
     static apiPath = "/messages/{id}/reactions";
@@ -20,10 +17,10 @@ export default class ReactionsRemove extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'code': Flags.string({
-            description: "Emoji символ реакции. Именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.",
+            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.",
         }),
         'name': Flags.string({
-            description: "Текстовое имя эмодзи (используется для кастомных эмодзи)",
+            description: "Имя реакции, как в её поле `name`. С ним реакция ищется по имени, так снимается и кастомный эмодзи пространства.",
         }),
         force: Flags.boolean({
             description: 'Пропустить подтверждение',
@@ -34,7 +31,7 @@ export default class ReactionsRemove extends BaseCommand {
         const { args, flags } = await this.parse(ReactionsRemove);
         this.parsedFlags = flags;
         const missingRequired = [
-            { flag: 'code', label: "Emoji символ реакции. Именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.", type: 'string' },
+            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {

package/dist/commands/read-member/list-readers.js

@@ -3,9 +3,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ReadMemberListReaders extends BaseCommand {
     static description = "Список прочитавших сообщение";
-    static examples = [
-        "Проверить, кто прочитал сообщение — Получи массив `user_id` прочитавших:\n  $ pachca read-member list-readers"
-    ];
     static scope = "messages:read";
     static apiMethod = "GET";
     static apiPath = "/messages/{id}/read_member_ids";
@@ -37,6 +34,7 @@ export default class ReadMemberListReaders extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     limit: flags.limit,
@@ -51,7 +49,7 @@ export default class ReadMemberListReaders extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -61,7 +59,8 @@ export default class ReadMemberListReaders extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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

@@ -3,11 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class SearchListChats extends BaseCommand {
     static description = "Поиск чатов";
-    static examples = [
-        "Найти чат по имени и отправить сообщение — Найди чат по названию через поиск:\n  $ pachca search list-chats",
-        "Отправить сообщение позже или по расписанию — Найди чат, в который нужно написать:\n  $ pachca search list-chats",
-        "Найти чат по названию — Полнотекстовый поиск по чатам:\n  $ pachca search list-chats"
-    ];
     static scope = "search:chats";
     static apiMethod = "GET";
     static apiPath = "/search/chats";
@@ -60,6 +55,7 @@ export default class SearchListChats extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -81,7 +77,7 @@ export default class SearchListChats extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -91,7 +87,8 @@ export default class SearchListChats extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class SearchListMessages extends BaseCommand {
     static description = "Поиск сообщений";
-    static examples = [
-        "Найти сообщение по тексту — Полнотекстовый поиск по сообщениям:\n  $ pachca search list-messages"
-    ];
     static scope = "search:messages";
     static apiMethod = "GET";
     static apiPath = "/search/messages";
@@ -61,6 +58,7 @@ export default class SearchListMessages extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -83,7 +81,7 @@ export default class SearchListMessages extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -93,7 +91,8 @@ export default class SearchListMessages extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }