@pachca/cli 2026.10.3 → 2026.10.4

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";
@@ -21,7 +22,7 @@ export default class DraftsCreate extends BaseCommand {
         'content': Flags.string({
             description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. До 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";
@@ -18,8 +19,8 @@ export default class DraftsUpdate extends BaseCommand {
         'content': Flags.string({
             description: "Текст черновика. До 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: "Прикрепляемые файлы",
@@ -37,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: "Пропуск добавления упомянутых сотрудников в тред. В треде упоминание работает ещё и как приглашение: упомянутого сотрудника, которого в треде нет, Пачка туда добавляет, и он получает доступ к треду и родительскому сообщению. Если в пространстве включена настройка «Использовать сквозные треды» (так по умолчанию), упоминание добавляет и сотрудника не из родительского чата, а с `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' },

package/dist/commands/messages/list.js

@@ -79,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'],
@@ -96,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)
@@ -106,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/update.js

@@ -16,7 +16,7 @@ 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 символов.",
+            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). Ник берут из ответа метода, а `user_id` — из данных: ник, составленный из имени, никого не упоминает. У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов.",
         }),
         'files': Flags.string({
             description: "Прикрепляемые файлы. Переданный набор заменяет прежний: чтобы оставить уже приложенный файл, передайте его снова с тем же `key`. Такой файл остаётся прежним вложением с тем же `id` и названием, а его поля из запроса не применяются. Чтобы показать файл под другим названием, загрузите его заново.",
@@ -40,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/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/read-member/list-readers.js

@@ -34,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,
@@ -48,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)
@@ -58,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

@@ -55,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'],
@@ -76,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)
@@ -86,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

@@ -58,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'],
@@ -80,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)
@@ -90,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}...`);
                 }