@pachca/cli 2026.10.3 → 2026.10.4

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 2026.10.4  (31 октября 2026)
+
+- **Исправлено** (api): Справка `--docs` и схема `--spec` показывают `dlp_rule_id` в деталях события `dlp_violation_detected` строкой, как его отдаёт API
+- **Добавлено** (upload): Флаг `--name` задаёт имя файла, которым заканчивается `key`: так данные из stdin получают расширение и уходят в сообщение под этим именем
+- **Исправлено** (upload): Файл, которого нет на диске, команда отклоняет до запроса подписи, в том числе с `--dry-run`
+- **Изменено** (doctor): Проверяет тот же токен, что и остальные команды, в том же порядке: `--token`, `--profile`, `PACHCA_TOKEN`, `PACHCA_PROFILE`, активный профиль, поэтому в CI с одной `PACHCA_TOKEN` команда проходит
+- **Изменено** (doctor): При ошибке хотя бы одной проверки команда завершается с кодом `1` в любом формате вывода, в том числе с `-o json`
+- **Изменено** (doctor): Без файла конфига команда показывает путь, по которому его ищет
+- **Исправлено**: `--dry-run` показывает запрос без входа и без `PACHCA_TOKEN`, а токен в заголовке `Authorization` заменён маской
+- **Исправлено** (files direct-url): С `--dry-run` запрос показан без заголовка `Authorization`, как он и уходит в хранилище
+- **Изменено** (bots update, drafts update): Слово `null` во флаге поля, которое принимает `null`, уходит в API как JSON null: `--kind null` удаляет входящий вебхук бота, а `--parent-message-id null` снимает ответ с черновика
+- **Исправлено** (auth login): Вход через браузер с `--quiet` печатает адрес и код подтверждения, а флаг убирает только строку ожидания и отчёт о входе
+- **Изменено** (auth login): Пример в `--help` и подсказка при `--token -` без потока ввода передают токен из буфера обмена: `pbpaste | pachca auth login --token -`
+- **Исправлено** (messages create, messages update, drafts create, drafts update, tasks create, tasks update): Текст из потока ввода попадает в запрос, только когда поток не пуст, а с пустым потоком, как у скрипта или агента, команда отправляет поля из флагов
+- **Изменено**: Отказ `403` с `role_forbidden` в терминале объясняется словами: право у токена есть, но действие не разрешает роль, поэтому новый вход или токен не помогут. Вывод с `-o json` и в пайпе прежний.
+- **Изменено**: Объяснение отказа `insufficient_scope` в терминале зависит от источника токена: с `--token` или `PACHCA_TOKEN` команда предлагает `pachca oauth token-info -o json`, а если право есть в сохранённом списке профиля, советует обновить его через `pachca auth status --remote`
+- **Изменено**: Когда вход через браузер завершён или отозван, сообщение и подсказка `pachca auth login` называют профиль, с которым шла команда
+- **Исправлено** (api): Эквивалентная команда в справке `--describe` повторяет пример запроса из спецификации и работает при копировании
+- **Исправлено** (api): Пример `pachca api POST /messages` в `--help` передаёт `message[entity_id]` в кавычках и работает при копировании, а описание команды и ошибка `--describe` для неизвестного пути говорят «метод»
+- **Изменено** (views open): Выводит ответ API `{ "success": true }`
+- **Изменено**: Справка команд следует обновлённым описаниям API: удаление входящего вебхука, правило совпадения команд бота, правило упоминаний в тексте сообщения, `duration_ms` и `file_type` у файлов, срок ссылки на поток событий, напоминания вместо задач, поле `scopes` у `bot_token_updated` и другие поля деталей журнала аудита, значения настройки бота у `restricted_bot_tag_denied` в подсказке `--list-tags`, добавление участников в тред, создание треда, `--skip-invite-mentions`, правка без уведомления и список прочитавших
+- **Исправлено** (api): Справка `--docs` и схема `--spec` описывают `scopes` в деталях бота журнала аудита так, как его писал API до 7 октября 2026 года: список прав у `bot_token_created` и объект с `previous` и `new` у `bot_token_updated`
+- **Изменено** (search): С `--all` команды поиска останавливаются по `has_next` и показывают в терминале, сколько результатов загружено из общего числа найденных
+- **Изменено** (api): Справка `--docs` и схема `--spec` методов поиска показывают поле `has_next` в `meta.paginate`
+
 ## 2026.10.3  (28 октября 2026)
 
 - **Изменено** (guide): Команда убрана вместе со сценариями: как решать задачи в Пачке, агенту рассказывают скиллы (https://dev.pachca.com/guides/mcp/plugin), а флаги каждой команды показывает `pachca <команда> --help`

package/README.md

@@ -286,11 +286,11 @@ pachca auth switch bot-notify
 # Загрузить файл (получает подпись и загружает автоматически)
 pachca upload photo.jpg
 
-# Из stdin
-cat data.csv | pachca upload -
+# Из stdin: имя с расширением задаёт --name
+cat data.csv | pachca upload - --name data.csv
 ```
 
-Команда `upload` автоматически получает подпись (`POST /uploads`) и загружает файл на S3. Возвращает `key` — используйте его в `--files` при создании сообщений.
+Команда `upload` автоматически получает подпись (`POST /uploads`) и загружает файл на S3. Возвращает `key` — используйте его в `--files` при создании сообщений. Расширение `name` в файле сообщения должно совпадать с расширением имени в `key`.
 
 ## Пагинация
 
@@ -340,7 +340,7 @@ pachca users list --columns id,email,role
 pachca users list --columns email --no-header
 
 # Пайп — цвет отключается автоматически
-pachca users list -o json | jq '.[].name'
+pachca users list -o json | jq -r '.[] | "\(.first_name) \(.last_name)"'
 
 # Текст из файла или pipe
 pachca messages create --entity-id 123 < message.txt
@@ -373,7 +373,7 @@ Escape hatch для нестандартных запросов без сген
 
 ```
 pachca api GET /messages --query chat_id=123
-pachca api POST /messages -F message[chat_id]=12345 -f message[content]="Привет"
+pachca api POST /messages -F 'message[entity_id]=12345' -f 'message[content]=Привет'
 pachca api POST /messages --input payload.json
 pachca api GET /profile -o yaml --dry-run
 ```

package/README.template.md

@@ -68,11 +68,11 @@ pachca auth switch bot-notify
 # Загрузить файл (получает подпись и загружает автоматически)
 pachca upload photo.jpg
 
-# Из stdin
-cat data.csv | pachca upload -
+# Из stdin: имя с расширением задаёт --name
+cat data.csv | pachca upload - --name data.csv
 ```
 
-Команда `upload` автоматически получает подпись (`POST /uploads`) и загружает файл на S3. Возвращает `key` — используйте его в `--files` при создании сообщений.
+Команда `upload` автоматически получает подпись (`POST /uploads`) и загружает файл на S3. Возвращает `key` — используйте его в `--files` при создании сообщений. Расширение `name` в файле сообщения должно совпадать с расширением имени в `key`.
 
 ## Пагинация
 
@@ -122,7 +122,7 @@ pachca users list --columns id,email,role
 pachca users list --columns email --no-header
 
 # Пайп — цвет отключается автоматически
-pachca users list -o json | jq '.[].name'
+pachca users list -o json | jq -r '.[] | "\(.first_name) \(.last_name)"'
 
 # Текст из файла или pipe
 pachca messages create --entity-id 123 < message.txt
@@ -155,7 +155,7 @@ Escape hatch для нестандартных запросов без сген
 
 ```
 pachca api GET /messages --query chat_id=123
-pachca api POST /messages -F message[chat_id]=12345 -f message[content]="Привет"
+pachca api POST /messages -F 'message[entity_id]=12345' -f 'message[content]=Привет'
 pachca api POST /messages --input payload.json
 pachca api GET /profile -o yaml --dry-run
 ```

package/dist/base-command.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { resolveToken, TokenNotFoundError, ProfileNotFoundError, getAuthMethod, getDefaults, } from './profiles.js';
+import { resolveToken, TokenNotFoundError, ProfileNotFoundError, getAuthMethod, getDefaults, profileFlag, } from './profiles.js';
 import { ApiError, getExitCode, formatDryRun, request } from './client.js';
 import { outputData, outputError, outputSuccess } from './output.js';
 import { defaultOutputFormat, isInteractive } from './utils.js';
@@ -181,8 +181,10 @@ export class BaseCommand extends Command {
      * Make an authenticated API request.
      */
     async apiRequest(opts) {
-        const { token } = this.resolveAuth();
         const clientFlags = this.getClientFlags();
+        // --dry-run sends nothing, so it needs no token: the preview masks the header
+        // either way. Resolving first made it fail with «Token not found» before login.
+        const token = clientFlags['dry-run'] ? '' : this.resolveAuth().token;
         const fullOpts = { ...opts, token };
         if (clientFlags['dry-run']) {
             const dryRunOutput = formatDryRun(fullOpts, this.getOutputFormat() === 'json');
@@ -235,9 +237,11 @@ export class BaseCommand extends Command {
      * Explain a scope refusal instead of printing a bare 403.
      *
      * An agent cannot walk through a consent screen — the most useful thing it can
-     * do is hand control back to a human with the reason spelled out. The reason
-     * differs by how the profile was authorised: an OAuth login already asks for
-     * every scope, so a refusal there can only come from the role.
+     * do is hand control back to a human with the reason spelled out.
+     *
+     * `insufficient_scope` always means the token itself lacks the scope. A role
+     * that does not allow the action comes back as `role_forbidden` instead, see
+     * reportRoleRefusal. The fix differs by how the profile was authorised.
      */
     reportScopeError(err) {
         const format = this.getOutputFormat();
@@ -246,44 +250,69 @@ export class BaseCommand extends Command {
             outputError(err.details, format);
             this.exit(3);
         }
-        let profile;
-        try {
-            ({ profile } = resolveToken({
-                token: this.parsedFlags.token,
-                profile: this.parsedFlags.profile,
-            }));
+        const resolved = this.tryResolveProfile();
+        const profile = resolved?.profile;
+        process.stderr.write(`✗ Не хватает права${scope ? ` ${scope}` : ''}.\n`);
+        if (!profile) {
+            process.stderr.write(`  У токена ${scope ? 'этого' : 'нужного'} права нет.\n`);
+            process.stderr.write(`  Проверить права токена: pachca oauth token-info -o json\n`);
+            this.exit(3);
         }
-        catch {
-            // no profile resolved — the token came in from a flag or the environment
+        // The scope list in the profile is a copy taken at login. When it still names
+        // the scope the server just refused, the copy is stale: the token's scopes were
+        // changed after login. Naming the scope needs the server's message to carry it.
+        const flag = profileFlag(resolved?.profileName);
+        const listedLocally = !!scope && !!profile.scopes?.includes(scope);
+        if (listedLocally) {
+            process.stderr.write(`  В сохранённом списке право есть, но у токена его уже нет: список устарел.\n`);
+            process.stderr.write(`  Обновить список: pachca auth status --remote${flag}\n`);
         }
-        // Two different causes, and the fix differs. Either the scope is not in the
-        // token, or it is there but the role no longer allows it — the API checks
-        // both on every call. Which one it is shows in the token's own scope list.
-        //
-        // Naming the cause needs the scope itself, and that comes from parsing the
-        // server's message. When it cannot be identified, fall back to the generic
-        // wording: guessing a branch here would send people to fix the wrong thing.
-        const granted = scope ? profile?.scopes : undefined;
-        const hasScope = !!scope && !!granted && granted.includes(scope);
-        process.stderr.write(`✗ Не хватает права${scope ? ` ${scope}` : ''}.\n`);
-        if (granted && hasScope) {
-            process.stderr.write(`  Право у токена есть, но его не даёт текущая роль.\n`);
-            process.stderr.write(`  Обратитесь к администратору пространства.\n`);
+        else {
+            process.stderr.write(`  У токена ${scope ? 'этого' : 'нужного'} права нет.\n`);
+        }
+        if (getAuthMethod(profile) === 'oauth') {
+            process.stderr.write(`  При входе через браузер права выдаются по роли на момент подтверждения.\n`);
+            process.stderr.write(`  Если роль с тех пор расширили, войдите заново: pachca auth login${flag}\n`);
+        }
+        else {
+            process.stderr.write(`  Добавьте право токену в Пачке или выпустите новый токен с ним.\n`);
+        }
+        this.exit(3);
+    }
+    /**
+     * Explain a role refusal: the token carries the scope, but the role of the
+     * account behind it does not allow the action. No new login or token changes
+     * that, so say who can. The API names no scope here; a generated command
+     * knows the one its method requires.
+     */
+    reportRoleRefusal(err) {
+        const format = this.getOutputFormat();
+        if (format === 'json' || !process.stderr.isTTY) {
+            outputError(err.details, format);
+            this.exit(3);
         }
-        else if (granted) {
-            process.stderr.write(`  У токена этого права нет.\n`);
-            process.stderr.write(getAuthMethod(profile) === 'oauth'
-                ? `  Права выдаются по роли в момент входа — если роль с тех пор изменилась, войдите заново: pachca auth login\n`
-                : `  Выпустите токен с этим правом в интерфейсе Пачки.\n`);
+        const profile = this.tryResolveProfile()?.profile;
+        const scope = this.constructor.scope;
+        const right = scope ? `Право ${scope}` : 'Право';
+        if (profile?.type === 'bot') {
+            process.stderr.write(`✗ ${right} есть у токена, но его не даёт роль бота.\n`);
+            process.stderr.write(`  Это действие выполняют персональным токеном сотрудника с подходящей ролью.\n`);
         }
         else {
-            process.stderr.write(`  Либо этого права нет у токена, либо его не даёт ваша роль.\n`);
-            process.stderr.write(profile
-                ? `  Проверить права токена: pachca auth status\n`
-                : `  Проверить права токена: pachca api GET /oauth/token/info\n`);
+            process.stderr.write(`✗ ${right} есть у токена, но его не даёт роль.\n`);
+            process.stderr.write(`  Новый вход или новый токен не помогут: роль меняет администратор пространства.\n`);
         }
         this.exit(3);
     }
+    /** The profile the call ran with, or undefined when the token came from --token or PACHCA_TOKEN. */
+    tryResolveProfile() {
+        try {
+            return resolveToken({ token: this.parsedFlags.token, profile: this.parsedFlags.profile });
+        }
+        catch {
+            return undefined;
+        }
+    }
     /**
      * What to do after a 401: the login was revoked, or the saved token no longer works.
      *
@@ -306,7 +335,7 @@ export class BaseCommand extends Command {
                 ? 'Токен из --token или PACHCA_TOKEN недействителен или отозван.'
                 : 'token from --token or PACHCA_TOKEN is invalid or revoked';
         }
-        const flag = resolved.profileName === 'default' ? '' : ` --profile ${resolved.profileName}`;
+        const flag = profileFlag(resolved.profileName);
         if (getAuthMethod(resolved.profile) === 'oauth') {
             return human
                 ? `Вход завершён или отозван. Войдите заново: pachca auth login${flag}`
@@ -323,6 +352,9 @@ export class BaseCommand extends Command {
         if (err instanceof ApiError && err.details.type === 'PACHCA_SCOPE_ERROR') {
             this.reportScopeError(err);
         }
+        if (err instanceof ApiError && err.details.code === 403 && err.details.message === 'role_forbidden') {
+            this.reportRoleRefusal(err);
+        }
         if (err instanceof ApiError) {
             if (err.details.code === 401 && !err.details.hint) {
                 err.details.hint = this.reloginHint();

package/dist/client.js

@@ -57,7 +57,8 @@ function maskToken(token) {
 export function formatDryRun(opts, isJson) {
     const url = buildUrl(opts.path, opts.query);
     const headers = {
-        Authorization: `Bearer ${maskToken(opts.token)}`,
+        // The real request carries the token; the preview never shows it, and works without one.
+        ...(opts.noAuth ? {} : { Authorization: `Bearer ${maskToken(opts.token)}` }),
         ...(opts.body ? { 'Content-Type': 'application/json' } : {}),
         ...opts.headers,
     };

package/dist/commands/api.js

@@ -4,10 +4,10 @@ import { BaseCommand } from '../base-command.js';
 import { outputError } from '../output.js';
 import { buildListRows, detectIntrospectMode, positionals, findEndpoint, renderIntrospect, } from '../api-introspect.js';
 export default class Api extends BaseCommand {
-    static description = 'Произвольный запрос к API. Список и справка: `api ls` (список эндпоинтов), `api <МЕТОД> <путь> --describe` / `--spec` / `--docs`';
+    static description = 'Произвольный запрос к API. Список и справка: `api ls` (список методов), `api <МЕТОД> <путь> --describe` / `--spec` / `--docs`';
     static examples = [
         '<%= config.bin %> api GET /messages --query chat_id=123',
-        '<%= config.bin %> api POST /messages -F message[chat_id]=12345 -f message[content]="Привет"',
+        "<%= config.bin %> api POST /messages -F 'message[entity_id]=12345' -f 'message[content]=Привет'",
         '<%= config.bin %> api POST /messages --input payload.json',
         `<%= config.bin %> api POST /messages --data '{"message":{"entity_id":123,"content":"Привет"}}'`,
         '<%= config.bin %> api GET /profile -o yaml',
@@ -195,7 +195,7 @@ export default class Api extends BaseCommand {
         const entry = findEndpoint(entries, method, path);
         if (!entry) {
             outputError({
-                error: `Эндпоинт не найден: ${method.toUpperCase()} ${path}. Список: pachca api ls`,
+                error: `Метод не найден: ${method.toUpperCase()} ${path}. Список: pachca api ls`,
                 type: 'PACHCA_NOT_FOUND_ERROR',
                 code: null,
             }, errFormat);

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/bots/create.js

@@ -28,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/list-company.js

@@ -34,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'],
@@ -49,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)
@@ -59,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

@@ -30,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,
@@ -44,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)
@@ -54,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-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

@@ -33,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'],
@@ -48,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)
@@ -58,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/update.js

@@ -1,6 +1,7 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
+import { nullableString } from '../../lib/flags.js';
 export default class BotsUpdate extends BaseCommand {
     static description = "Редактирование бота";
     static scope = "bots:write";
@@ -31,7 +32,7 @@ export default class BotsUpdate extends BaseCommand {
             description: "Условие срабатывания исходящего вебхука",
         }),
         'commands': Flags.string({
-            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Событие о сообщении приходит боту, когда первое слово текста совпадает с одной из команд целиком, с учётом регистра. Команду можно задать и без слэша в начале. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
         }),
         'scopes': Flags.string({
             description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию. Боту доступны не все скоупы: часть из них разрешена только пользовательским ролям, и попытка назначить такой скоуп возвращает `400`. Служебные значения `bot` и `all` назначать нельзя.",
@@ -67,8 +68,8 @@ export default class BotsUpdate extends BaseCommand {
             description: "Ограничивает бота одной беседой или каналом: `true` — бота можно добавить только в один такой чат, `false` — в несколько. Личные чаты и треды в ограничение не входят.",
             allowNo: true,
         }),
-        'kind': Flags.string({
-            description: "Источник входящего вебхука. Если у бота входящего вебхука не было, он включается.",
+        'kind': nullableString({
+            description: "Источник входящего вебхука. Если у бота входящего вебхука не было, он включается. `null` удаляет входящий вебхук: адрес перестаёт работать, шаблон и настройки входящего вебхука сбрасываются, а при следующем включении бот получает новый адрес. Чтобы передать null, укажите `--kind null`.",
         }),
         'unfurl-domains': Flags.string({
             description: "Домены, ссылки на которые бот разворачивает, не больше 5. Работают вместе с событием `message_link_shared`. Список заменяется целиком.",

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

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

package/dist/commands/chats/list.js

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