@pachca/cli 2026.10.3 → 2026.11.0

package/dist/commands/bots/update.js

@@ -1,6 +1,7 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
+import { nullableString } from '../../lib/flags.js';
 export default class BotsUpdate extends BaseCommand {
     static description = "Редактирование бота";
     static scope = "bots:write";
@@ -19,10 +20,10 @@ export default class BotsUpdate extends BaseCommand {
             description: "Имя бота (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Никнейм бота. Должен заканчиваться на `_bot`. (макс. 255 символов)",
+            description: "Никнейм бота: латинские буквы, цифры и `_`, в конце `_bot`, свободный в пространстве. Ник не по формату отвечает `400` на поле `bot.nickname` с кодом `invalid`, а занятый ник — с кодом `taken`. (макс. 255 символов)",
         }),
         'outgoing-url': Flags.string({
-            description: "URL исходящего вебхука",
+            description: "URL исходящего вебхука (макс. 255 символов)",
         }),
         'events': Flags.string({
             description: "События, на которые подписан бот. Список заменяется целиком.",
@@ -31,7 +32,7 @@ export default class BotsUpdate extends BaseCommand {
             description: "Условие срабатывания исходящего вебхука",
         }),
         'commands': Flags.string({
-            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Событие о сообщении приходит боту, когда первое слово текста совпадает с одной из команд целиком, с учётом регистра. Команду можно задать и без слэша в начале. Суммарная длина команд вместе с разделителями `, ` (запятая и пробел) не должна превышать 255 символов.",
         }),
         'scopes': Flags.string({
             description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию. Боту доступны не все скоупы: часть из них разрешена только пользовательским ролям, и попытка назначить такой скоуп возвращает `400`. Служебные значения `bot` и `all` назначать нельзя.",
@@ -43,14 +44,14 @@ export default class BotsUpdate extends BaseCommand {
             description: "Шаблонизатор для обработки шаблона входящего вебхука",
         }),
         'challenge-key': Flags.string({
-            description: "Название поля проверки для верификации входящего вебхука",
+            description: "Название поля проверки для верификации входящего вебхука (макс. 255 символов)",
         }),
         'link-preview-enabled': Flags.boolean({
             description: "Показывать превью ссылок в сообщениях входящего вебхука",
             allowNo: true,
         }),
         'ignore-self-messages': Flags.boolean({
-            description: "Не присылать боту события о его собственных сообщениях и реакциях",
+            description: "Не присылать боту события о сообщениях, которые он отправил сам, и о реакциях на эти сообщения, кто бы их ни поставил или снял. Нажатия кнопок приходят всегда.",
             allowNo: true,
         }),
         'events-history-enabled': Flags.boolean({
@@ -67,8 +68,8 @@ export default class BotsUpdate extends BaseCommand {
             description: "Ограничивает бота одной беседой или каналом: `true` — бота можно добавить только в один такой чат, `false` — в несколько. Личные чаты и треды в ограничение не входят.",
             allowNo: true,
         }),
-        'kind': Flags.string({
-            description: "Источник входящего вебхука. Если у бота входящего вебхука не было, он включается.",
+        'kind': nullableString({
+            description: "Источник входящего вебхука. Если у бота входящего вебхука не было, он включается. `null` удаляет входящий вебхук: адрес перестаёт работать, шаблон и настройки входящего вебхука сбрасываются, а при следующем включении бот получает новый адрес. Чтобы передать null, укажите `--kind null`.",
         }),
         'unfurl-domains': Flags.string({
             description: "Домены, ссылки на которые бот разворачивает, не больше 5. Работают вместе с событием `message_link_shared`. Список заменяется целиком.",
@@ -90,6 +91,12 @@ export default class BotsUpdate extends BaseCommand {
         if (flags['nickname'] && String(flags['nickname']).length > 255) {
             validationErrors.push({ message: `--nickname: максимум 255 символов (передано: ${String(flags['nickname']).length})`, flag: 'nickname' });
         }
+        if (flags['outgoing-url'] && String(flags['outgoing-url']).length > 255) {
+            validationErrors.push({ message: `--outgoing-url: максимум 255 символов (передано: ${String(flags['outgoing-url']).length})`, flag: 'outgoing-url' });
+        }
+        if (flags['challenge-key'] && String(flags['challenge-key']).length > 255) {
+            validationErrors.push({ message: `--challenge-key: максимум 255 символов (передано: ${String(flags['challenge-key']).length})`, flag: 'challenge-key' });
+        }
         if (validationErrors.length > 0) {
             this.validationError(validationErrors);
         }

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

@@ -35,6 +35,7 @@ export default class ChatsListCompany extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     activity: flags['activity'],
@@ -50,7 +51,7 @@ export default class ChatsListCompany 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)
@@ -60,7 +61,8 @@ export default class ChatsListCompany 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/chats/list.js

@@ -60,6 +60,7 @@ export default class ChatsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     sort: flags['sort'],
@@ -81,7 +82,7 @@ export default class ChatsList 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 +92,8 @@ export default class ChatsList 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/chats/update.js

@@ -16,7 +16,7 @@ export default class ChatsUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'name': Flags.string({
-            description: "Название (макс. 255 символов)",
+            description: "Название беседы или канала. Пустое название или название из одних пробелов отвечает `400` с кодом `blank`. (макс. 255 символов)",
         }),
         'public': Flags.boolean({
             description: "Открытый доступ",

package/dist/commands/doctor.js

@@ -2,7 +2,7 @@ import * as fs from 'node:fs';
 import * as process from 'node:process';
 import semver from 'semver';
 import { BaseCommand } from '../base-command.js';
-import { getActiveProfile, getProfile, getConfigFilePath, getConfigFilePermissions, getAuthMethod, getSecretStorage, isExpiring, isRefreshable, listProfiles, } from '../profiles.js';
+import { getProfile, getConfigFilePath, getConfigFilePermissions, getAuthMethod, getSecretStorage, isExpiring, isRefreshable, listProfiles, profileFlag, tokenSource, } from '../profiles.js';
 import { isSecretStoreAvailable } from '../secret-store.js';
 import { getBaseUrl } from '../client.js';
 export default class Doctor extends BaseCommand {
@@ -20,7 +20,6 @@ export default class Doctor extends BaseCommand {
         const format = this.getOutputFormat();
         const checks = [];
         let networkOk = false;
-        let profileOk = false;
         // 1. Node.js version
         const nodeVersion = process.version.replace('v', '');
         const nodeMajor = Number.parseInt(nodeVersion.split('.')[0], 10);
@@ -55,13 +54,19 @@ export default class Doctor extends BaseCommand {
             checks.push({ name: 'network', status: 'error', host });
             this.printCheck('error', `Сеть           ${host} недоступен (таймаут 5s)`, format);
         }
-        // 3. Config file. File permissions only matter for profiles that keep the
-        // secret there — for a keyring profile the file holds no token at all, and
-        // reporting its mode as a security state would be misleading.
+        // The token comes from the same place as for any other command, in the same
+        // order: --token, --profile, PACHCA_TOKEN, PACHCA_PROFILE, the active profile.
+        // In CI the token usually comes from PACHCA_TOKEN alone, with no config at all.
+        const source = tokenSource({ token: flags.token, profile: flags.profile });
+        const sourceLabel = source.kind === 'flag' ? '--token' : source.kind === 'env' ? 'PACHCA_TOKEN' : undefined;
+        const profileName = source.kind === 'profile' ? source.profileName : undefined;
+        const storedProfile = profileName ? listProfiles()[profileName] : undefined;
+        const relogin = `pachca auth login${profileFlag(profileName)}`;
+        // 3. Config file. File permissions only matter when a secret lives there: a
+        // keyring profile keeps no token in the file, and reporting its mode as a
+        // security state would be misleading.
         const configPath = getConfigFilePath();
-        const activeName = getActiveProfile();
-        const activeProfile = activeName ? listProfiles()[activeName] : undefined;
-        const storage = activeProfile ? getSecretStorage(activeProfile) : 'file';
+        const storage = storedProfile ? getSecretStorage(storedProfile) : 'file';
         if (fs.existsSync(configPath)) {
             const permissions = getConfigFilePermissions();
             if (storage === 'file' && permissions && Number.parseInt(permissions, 8) > 0o600) {
@@ -73,16 +78,20 @@ export default class Doctor extends BaseCommand {
                 this.printCheck('ok', `Конфиг         ${configPath} (права: ${permissions || '600'})`, format);
             }
         }
+        else if (sourceLabel) {
+            checks.push({ name: 'config', status: 'skipped', path: configPath, reason: `токен из ${sourceLabel}` });
+            this.printCheck('skipped', `Конфиг         не нужен: токен из ${sourceLabel}`, format);
+        }
         else {
             checks.push({ name: 'config', status: 'error', path: configPath });
-            this.printCheck('error', `Конфиг         файл не найден (запустите pachca auth login)`, format);
+            this.printCheck('error', `Конфиг         ${configPath} не найден (запустите pachca auth login или задайте PACHCA_TOKEN)`, format);
         }
         // 3a. Secret store. A locked keyring is the most likely failure of the new
         // login, and without this check it surfaces below as "token is invalid".
         let secretReadable = true;
-        if (activeProfile && storage === 'keyring') {
+        if (storedProfile && storage === 'keyring') {
             const storeUp = isSecretStoreAvailable();
-            secretReadable = storeUp && !!getProfile(activeName)?.token;
+            secretReadable = storeUp && !!getProfile(profileName)?.token;
             if (secretReadable) {
                 checks.push({ name: 'secret_store', status: 'ok', storage });
                 this.printCheck('ok', `Хранилище      хранилище ключей ОС, секрет читается`, format);
@@ -90,63 +99,81 @@ export default class Doctor extends BaseCommand {
             else {
                 checks.push({ name: 'secret_store', status: 'error', storage, available: storeUp });
                 this.printCheck('error', storeUp
-                    ? `Хранилище      секрет профиля не найден — войдите заново: pachca auth login`
+                    ? `Хранилище      секрет профиля не найден — войдите заново: ${relogin}`
                     : `Хранилище      хранилище ключей ОС недоступно — разблокируйте связку ключей`, format);
             }
         }
-        else if (activeProfile) {
+        else if (storedProfile) {
             checks.push({ name: 'secret_store', status: 'ok', storage: 'file' });
             this.printCheck('ok', `Хранилище      файл конфигурации`, format);
         }
         // 4. Profile
-        const profileName = getActiveProfile();
-        if (profileName) {
-            const profile = getProfile(profileName);
+        let token;
+        let profile;
+        if (sourceLabel) {
+            token = source.kind === 'flag' ? flags.token : process.env.PACHCA_TOKEN;
+            checks.push({ name: 'profile', status: 'skipped', source: sourceLabel, reason: `токен из ${sourceLabel}` });
+            this.printCheck('skipped', `Профиль        не используется: токен из ${sourceLabel}`, format);
+        }
+        else if (source.kind === 'profile') {
+            profile = getProfile(source.profileName);
             if (profile) {
+                token = profile.token;
                 const method = getAuthMethod(profile);
                 const expiry = method === 'oauth' && profile.expires_at
                     ? `, истекает ${new Date(profile.expires_at).toLocaleString('ru-RU')}`
                     : method === 'token'
                         ? ', бессрочный'
                         : '';
+                const via = source.via === 'active_profile' ? '' : ` из ${source.via}`;
                 checks.push({
                     name: 'profile',
                     status: 'ok',
-                    profile: profileName,
+                    profile: source.profileName,
+                    source: source.via,
                     type: profile.type,
                     user: profile.user,
                     auth: method,
                     storage,
                 });
-                this.printCheck('ok', `Профиль        ${profileName} (${profile.type}: ${profile.user}) — ${method === 'oauth' ? 'вход через браузер' : 'готовый токен'}${expiry}`, format);
-                profileOk = true;
+                this.printCheck('ok', `Профиль        ${source.profileName}${via} (${profile.type}: ${profile.user}) — ${method === 'oauth' ? 'вход через браузер' : 'готовый токен'}${expiry}`, format);
             }
             else {
-                checks.push({ name: 'profile', status: 'error', profile: profileName });
-                this.printCheck('error', `Профиль        ${profileName} — профиль не найден в конфиге`, format);
+                checks.push({ name: 'profile', status: 'error', profile: source.profileName, source: source.via });
+                this.printCheck('error', `Профиль        ${source.profileName} — профиль не найден в конфиге (список: pachca auth list)`, format);
             }
         }
         else {
             checks.push({ name: 'profile', status: 'error' });
-            this.printCheck('error', `Профиль        не настроен (запустите pachca auth login)`, format);
+            this.printCheck('error', `Профиль        не настроен (запустите pachca auth login или задайте PACHCA_TOKEN)`, format);
         }
-        // 5. Token (skip if no network, no profile, or the secret is unreadable —
+        // 5. Token (skip if no network, no token, or the secret is unreadable —
         // asking the server with an empty Bearer would come back 401 and get
         // reported as an invalid token, sending the user to log in for nothing)
-        if (!networkOk || !profileOk || !secretReadable) {
-            const reason = !networkOk ? 'нет сети' : !profileOk ? 'нет профиля' : 'секрет недоступен';
+        if (!networkOk || !token || !secretReadable) {
+            const reason = !networkOk
+                ? 'нет сети'
+                : !secretReadable
+                    ? 'секрет недоступен'
+                    : !sourceLabel && !profile
+                        ? 'нет профиля'
+                        : 'нет токена';
             checks.push({ name: 'token', status: 'skipped', reason });
             this.printCheck('skipped', `Токен          пропущено (${reason})`, format);
         }
         else {
-            const profile = getProfile(profileName);
             // An expired token that still has its refresh token is not a broken login:
             // the next command renews it on the init hook. Reporting it as invalid sent
             // people to log in again for nothing.
-            const willRenew = isRefreshable(profile) && isExpiring(profile);
+            const willRenew = !!profile && isRefreshable(profile) && isExpiring(profile);
+            const fix = sourceLabel
+                ? `проверьте ${sourceLabel}`
+                : profile && getAuthMethod(profile) === 'oauth'
+                    ? `войдите заново: ${relogin}`
+                    : `сохраните новый: ${relogin} --token <токен>`;
             try {
                 const response = await fetch(`${baseUrl}/oauth/token/info`, {
-                    headers: { Authorization: `Bearer ${profile.token}` },
+                    headers: { Authorization: `Bearer ${token}` },
                 });
                 if (response.ok) {
                     const body = (await response.json());
@@ -160,7 +187,7 @@ export default class Doctor extends BaseCommand {
                 }
                 else {
                     checks.push({ name: 'token', status: 'error', http_status: response.status });
-                    this.printCheck('error', `Токен          недействителен (${response.status}) — обновите: pachca auth login`, format);
+                    this.printCheck('error', `Токен          недействителен (${response.status}) — ${fix}`, format);
                 }
             }
             catch {
@@ -201,17 +228,15 @@ export default class Doctor extends BaseCommand {
                 this.printCheck('ok', `CLI            v${currentVersion}`, format);
             }
         }
-        // Output JSON if requested
+        // A failed check exits with 1 in every format, so a CI step can rely on the
+        // exit code alone; `status` of each check says which one failed.
+        const hasErrors = checks.some((c) => c.status === 'error');
         if (format === 'json') {
             this.output({ checks });
-            return;
         }
-        // Summary
-        const hasErrors = checks.some((c) => c.status === 'error');
-        if (!hasErrors) {
+        else if (!hasErrors) {
             process.stderr.write('\nВсё в порядке.\n');
         }
-        // Exit with error if any check failed
         if (hasErrors) {
             this.exit(1);
         }

package/dist/commands/drafts/create.js

@@ -2,6 +2,7 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
+import { nullableInteger } from '../../lib/flags.js';
 export default class DraftsCreate extends BaseCommand {
     static description = "Новый черновик";
     static scope = "drafts:write";
@@ -19,9 +20,9 @@ export default class DraftsCreate extends BaseCommand {
             description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника (pachca chats list | pachca users list)",
         }),
         'content': Flags.string({
-            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. До 40 000 байт в UTF-8.",
+            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. Поддерживает упоминания, как текст в методе [Новое сообщение](POST /messages). `<@user_id>` остаётся в тексте черновика как передан, а при отправке становится `@nickname`. До 40 000 байт в UTF-8.",
         }),
-        'parent-message-id': Flags.integer({
+        'parent-message-id': nullableInteger({
             description: "Идентификатор сообщения, ответом на которое уйдёт черновик. Сообщение должно быть в том же чате.",
         }),
         'files': Flags.string({
@@ -40,7 +41,9 @@ export default class DraftsCreate 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-type', label: "Куда пишется черновик: в беседу или канал, в тред либо в личную переписку с сотрудником", type: 'string' },

package/dist/commands/drafts/list.js

@@ -42,6 +42,7 @@ export default class DraftsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     type: flags['type'],
@@ -59,7 +60,7 @@ export default class DraftsList 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 +70,8 @@ export default class DraftsList 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/drafts/update.js

@@ -1,6 +1,7 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
+import { nullableInteger } from '../../lib/flags.js';
 export default class DraftsUpdate extends BaseCommand {
     static description = "Редактирование черновика";
     static scope = "drafts:write";
@@ -16,10 +17,10 @@ export default class DraftsUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'content': Flags.string({
-            description: "Текст черновика. До 40 000 байт в UTF-8.",
+            description: "Текст черновика. Поддерживает упоминания, как текст в методе [Новое сообщение](POST /messages). `<@user_id>` остаётся в тексте черновика как передан, а при отправке становится `@nickname`. До 40 000 байт в UTF-8.",
         }),
-        'parent-message-id': Flags.integer({
-            description: "Идентификатор сообщения, ответом на которое уйдёт черновик. `null` снимает ответ.",
+        'parent-message-id': nullableInteger({
+            description: "Идентификатор сообщения, ответом на которое уйдёт черновик. `null` снимает ответ. Чтобы передать null, укажите `--parent-message-id null`.",
         }),
         'files': Flags.string({
             description: "Прикрепляемые файлы, не больше десяти. Переданный массив заменяет прежний состав: пустой снимает все вложения, а чтобы сохранить уже прикреплённый файл, передайте его с `id`. Без этого поля вложения остаются как были.",
@@ -37,7 +38,9 @@ export default class DraftsUpdate 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 = { draft: {
                 content: flags['content'],

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

@@ -35,6 +35,7 @@ export default class GroupTagsListUsers 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 GroupTagsListUsers 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 GroupTagsListUsers 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/group-tags/list.js

@@ -33,6 +33,7 @@ export default class GroupTagsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'names[]': flags['names']?.split(','),
@@ -48,7 +49,7 @@ export default class GroupTagsList 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)
@@ -58,7 +59,8 @@ export default class GroupTagsList 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/important-messages/list.js

@@ -30,6 +30,7 @@ export default class ImportantMessagesList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     limit: flags.limit,
@@ -44,7 +45,7 @@ export default class ImportantMessagesList 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)
@@ -54,7 +55,8 @@ export default class ImportantMessagesList 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/add.js

@@ -10,7 +10,7 @@ export default class MembersAdd extends BaseCommand {
     static requiredFlags = ["member-ids"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор чата (беседа, канал или чат треда)",
+            description: "Идентификатор чата (беседа, канал или чат треда). В тред метод добавляет всех обычными участниками и без уведомления, поэтому упомяните добавленных в сообщении треда. Сотрудников не из родительского чата он добавляет туда при любой настройке «Использовать сквозные треды».",
             required: true,
         }),
     };

package/dist/commands/members/list.js

@@ -40,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'],
@@ -55,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)
@@ -65,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/messages/create.js

@@ -19,7 +19,7 @@ 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 символов. Сообщение уходит под именем владельца токена, у бота — с бейджем «Бот».",
+            description: "Текст сообщения. Обязателен, если к сообщению не приложены файлы. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). Ник берут из ответа метода, а `user_id` — из данных: ник, составленный из имени, никого не упоминает. `@all` упоминает всех участников чата, `@here` — тех, кто сейчас в сети, а `@` с названием тега без пробелов — сотрудников этого тега. Имя без `@` и упоминание внутри строчного кода или блока кода упоминанием не считаются. У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. Сообщение уходит под именем владельца токена, у бота — с бейджем «Бот».",
         }),
         'files': Flags.string({
             description: "Прикрепляемые файлы",
@@ -31,13 +31,13 @@ export default class MessagesCreate extends BaseCommand {
             description: "Идентификатор сообщения, на которое вы отвечаете с цитатой. Ответить можно на сообщение в любом чате, в том числе в треде: ответ отправляют в тот же чат или тред, где лежит это сообщение, иначе запрос вернёт ошибку `422`. Чтобы написать в тред под сообщением, укажите `entity_type: \"thread\"` и `id` треда в `entity_id`.",
         }),
         'display-avatar-url': Flags.string({
-            description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. (макс. 255 символов)",
+            description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. До 255 байт в UTF-8. (макс. 255 символов)",
         }),
         'display-name': Flags.string({
-            description: "Полное специальное имя отправителя для этого сообщения. Вместе с `display_avatar_url` бот подписывает сообщение чужим именем и аватаром, и только это сообщение. Бейдж «Бот» остаётся, а в профиле отправителя видно настоящего бота. Так показывают автора из другой системы, когда переносят в Пачку чужую переписку. С личным токеном поле недоступно, ответ `403`. Подробности — в разделе [Боты](https://dev.pachca.com/guides/bots/overview). (макс. 255 символов)",
+            description: "Полное специальное имя отправителя для этого сообщения. Вместе с `display_avatar_url` бот подписывает сообщение чужим именем и аватаром, и только это сообщение. Бейдж «Бот» остаётся, а в профиле отправителя видно настоящего бота. Так показывают автора из другой системы, когда переносят в Пачку чужую переписку. С личным токеном поле недоступно, ответ `403`. До 255 байт в UTF-8, для кириллицы это около 127 символов. Подробности — в разделе [Боты](https://dev.pachca.com/guides/bots/overview). (макс. 255 символов)",
         }),
         'skip-invite-mentions': Flags.boolean({
-            description: "Пропуск добавления упомянутых сотрудников в тред. В треде упоминание работает ещё и как приглашение: упомянутого сотрудника, которого в треде нет, Пачка туда добавляет, и он получает доступ к треду и родительскому сообщению. Если в пространстве включена настройка «Использовать сквозные треды» (так по умолчанию), упоминание добавляет и сотрудника не из родительского чата, а с `true` в этом поле упоминание никого не добавляет. Упоминание от гостя или мульти-гостя при этом добавляет только тех, с кем у автора есть общий чат. Если настройка выключена, упоминание добавляет только участников родительского чата, и это поле ничего не меняет. В беседе и канале упоминание никого не добавляет, и этот параметр там ничего не меняет.",
+            description: "Пропуск добавления упомянутых сотрудников в тред. В треде упоминание работает ещё и как приглашение: упомянутого сотрудника, которого в треде нет, Пачка туда добавляет, и он получает доступ к треду и родительскому сообщению. Если в пространстве включена настройка «Использовать сквозные треды» (так по умолчанию), упоминание добавляет и сотрудника не из родительского чата, а с `true` в этом поле упоминание никого не добавляет, и тот, кого в треде нет, не получает и уведомления. Упоминание от гостя или мульти-гостя при этом добавляет только тех, с кем у автора есть общий чат. Если настройка выключена, упоминание добавляет только участников родительского чата, и это поле ничего не меняет. В беседе и канале упоминание никого не добавляет, и этот параметр там ничего не меняет.",
             allowNo: true,
         }),
         'link-preview': Flags.boolean({
@@ -54,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' },