@pachca/cli 2026.9.1 → 2026.10.1

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 2026.10.1  (20 октября 2026)
+
+- **Изменено** (chats request-export): Команда выводит номер выгрузки `id`: с ним `pachca chats download-export` забирает архив, когда тот соберётся
+- **Добавлено** (chats create): Команда предупреждает в stderr об идентификаторах из `--member-ids`, которых не удалось добавить в чат
+- **Добавлено** (bots update-avatar, bots remove-avatar): Новые команды — аватар бота: загрузка файла флагом `--file` и удаление
+- **Добавлено** (bots get): В `webhook` приходят адрес входящего вебхука `url`, секрет подписи `secret_token` и тело последнего запроса `last_request_body`, если у токена есть скоуп `bots:write` и вы можете управлять токенами бота
+- **Изменено** (messages create): Сообщение уходит без `--content`, если к нему приложены файлы
+- **Изменено** (profile update-status, users update-status): `--emoji` и `--title` нужны, только когда статуса ещё нет — продлить статус можно одним `--expires-at`
+- **Изменено** (upload, files direct-url): `pachca upload` передаёт в форме загрузки `acl` и `bucket`, только если они пришли, а у `pachca files direct-url` флаг `--acl` необязателен и есть флаг `--bucket`: в части пространств метод `Получение подписи, ключа и других параметров` отдаёт `bucket` вместо `acl`
+
+## 2026.10.0  (13 октября 2026)
+
+- **Добавлено** (bots list-tokens, bots create-token, bots update-token, bots reissue-token, bots delete-token): Новые команды — токены бота: у бота может быть несколько токенов, у каждого своё имя и права. Значение токена показывается один раз, при выпуске и перевыпуске.
+- **Добавлено** (bots list-scopes): Новая команда — каталог прав, которые можно выдать боту: его токенам и авторизации от имени сотрудника
+- **Добавлено** (bots rotate-client-secret): Новая команда — новый `client_secret` для авторизации от имени сотрудника. Прежний секрет перестаёт работать сразу.
+- **Добавлено** (bots create, bots update): Флаги `--oauth-client` и `--promo` включают авторизацию от имени сотрудника и заполняют страницу бота в витрине, `--kind` выбирает источник входящего вебхука, а `--unfurl-domains` задаёт домены для разворачивания ссылок. У `bots create` появился `--empty` для бота без токена, у `bots update` — `--single-chat`.
+- **Добавлено** (chats mark-unread): Новая команда — отметка чата непрочитанным для владельца токена
+- **Добавлено** (chats update-avatar, chats remove-avatar): Новые команды — аватар беседы или канала: загрузка файла флагом `--file` и удаление. В выводе команд с чатами появилось поле `avatar_url`.
+- **Добавлено** (security list): Флаг `--event-key` принимает значения `bot_token_created`, `bot_token_updated`, `bot_token_reissued`, `bot_token_deleted`, `bot_oauth_client_secret_issued`, `bot_oauth_client_secret_rotated`, `bot_oauth_client_disabled` и `oauth_token_revoked`
+- **Исправлено** (search users, search chats, search messages, users list): В справке описан ответ `504` с кодом `timeout`, если поиск не уложился по времени
+- **Исправлено** (messages create, messages update, drafts create, drafts update): У файлов в справке указан предел голосового сообщения в 30 минут
+- **Добавлено** (auth login): Вход через браузер передаёт серверу имя устройства, по которому вход узнаётся в списке токенов CLI: имя машины, а у профиля не по умолчанию ещё и имя профиля в скобках, например `macbook (ci)`
+- **Изменено**: После ответа `401` CLI подсказывает, что делать дальше: войти заново, если вход через браузер отозван или завершён, или сохранить новый токен. В подсказку подставлен профиль, с которым запускалась команда, например `pachca auth login --profile ci`
+- **Исправлено** (views open): В справке у блоков `radio` и `checkbox` до 20 вариантов
+- **Исправлено** (bots create, bots update): Справка к `--ignore-self-messages` говорит, что настройка не присылает боту и его собственные реакции
+- **Исправлено** (guide): Сценарии разворачивания ссылок и поллинга описывают раздел «Интеграции»: событие ссылок с доменами вместо отдельного типа бота и история событий без Webhook URL флагом `--events-history-enabled`, который попал и в примеры `bots update`
+- **Исправлено** (messages create, messages update, tasks list): Подсказки к `--content` и `--chat-ids` описывают, что меняется для мульти-гостя
+- **Исправлено** (messages create, messages update, drafts create, drafts update, tasks create, tasks update): В справке к `--content` указан предел длины текста: 40 000 байт, а в пространстве с продвинутым шифрованием 27 000
+- **Исправлено** (messages create, threads add, threads create, threads get, threads list): Подсказка к `--parent-message-id` описывает ответ с цитатой в любом чате, в том числе в треде. В описаниях тредов сказано, какой идентификатор куда передавать: `id` — чтобы написать в тред, `chat_id` — чтобы прочитать его сообщения.
+- **Исправлено** (bots list-events): В справке у события отправки формы сказано, что `chat_id` фиксируется при открытии формы, а не при её отправке
+- **Исправлено** (chats create, members add, users update): В справке описаны отказы для бота с настройкой «Ограничить одним чатом» — `single_chat_bot_occupied`, если он уже состоит в другой беседе или канале, и `single_chat_bot_tag_denied` при добавлении в тег. У `users update` сказано, что у бота меняются только имя, ник, теги и `suspended`.
+- **Исправлено** (tasks get): В справке сказано, что напоминание видят все, кому доступен его чат, по тому же правилу, что у фильтра `--chat-ids` в `tasks list`
+
 ## 2026.9.1  (16 сентября 2026)
 
 - **Изменено**: Повтор после `429` ждёт не меньше срока из `Retry-After`: прежний потолок в 60 секунд убран. Пауза дольше минуты не повторяется — команда сразу возвращает ошибку с заголовком, потому что повтор внутри паузы её удваивает

package/README.md

@@ -85,10 +85,19 @@ pachca guide            # список всех сценариев
 | `pachca bots get` | Информация о боте |
 | `pachca bots update` | Редактирование бота |
 | `pachca bots delete` | Удаление бота |
+| `pachca bots update-avatar` | Загрузка аватара бота |
+| `pachca bots remove-avatar` | Удаление аватара бота |
 | `pachca bots recreate-token` | Ротация токена бота |
+| `pachca bots rotate-client-secret` | Ротация секрета клиента |
+| `pachca bots list-scopes` | Каталог прав бота |
+| `pachca bots list-tokens` | Список токенов бота |
+| `pachca bots create-token` | Новый токен бота |
+| `pachca bots update-token` | Изменение токена бота |
+| `pachca bots delete-token` | Удаление токена бота |
+| `pachca bots reissue-token` | Перевыпуск токена бота |
 | `pachca bots list-company` | Список ботов пространства |
 | `pachca bots list-events` | История событий |
-| `pachca bots remove-event` | Удаление события |
+| `pachca bots remove-event` | Удаление события истории |
 
 ### chats
 
@@ -101,7 +110,10 @@ pachca guide            # список всех сценариев
 | `pachca chats get` | Информация о чате |
 | `pachca chats update` | Редактирование чата |
 | `pachca chats archive` | Архивация чата |
+| `pachca chats update-avatar` | Загрузка аватара чата |
+| `pachca chats remove-avatar` | Удаление аватара чата |
 | `pachca chats unarchive` | Разархивация чата |
+| `pachca chats mark-unread` | Отметка чата непрочитанным |
 | `pachca chats list-company` | Список чатов пространства |
 
 ### members
@@ -109,12 +121,12 @@ pachca guide            # список всех сценариев
 | Команда | Описание |
 |---------|---------|
 | `pachca members add-group-tags` | Добавление тегов |
-| `pachca members remove-group-tag` | Исключение тега |
+| `pachca members remove-group-tag` | Исключение тега из чата |
 | `pachca members leave` | Выход из чата |
 | `pachca members list` | Список участников чата |
-| `pachca members add` | Добавление пользователей |
-| `pachca members remove` | Исключение пользователя |
-| `pachca members update` | Редактирование роли |
+| `pachca members add` | Добавление участников |
+| `pachca members remove` | Исключение участника |
+| `pachca members update` | Редактирование роли участника |
 
 ### custom-properties
 

package/dist/base-command.js

@@ -209,6 +209,18 @@ export class BaseCommand extends Command {
         }
         outputData(data, opts);
     }
+    /**
+     * Warn about a non-empty list from the response `meta` (e.g. `not_found_member_ids`).
+     *
+     * stdout keeps printing only `data`, so `-o json` output keeps its shape. The list
+     * goes to stderr in every output mode, like the other `⚠` notices.
+     */
+    warnMetaList(meta, field, message, hint) {
+        const value = meta && typeof meta === 'object' ? meta[field] : undefined;
+        if (!Array.isArray(value) || value.length === 0)
+            return;
+        process.stderr.write(`⚠ ${message}: ${value.join(', ')}.\n  ${hint}\n`);
+    }
     /**
      * Output a success message to stderr.
      */
@@ -272,6 +284,38 @@ export class BaseCommand extends Command {
         }
         this.exit(3);
     }
+    /**
+     * What to do after a 401: the login was revoked, or the saved token no longer works.
+     *
+     * A browser login is fixed by logging in again, a saved token by saving a new one.
+     * The command carries the profile the call ran with, so it can be pasted as is.
+     * JSON output gets the bare command, like the other hints there.
+     */
+    reloginHint() {
+        const format = this.getOutputFormat();
+        const human = format !== 'json' && process.stderr.isTTY;
+        let resolved;
+        try {
+            resolved = resolveToken({ token: this.parsedFlags.token, profile: this.parsedFlags.profile });
+        }
+        catch {
+            // no profile resolved — the token came in from a flag or the environment
+        }
+        if (!resolved?.profile || !resolved.profileName) {
+            return human
+                ? 'Токен из --token или PACHCA_TOKEN недействителен или отозван.'
+                : 'token from --token or PACHCA_TOKEN is invalid or revoked';
+        }
+        const flag = resolved.profileName === 'default' ? '' : ` --profile ${resolved.profileName}`;
+        if (getAuthMethod(resolved.profile) === 'oauth') {
+            return human
+                ? `Вход завершён или отозван. Войдите заново: pachca auth login${flag}`
+                : `pachca auth login${flag}`;
+        }
+        return human
+            ? `Токен недействителен или отозван. Сохраните новый: pachca auth login${flag} --token <токен>`
+            : `pachca auth login${flag} --token <token>`;
+    }
     /**
      * Handle errors with structured output.
      */
@@ -280,6 +324,9 @@ export class BaseCommand extends Command {
             this.reportScopeError(err);
         }
         if (err instanceof ApiError) {
+            if (err.details.code === 401 && !err.details.hint) {
+                err.details.hint = this.reloginHint();
+            }
             outputError(err.details, this.getOutputFormat());
             this.exit(getExitCode(err));
         }

package/dist/client.js

@@ -33,8 +33,9 @@ function buildUrl(apiPath, query) {
         for (const [key, value] of Object.entries(query)) {
             if (value !== undefined) {
                 if (Array.isArray(value)) {
+                    // The key already carries the form the spec declares, `name[]` for a list.
                     for (const v of value) {
-                        url.searchParams.append(`${key}[]`, String(v));
+                        url.searchParams.append(key, String(v));
                     }
                 }
                 else {

package/dist/commands/auth/login.js

@@ -4,7 +4,7 @@ import { setProfile, setActiveProfile, getActiveProfile, getProfile, getSecretSt
 import { isSecretStoreAvailable } from '../../secret-store.js';
 import { ApiError, request } from '../../client.js';
 import { outputError } from '../../output.js';
-import { OAuthError, copyToClipboard, openBrowser, pollForToken, requestDeviceCode, } from '../../oauth.js';
+import { OAuthError, copyToClipboard, deviceName, openBrowser, pollForToken, requestDeviceCode, } from '../../oauth.js';
 export default class AuthLogin extends BaseCommand {
     static description = 'Вход в аккаунт и сохранение профиля';
     static examples = [
@@ -66,7 +66,7 @@ export default class AuthLogin extends BaseCommand {
         }
         const grant = flags.token
             ? { access_token: flags.token }
-            : await this.deviceLogin(!flags['no-browser'], flags.quiet);
+            : await this.deviceLogin(profileName, !flags['no-browser'], flags.quiet);
         const tokenInfo = await this.verifyToken(grant.access_token);
         const identity = await this.fetchIdentity(grant.access_token, tokenInfo.user_id);
         const scopes = grant.scope ? grant.scope.split(' ').filter(Boolean) : tokenInfo.scopes;
@@ -105,10 +105,10 @@ export default class AuthLogin extends BaseCommand {
      * the code baked in is never shown — a link like that works as phishing when it
      * is forwarded to someone else's device.
      */
-    async deviceLogin(useBrowser, quiet) {
+    async deviceLogin(profileName, useBrowser, quiet) {
         let grant;
         try {
-            grant = await requestDeviceCode();
+            grant = await requestDeviceCode(deviceName(profileName));
         }
         catch (error) {
             this.failOAuth(error, 'Не удалось начать вход');

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

@@ -0,0 +1,84 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as clack from '@clack/prompts';
+export default class 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";
+    static defaultColumns = ["id", "name", "created_at", "token", "user_id"];
+    static requiredFlags = ["name"];
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор бота (pachca bots list)",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'name': Flags.string({
+            description: "Имя токена: по нему токены различают в списке (макс. 255 символов)",
+        }),
+        'scopes': Flags.string({
+            description: "Права токена. Доступны только права, которые можно выдать боту. Если не передать, токен выпускается без прав.",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsCreateToken);
+        this.parsedFlags = flags;
+        const missingRequired = [
+            { flag: 'name', label: "Имя токена: по нему токены различают в списке", type: 'string' },
+        ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
+        if (missingRequired.length > 0) {
+            if (this.isInteractive()) {
+                for (const field of missingRequired) {
+                    const value = await clack.text({ message: field.label, validate: (v) => v.length === 0 ? 'Обязательное поле' : undefined });
+                    if (clack.isCancel(value)) {
+                        process.stderr.write('Отменено.\n');
+                        this.exit(0);
+                    }
+                    if (field.type === 'integer') {
+                        flags[field.flag] = Number.parseInt(value, 10);
+                    }
+                    else if (field.type === 'boolean') {
+                        flags[field.flag] = value === 'true';
+                    }
+                    else {
+                        flags[field.flag] = value;
+                    }
+                }
+            }
+            else {
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --name <string>. pachca introspect bots create-token" });
+            }
+        }
+        const validationErrors = [];
+        if (flags['name'] && String(flags['name']).length > 255) {
+            validationErrors.push({ message: `--name: максимум 255 символов (передано: ${String(flags['name']).length})`, flag: 'name' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
+        const body = {
+            name: flags['name'],
+            scopes: flags['scopes'] ? this.parseJSON(flags['scopes'], 'scopes') : undefined,
+        };
+        // Clean undefined fields
+        for (const [k, v] of Object.entries(body)) {
+            if (v === undefined)
+                delete body[k];
+        }
+        const { data } = await this.apiRequest({
+            method: 'POST',
+            path: `/bots/${args.id}/tokens`,
+            body,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/bots/create.js

@@ -11,7 +11,7 @@ export default class BotsCreate extends BaseCommand {
     static scope = "bots:write";
     static apiMethod = "POST";
     static apiPath = "/bots";
-    static defaultColumns = ["id", "webhook", "access_token"];
+    static defaultColumns = ["id", "name", "created_at", "nickname", "avatar_url"];
     static requiredFlags = ["name"];
     static args = {};
     static flags = {
@@ -41,7 +41,7 @@ export default class BotsCreate extends BaseCommand {
             description: "Шаблон форматирования входящего вебхука",
         }),
         'template-engine': Flags.string({
-            description: "Шаблонизатор для обработки шаблона входящего вебхука",
+            description: "Шаблонизатор для обработки шаблона входящего вебхука. Без этого поля бот получает `liquid`, а пустой бот (`empty: true`) — `mustache`.",
         }),
         'challenge-key': Flags.string({
             description: "Название поля проверки для верификации входящего вебхука",
@@ -51,7 +51,7 @@ export default class BotsCreate extends BaseCommand {
             allowNo: true,
         }),
         'ignore-self-messages': Flags.boolean({
-            description: "Игнорировать входящие сообщения, отправленные самим ботом",
+            description: "Не присылать боту события о его собственных сообщениях и реакциях",
             allowNo: true,
         }),
         'events-history-enabled': Flags.boolean({
@@ -65,9 +65,25 @@ export default class BotsCreate extends BaseCommand {
             description: "Роли, которым, помимо создателя, разрешено редактировать настройки бота. Создатель может редактировать всегда. Пустой массив — редактировать может только создатель.",
         }),
         'single-chat': Flags.boolean({
-            description: "Ограничивает бота одной беседой или каналом: `true` — бота можно добавить только в один такой чат, `false` — в несколько. Личные чаты и треды в ограничение не входят. Задаётся только при создании, при редактировании не меняется.",
+            description: "Ограничивает бота одной беседой или каналом: `true` — бота можно добавить только в один такой чат, `false` — в несколько. Личные чаты и треды в ограничение не входят.",
             allowNo: true,
         }),
+        'kind': Flags.string({
+            description: "Источник входящего вебхука. Без `empty` по умолчанию `simple`, а у пустого бота входящий вебхук включается только этим полем.",
+        }),
+        'unfurl-domains': Flags.string({
+            description: "Домены, ссылки на которые бот разворачивает, не больше 5. Работают вместе с событием `message_link_shared`.",
+        }),
+        'empty': Flags.boolean({
+            description: "Создать пустого бота: без токена и без входящего вебхука. Без этого поля бот создаётся с входящим вебхуком в своём формате, а его токен приходит в `access_token`.",
+            allowNo: true,
+        }),
+        'oauth-client': Flags.string({
+            description: "Включить авторизацию от имени сотрудника сразу при создании",
+        }),
+        'promo': Flags.string({
+            description: "Страница бота в витрине. Задаётся только вместе с `oauth_client`: без авторизации страницы у бота нет.",
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(BotsCreate);
@@ -108,7 +124,8 @@ export default class BotsCreate extends BaseCommand {
         if (validationErrors.length > 0) {
             this.validationError(validationErrors);
         }
-        const body = { webhook: {
+        const body = {
+            webhook: {
                 name: flags['name'],
                 nickname: flags['nickname'],
                 outgoing_url: flags['outgoing-url'],
@@ -125,13 +142,23 @@ export default class BotsCreate extends BaseCommand {
                 who_can_add: flags['who-can-add'],
                 can_edit: flags['can-edit'] ? this.parseJSON(flags['can-edit'], 'can-edit') : undefined,
                 single_chat: flags['single-chat'],
-            } };
+                kind: flags['kind'],
+                unfurl_domains: flags['unfurl-domains'] ? this.parseJSON(flags['unfurl-domains'], 'unfurl-domains') : undefined,
+            },
+            empty: flags['empty'],
+            oauth_client: flags['oauth-client'] ? this.parseJSON(flags['oauth-client'], 'oauth-client') : undefined,
+            promo: flags['promo'] ? this.parseJSON(flags['promo'], 'promo') : undefined,
+        };
         // Clean undefined fields
         const inner = body['webhook'];
         for (const [k, v] of Object.entries(inner)) {
             if (v === undefined)
                 delete inner[k];
         }
+        for (const [k, v] of Object.entries(body)) {
+            if (k !== 'webhook' && v === undefined)
+                delete body[k];
+        }
         const { data } = await this.apiRequest({
             method: 'POST',
             path: '/bots',

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

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

package/dist/commands/bots/delete.js

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

package/dist/commands/bots/get.js

@@ -6,7 +6,7 @@ export default class BotsGet extends BaseCommand {
     static scope = "bots:read";
     static apiMethod = "GET";
     static apiPath = "/bots/{id}";
-    static defaultColumns = ["id", "webhook"];
+    static defaultColumns = ["id", "name", "created_at", "nickname", "avatar_url"];
     static args = {
         id: Args.integer({
             description: "Идентификатор бота (pachca bots list)",

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

@@ -52,7 +52,7 @@ export default class BotsListCompany extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы — has_next === false; методы поиска и /users?query= (без has_next) — пустой data
+                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)

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

@@ -47,7 +47,7 @@ export default class BotsListEvents extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы — has_next === false; методы поиска и /users?query= (без has_next) — пустой data
+                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)

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

@@ -0,0 +1,32 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+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";
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор бота (pachca bots list)",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsListScopes);
+        this.parsedFlags = flags;
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: `/bots/${args.id}/scopes`,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

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

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

package/dist/commands/bots/list.js

@@ -4,12 +4,12 @@ import { BaseCommand } from '../../base-command.js';
 export default class BotsList extends BaseCommand {
     static description = "Список ботов";
     static examples = [
-        "Найти и удалить бота — Пользовательским токеном (скоуп `bots:read`) получи список ботов, доступных тебе для редактирования: созданных тобой и тех, чьи настройки открывают тебе доступ. Фильтруй по имени параметром `query`, следующую страницу бери из `meta.paginate.next_page`:\n  $ pachca bots list"
+        "Найти и удалить бота — Пользовательским токеном (скоуп `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";
-    static defaultColumns = ["id", "webhook"];
+    static defaultColumns = ["id", "name", "created_at", "nickname", "avatar_url"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -51,7 +51,7 @@ export default class BotsList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы — has_next === false; методы поиска и /users?query= (без has_next) — пустой data
+                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)

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

@@ -2,7 +2,7 @@ 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"
+        "Ротация токена бота — Или: бот перевыпускает свой основной токен сам (скоуп `bot_self:write`). Если запрос сделан основным токеном, он инвалидируется сразу — обязательно сохрани новый `access_token` из ответа, иначе бот потеряет доступ к API:\n  $ pachca bots recreate-token-self"
     ];
     static scope = "bot_self:write";
     static apiMethod = "POST";