@pachca/cli 2026.10.2 → 2026.10.4

package/dist/commands/auth/login.js

@@ -10,7 +10,7 @@ export default class AuthLogin extends BaseCommand {
     static examples = [
         '<%= config.bin %> auth login',
         '<%= config.bin %> auth login --profile personal',
-        '<%= config.bin %> auth login --profile ci --token $PACHCA_TOKEN',
+        'pbpaste | <%= config.bin %> auth login --profile bot-notify --token -',
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -42,7 +42,7 @@ export default class AuthLogin extends BaseCommand {
         // the person guesses to press Ctrl-D. Say what was expected instead.
         if (flags.token === '-' && process.stdin.isTTY) {
             outputError({
-                error: 'Option --token - reads the token from stdin. Pipe it in: echo "$TOKEN" | pachca auth login --token -',
+                error: 'Option --token - reads the token from stdin. Pipe it in, for example from the clipboard: pbpaste | pachca auth login --token -',
                 type: 'PACHCA_USAGE_ERROR',
                 code: null,
             }, this.getOutputFormat());
@@ -104,6 +104,10 @@ export default class AuthLogin extends BaseCommand {
      * The address and the code are printed separately and the ready-made link with
      * the code baked in is never shown — a link like that works as phishing when it
      * is forwarded to someone else's device.
+     *
+     * They are printed even under `--quiet`: the browser opens either way, and a
+     * confirmation page with no code to type leaves the person stuck. `--quiet`
+     * drops only the waiting line and the final report.
      */
     async deviceLogin(profileName, useBrowser, quiet) {
         let grant;
@@ -113,14 +117,13 @@ export default class AuthLogin extends BaseCommand {
         catch (error) {
             this.failOAuth(error, 'Не удалось начать вход');
         }
-        if (!quiet) {
-            const copied = copyToClipboard(grant.user_code);
-            process.stderr.write(`\n  Откройте ${grant.verification_uri}\n`);
-            process.stderr.write(`  и введите код: ${grant.user_code}\n`);
-            if (copied)
-                process.stderr.write(`  (код скопирован в буфер обмена)\n`);
+        const copied = copyToClipboard(grant.user_code);
+        process.stderr.write(`\n  Откройте ${grant.verification_uri}\n`);
+        process.stderr.write(`  и введите код: ${grant.user_code}\n`);
+        if (copied)
+            process.stderr.write(`  (код скопирован в буфер обмена)\n`);
+        if (!quiet)
             process.stderr.write(`\n  Ожидаю подтверждения…\n`);
-        }
         if (useBrowser)
             openBrowser(grant.verification_uri);
         try {

package/dist/commands/auth/logout.js

@@ -2,7 +2,7 @@ import { Args } from '@oclif/core';
 import * as clack from '@clack/prompts';
 import { BaseCommand } from '../../base-command.js';
 import { listProfiles, deleteProfile, getAuthMethod, getSecretStorage, getProfile } from '../../profiles.js';
-import { revokeToken } from '../../oauth.js';
+import { revokeSession } from '../../token-refresh.js';
 import { outputError } from '../../output.js';
 export default class AuthLogout extends BaseCommand {
     static description = 'Удаление сохранённого профиля';
@@ -72,14 +72,14 @@ export default class AuthLogout extends BaseCommand {
         }
         const authMethod = getAuthMethod(profiles[profileName]);
         const storage = getSecretStorage(profiles[profileName]);
-        // Put the token out server-side before dropping the profile — afterwards the
-        // secret is gone and there is nothing left to revoke with. Only tokens this
-        // CLI issued can revoke themselves; a pasted one is not ours to cancel.
-        let revoked = false;
+        // Close the login server-side before dropping the profile — afterwards the
+        // secrets are gone and there is nothing left to revoke with. Only logins this
+        // CLI made can revoke themselves; a pasted token is not ours to cancel.
+        let session = 'open';
         if (authMethod === 'oauth') {
-            const secret = getProfile(profileName)?.token;
-            if (secret)
-                revoked = await revokeToken(secret);
+            const profile = getProfile(profileName);
+            if (profile)
+                session = await revokeSession(profileName, profile);
         }
         deleteProfile(profileName);
         if (format === 'json') {
@@ -87,7 +87,11 @@ export default class AuthLogout extends BaseCommand {
                 deleted_profile: profileName,
                 auth: authMethod,
                 storage,
-                token_revoked: revoked,
+                // True when the server confirms the login is closed. The revoke endpoint
+                // answers 200 to a login closed earlier too, so the field reports the
+                // state on the server, not which call closed it. False means nothing
+                // confirms it: the login may still be alive in the «Токены CLI» list.
+                token_revoked: session !== 'open',
             });
             return;
         }
@@ -96,9 +100,16 @@ export default class AuthLogout extends BaseCommand {
         // token when it did not is worse than an extra line here.
         if (!flags.quiet) {
             if (authMethod === 'oauth') {
-                process.stderr.write(revoked
-                    ? `  Токен отозван на сервере и удалён с этой машины.\n`
-                    : `  Токен удалён с этой машины. Отозвать его не удалось — перестанет действовать по истечении срока.\n`);
+                if (session === 'revoked') {
+                    process.stderr.write(`  Вход закрыт на сервере, токен удалён с этой машины.\n`);
+                }
+                else if (session === 'closed') {
+                    process.stderr.write(`  Токен удалён с этой машины. Вход на сервере уже был закрыт.\n`);
+                }
+                else {
+                    process.stderr.write(`  Токен удалён с этой машины, но закрыть вход на сервере не удалось.\n`);
+                    process.stderr.write(`  Отзовите его в Пачке: Интеграции > API, список «Токены CLI».\n`);
+                }
             }
             else {
                 process.stderr.write(`  Токен удалён с этой машины, но продолжает действовать.\n`);

package/dist/commands/bots/create-token.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class BotsCreateToken extends BaseCommand {
     static description = "Новый токен бота";
-    static examples = [
-        "Выпустить боту отдельный токен — Выпусти токен с именем и правами из каталога. Без `--scopes` токен выпускается без прав, право не из каталога отклоняется с `400`:\n  $ pachca bots create-token"
-    ];
     static scope = "bots:write";
     static apiMethod = "POST";
     static apiPath = "/bots/{id}/tokens";

package/dist/commands/bots/create.js

@@ -4,10 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class BotsCreate extends BaseCommand {
     static description = "Новый бот";
-    static examples = [
-        "Создать бота через API и получить токен — Создай бота. Только пользовательским токеном (не токеном бота); `nickname` обязан заканчиваться на `_bot`. Параметры вебхука (Webhook URL, события, команды) можно задать сразу или позже. Скоупы токена бота можно ограничить флагом `--scopes` (если не указать — бот получит набор по умолчанию):\n  $ pachca bots create",
-        "Настроить бота с исходящим вебхуком — Создай бота, сразу указав Webhook URL и события в одном вызове (детали создания и работы с токеном — в сценарии «Создать бота через API и получить токен»):\n  $ pachca bots create"
-    ];
     static scope = "bots:write";
     static apiMethod = "POST";
     static apiPath = "/bots";
@@ -32,7 +28,7 @@ export default class BotsCreate extends BaseCommand {
             description: "Условие срабатывания исходящего вебхука",
         }),
         'commands': Flags.string({
-            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Событие о сообщении приходит боту, когда первое слово текста совпадает с одной из команд целиком, с учётом регистра. Команду можно задать и без слэша в начале. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
         }),
         'scopes': Flags.string({
             description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию. Боту доступны не все скоупы: часть из них разрешена только пользовательским ролям, и попытка назначить такой скоуп возвращает `400`. Служебные значения `bot` и `all` назначать нельзя.",

package/dist/commands/bots/delete.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class BotsDelete extends BaseCommand {
     static description = "Удаление бота";
-    static examples = [
-        "Найти и удалить бота — Возьми `id` нужного бота из списка и удали его (скоуп `bots:write`). Доступно создателю бота и администратору, если бот открыт администраторам, — владельцы чатов удалять бота не могут. Все токены бота инвалидируются сразу, бот исключается из всех чатов, его вебхуки удаляются:\n  $ pachca bots delete"
-    ];
     static scope = "bots:write";
     static apiMethod = "DELETE";
     static apiPath = "/bots/{id}";

package/dist/commands/bots/get-stream.js

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../base-command.js';
+export default class BotsGetStream extends BaseCommand {
+    static description = "Поток событий";
+    static scope = "webhooks:events:read";
+    static apiMethod = "GET";
+    static apiPath = "/webhooks/events/stream";
+    static defaultColumns = ["url", "expires_at"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsGetStream);
+        this.parsedFlags = flags;
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: '/webhooks/events/stream',
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

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

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class BotsListCompany extends BaseCommand {
     static description = "Список ботов пространства";
-    static examples = [
-        "Инвентаризация всех ботов пространства — Получи всех ботов пространства, а не только доступных для редактирования:\n  $ pachca bots list-company"
-    ];
     static scope = "company_bots:read";
     static plan = "corporation";
     static apiMethod = "GET";
@@ -37,6 +34,7 @@ export default class BotsListCompany extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -52,7 +50,7 @@ export default class BotsListCompany 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)
@@ -62,7 +60,8 @@ export default class BotsListCompany 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/bots/list-events.js

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class BotsListEvents extends BaseCommand {
     static description = "История событий";
-    static examples = [
-        "Обработка событий через историю (polling) — Получи накопленные события:\n  $ pachca bots list-events"
-    ];
     static scope = "webhooks:events:read";
     static apiMethod = "GET";
     static apiPath = "/webhooks/events";
@@ -33,6 +30,7 @@ export default class BotsListEvents extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     limit: flags.limit,
@@ -47,7 +45,7 @@ export default class BotsListEvents 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)
@@ -57,7 +55,8 @@ export default class BotsListEvents 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/bots/list-scopes.js

@@ -3,9 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class BotsListScopes extends BaseCommand {
     static description = "Каталог прав бота";
-    static examples = [
-        "Выпустить боту отдельный токен — Пользовательским токеном (создатель бота или администратор, если бот открыт администраторам) получи каталог прав, которые можно выдать этому боту:\n  $ pachca bots list-scopes"
-    ];
     static scope = "bots:read";
     static apiMethod = "GET";
     static apiPath = "/bots/{id}/scopes";

package/dist/commands/bots/list-tokens.js

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

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class BotsList extends BaseCommand {
     static description = "Список ботов";
-    static examples = [
-        "Найти и удалить бота — Пользовательским токеном (скоуп `bots:read`) получи список ботов, доступных тебе для редактирования: созданных тобой и тех, чьи настройки открывают тебе доступ. Фильтруй по имени параметром `query`. Пока `meta.paginate.has_next` равен `true`, следующую страницу бери из `meta.paginate.next_page`:\n  $ pachca bots list"
-    ];
     static scope = "bots:read";
     static apiMethod = "GET";
     static apiPath = "/bots";
@@ -36,6 +33,7 @@ export default class BotsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -51,7 +49,7 @@ export default class BotsList 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 BotsList 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/bots/recreate-token-self.js

@@ -1,9 +1,6 @@
 import { BaseCommand } from '../../base-command.js';
 export default class BotsRecreateTokenSelf extends BaseCommand {
     static description = "Ротация собственного токена бота";
-    static examples = [
-        "Ротация токена бота — Или: бот перевыпускает свой основной токен сам (скоуп `bot_self:write`). Если запрос сделан основным токеном, он инвалидируется сразу — обязательно сохрани новый `access_token` из ответа, иначе бот потеряет доступ к API:\n  $ pachca bots recreate-token-self"
-    ];
     static scope = "bot_self:write";
     static apiMethod = "POST";
     static apiPath = "/bot/recreate_token";

package/dist/commands/bots/recreate-token.js

@@ -3,9 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class BotsRecreateToken extends BaseCommand {
     static description = "Ротация токена бота";
-    static examples = [
-        "Ротация токена бота — Пользовательским токеном (создатель бота или администратор, если бот открыт администраторам) — перевыпусти основной токен по `id` бота: тот, что без имени, а если такого нет, самый старый. Прежнее значение инвалидируется сразу:\n  $ pachca bots recreate-token"
-    ];
     static scope = "bots:write";
     static apiMethod = "POST";
     static apiPath = "/bots/{id}/recreate_token";

package/dist/commands/bots/reissue-token.js

@@ -3,9 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class BotsReissueToken extends BaseCommand {
     static description = "Перевыпуск токена бота";
-    static examples = [
-        "Ротация токена бота — Отдельный токен бота перевыпускай по его `id` из `pachca bots list-tokens`: значение меняется, имя и права остаются:\n  $ pachca bots reissue-token"
-    ];
     static scope = "bots:write";
     static apiMethod = "POST";
     static apiPath = "/bots/{id}/tokens/{token_id}/reissue";

package/dist/commands/bots/remove-event.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class BotsRemoveEvent extends BaseCommand {
     static description = "Удаление события истории";
-    static examples = [
-        "Обработка событий через историю (polling) — Удали обработанное событие:\n  $ pachca bots remove-event"
-    ];
     static scope = "webhooks:events:delete";
     static apiMethod = "DELETE";
     static apiPath = "/webhooks/events/{id}";

package/dist/commands/bots/update-webhook.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class BotsUpdateWebhook extends BaseCommand {
     static description = "Саморегистрация вебхука бота";
-    static examples = [
-        "Обновить Webhook URL бота — Или: бот сам обновляет свой webhook своим же токеном — без `id` и без участия администратора (нужен скоуп `bot_self:webhook:write`):\n  $ pachca bots update-webhook"
-    ];
     static scope = "bot_self:webhook:write";
     static apiMethod = "PUT";
     static apiPath = "/bot/webhook";

package/dist/commands/bots/update.js

@@ -1,13 +1,9 @@
 // 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 examples = [
-        "Обновить Webhook URL бота — Пользовательским токеном (с правом редактировать бота) — обнови URL по `id` бота. Пустая строка отключает вебхук:\n  $ pachca bots update",
-        "Включить боту авторизацию от имени сотрудника — Пользовательским токеном (создатель бота или администратор, если бот открыт администраторам) включи авторизацию: где хранится секрет, адреса возврата и права, которые бот попросит у сотрудника. Права бери из `pachca bots list-scopes`:\n  $ pachca bots update",
-        "Включить боту авторизацию от имени сотрудника — Чтобы бот появился в витрине, добавь описание и опубликуй страницу:\n  $ pachca bots update"
-    ];
     static scope = "bots:write";
     static apiMethod = "PUT";
     static apiPath = "/bots/{id}";
@@ -36,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` назначать нельзя.",
@@ -72,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`. Список заменяется целиком.",

package/dist/commands/chats/archive.js

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

package/dist/commands/chats/create.js

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

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

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

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

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

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

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

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

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

package/dist/commands/chats/unarchive.js

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