@pachca/cli 2026.10.0 → 2026.10.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2026.10.2  (21 октября 2026)
+
+- **Добавлено** (security list): Флаг `--event-key` принимает события входа по QR-коду: `login_grant_created`, `login_grant_approved` и `login_grant_denied`
+
+## 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): Новые команды — токены бота: у бота может быть несколько токенов, у каждого своё имя и права. Значение токена показывается один раз, при выпуске и перевыпуске.

package/README.md

@@ -85,6 +85,8 @@ 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` | Каталог прав бота |
@@ -95,7 +97,7 @@ pachca guide            # список всех сценариев
 | `pachca bots reissue-token` | Перевыпуск токена бота |
 | `pachca bots list-company` | Список ботов пространства |
 | `pachca bots list-events` | История событий |
-| `pachca bots remove-event` | Удаление события |
+| `pachca bots remove-event` | Удаление события истории |
 
 ### chats
 
@@ -119,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.
      */

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

@@ -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: "Название поля проверки для верификации входящего вебхука",

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-tokens.js

@@ -49,7 +49,7 @@ export default class BotsListTokens 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.js

@@ -4,7 +4,7 @@ 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";
@@ -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/remove-avatar.js

@@ -0,0 +1,42 @@
+// 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 BotsRemoveAvatar extends BaseCommand {
+    static description = "Удаление аватара бота";
+    static scope = "bots:write";
+    static apiMethod = "DELETE";
+    static apiPath = "/bots/{id}/avatar";
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор бота (pachca bots list)",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            description: 'Пропустить подтверждение',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsRemoveAvatar);
+        this.parsedFlags = flags;
+        if (!flags.force) {
+            if (!this.isInteractive()) {
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca bots remove-avatar <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}/avatar`,
+        });
+        this.success('Удалено');
+    }
+}

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

@@ -3,7 +3,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class BotsRemoveEvent extends BaseCommand {
-    static description = "Удаление события";
+    static description = "Удаление события истории";
     static examples = [
         "Обработка событий через историю (polling) — Удали обработанное событие:\n  $ pachca bots remove-event"
     ];

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

@@ -0,0 +1,51 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export default class BotsUpdateAvatar extends BaseCommand {
+    static description = "Загрузка аватара бота";
+    static scope = "bots:write";
+    static apiMethod = "PUT";
+    static apiPath = "/bots/{id}/avatar";
+    static defaultColumns = ["image_url"];
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор бота (pachca bots list)",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        file: Flags.string({
+            description: "Файл изображения для аватара",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsUpdateAvatar);
+        this.parsedFlags = flags;
+        let formData;
+        if (flags.file) {
+            formData = new FormData();
+            if (flags.file === '-') {
+                const chunks = [];
+                for await (const chunk of process.stdin)
+                    chunks.push(chunk);
+                const blob = new Blob([Buffer.concat(chunks)]);
+                formData.append('image', blob, 'stdin');
+            }
+            else {
+                const blob = new Blob([fs.readFileSync(flags.file)]);
+                formData.append('image', blob, path.basename(flags.file));
+            }
+        }
+        const { data } = await this.apiRequest({
+            method: 'PUT',
+            path: `/bots/${args.id}/avatar`,
+            formData,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/bots/update.js

@@ -30,7 +30,7 @@ export default class BotsUpdate extends BaseCommand {
             description: "URL исходящего вебхука",
         }),
         'events': Flags.string({
-            description: "События, на которые подписан бот",
+            description: "События, на которые подписан бот. Список заменяется целиком.",
         }),
         'trigger-on': Flags.string({
             description: "Условие срабатывания исходящего вебхука",
@@ -66,7 +66,7 @@ export default class BotsUpdate extends BaseCommand {
             description: "Кто может добавлять бота в чаты",
         }),
         'can-edit': Flags.string({
-            description: "Роли, которым, помимо создателя, разрешено редактировать настройки бота. Создатель может редактировать всегда. Пустой массив — редактировать может только создатель.",
+            description: "Роли, которым, помимо создателя, разрешено редактировать настройки бота. Создатель может редактировать всегда. Пустой массив — редактировать может только создатель. Список заменяется целиком.",
         }),
         'single-chat': Flags.boolean({
             description: "Ограничивает бота одной беседой или каналом: `true` — бота можно добавить только в один такой чат, `false` — в несколько. Личные чаты и треды в ограничение не входят.",
@@ -76,10 +76,10 @@ export default class BotsUpdate extends BaseCommand {
             description: "Источник входящего вебхука. Если у бота входящего вебхука не было, он включается.",
         }),
         'unfurl-domains': Flags.string({
-            description: "Домены, ссылки на которые бот разворачивает, не больше 5. Работают вместе с событием `message_link_shared`.",
+            description: "Домены, ссылки на которые бот разворачивает, не больше 5. Работают вместе с событием `message_link_shared`. Список заменяется целиком.",
         }),
         'oauth-client': Flags.string({
-            description: "Настройки авторизации от имени сотрудника. Если авторизация выключена, объект её включает, а `null` выключает: выданные сотрудниками авторизации отзываются, страница в витрине удаляется.",
+            description: "Настройки авторизации от имени сотрудника. Если авторизация выключена, объект её включает, а `null` выключает: выданные сотрудниками авторизации отзываются, страница в витрине удаляется, собственные токены бота продолжают работать.",
         }),
         'promo': Flags.string({
             description: "Страница бота в витрине. Доступна, только когда у бота включена авторизация.",

package/dist/commands/chats/create.js

@@ -17,7 +17,7 @@ export default class ChatsCreate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'name': Flags.string({
-            description: "Название (макс. 255 символов)",
+            description: "Название. Пустое название заменяется именем и фамилией владельца токена (у бота — его именем), а если их нет — никнеймом. (макс. 255 символов)",
         }),
         'member-ids': Flags.string({
             description: "Массив идентификаторов пользователей, которые станут участниками",
@@ -38,7 +38,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: "Название. Пустое название заменяется именем и фамилией владельца токена (у бота — его именем), а если их нет — никнеймом.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {
@@ -91,5 +91,6 @@ export default class ChatsCreate extends BaseCommand {
         const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
+        this.warnMetaList(responseBody.meta, "not_found_member_ids", "Не удалось добавить в чат", "Таких сотрудников нет в пространстве, либо они приостановлены или удалены.");
     }
 }

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

@@ -15,7 +15,7 @@ export default class ChatsDownloadExport extends BaseCommand {
     static apiPath = "/chats/exports/{id}";
     static args = {
         id: Args.integer({
-            description: "Идентификатор экспорта (pachca chats list)",
+            description: "Идентификатор экспорта: `export_id` из вебхука о готовом архиве или число из ссылки вида `/full_exports/{id}` в уведомлении в Пачке (pachca chats list)",
             required: true,
         }),
     };

package/dist/commands/chats/get.js

@@ -9,7 +9,7 @@ export default class ChatsGet extends BaseCommand {
     static defaultColumns = ["id", "name", "created_at", "owner_id", "channel"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор чата (pachca chats list)",
+            description: "Идентификатор чата: в ссылке веб-приложения это число из пути `/chats/{id}` (pachca chats list)",
             required: true,
         }),
     };

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

@@ -53,7 +53,7 @@ export default class ChatsListCompany 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/chats/list.js

@@ -86,7 +86,7 @@ export default class ChatsList 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/chats/mark-unread.js

@@ -8,7 +8,7 @@ export default class ChatsMarkUnread extends BaseCommand {
     static apiPath = "/chats/{id}/unread";
     static args = {
         id: Args.integer({
-            description: "Идентификатор чата или треда (pachca chats list)",
+            description: "Идентификатор чата (беседы, канала, личного чата или чата треда) (pachca chats list)",
             required: true,
         }),
     };

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

@@ -5,13 +5,14 @@ import * as clack from '@clack/prompts';
 export default class ChatsRequestExport extends BaseCommand {
     static description = "Экспорт сообщений";
     static examples = [
-        "Экспорт истории чата — Запроси экспорт:\n  $ pachca chats request-export"
+        "Экспорт истории чата — Запроси экспорт и возьми номер выгрузки из `data.id`:\n  $ pachca chats request-export"
     ];
     static hiddenAliases = ["common:request-export"];
     static scope = "chat_exports:write";
     static plan = "corporation";
     static apiMethod = "POST";
     static apiPath = "/chats/exports";
+    static defaultColumns = ["id"];
     static requiredFlags = ["start-at", "end-at"];
     static args = {};
     static flags = {
@@ -23,7 +24,7 @@ export default class ChatsRequestExport extends BaseCommand {
             description: "Дата окончания для экспорта в формате YYYY-MM-DD, включительно. Если прислать дату со временем, время молча отбрасывается.",
         }),
         'webhook-url': Flags.string({
-            description: "Адрес, на который придёт вебхук с номером готовой выгрузки. Без него узнать номер неоткуда: заказавший получит письмо и уведомление, а вызывающая программа — ничего.",
+            description: "Адрес, на который придёт вебхук с номером готовой выгрузки, когда архив будет собран. Номер приходит в поле `export_id`, а всё тело вебхука описано в разделе [Экспорт](https://dev.pachca.com/guides/export).",
         }),
         'chat-ids': Flags.string({
             description: "Массив идентификаторов чатов. Указывается, если нужно получить сообщения только некоторых чатов.",
@@ -79,6 +80,7 @@ export default class ChatsRequestExport extends BaseCommand {
             method: 'POST',
             path: '/chats/exports',
             body,
+            headers: { "Prefer": "return=representation" },
         });
         const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;

package/dist/commands/drafts/list.js

@@ -59,7 +59,7 @@ export default class DraftsList 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/files/direct-url.js

@@ -9,7 +9,7 @@ export default class FilesDirectUrl extends BaseCommand {
     static hiddenAliases = ["common:direct-url"];
     static apiMethod = "POST";
     static apiPath = "/direct_url";
-    static requiredFlags = ["content-disposition", "acl", "policy", "x-amz-credential", "x-amz-algorithm", "x-amz-date", "x-amz-signature", "key"];
+    static requiredFlags = ["content-disposition", "policy", "x-amz-credential", "x-amz-algorithm", "x-amz-date", "x-amz-signature", "key"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -21,7 +21,7 @@ export default class FilesDirectUrl extends BaseCommand {
             description: "Параметр Content-Disposition, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)",
         }),
         'acl': Flags.string({
-            description: "Параметр acl, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)",
+            description: "Параметр acl, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads). Передаётся, если пришёл в ответе.",
         }),
         'policy': Flags.string({
             description: "Параметр policy, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)",
@@ -41,6 +41,9 @@ export default class FilesDirectUrl extends BaseCommand {
         'key': Flags.string({
             description: "Параметр key, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)",
         }),
+        'bucket': Flags.string({
+            description: "Параметр bucket, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads). Передаётся, если пришёл в ответе.",
+        }),
         file: Flags.string({
             description: "Файл для загрузки",
         }),
@@ -50,7 +53,6 @@ export default class FilesDirectUrl extends BaseCommand {
         this.parsedFlags = flags;
         const missingRequired = [
             { flag: 'content-disposition', label: "Параметр Content-Disposition, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)", type: 'string' },
-            { flag: 'acl', label: "Параметр acl, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)", type: 'string' },
             { flag: 'policy', label: "Параметр policy, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)", type: 'string' },
             { flag: 'x-amz-credential', label: "Параметр x-amz-credential, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)", type: 'string' },
             { flag: 'x-amz-algorithm', label: "Параметр x-amz-algorithm, полученный в ответе на запрос [Получение подписи, ключа и других параметров](POST /uploads)", type: 'string' },
@@ -78,7 +80,7 @@ export default class FilesDirectUrl extends BaseCommand {
                 }
             }
             else {
-                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --content-disposition <string>, --acl <string>, --policy <string>, --x-amz-credential <string>, --x-amz-algorithm <string>, --x-amz-date <string>, --x-amz-signature <string>, --key <string>. pachca introspect files direct-url" });
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --content-disposition <string>, --policy <string>, --x-amz-credential <string>, --x-amz-algorithm <string>, --x-amz-date <string>, --x-amz-signature <string>, --key <string>. pachca introspect files direct-url" });
             }
         }
         let formData;
@@ -100,6 +102,8 @@ export default class FilesDirectUrl extends BaseCommand {
                 formData.append('x-amz-signature', String(flags['x-amz-signature']));
             if (flags['key'])
                 formData.append('key', String(flags['key']));
+            if (flags['bucket'])
+                formData.append('bucket', String(flags['bucket']));
             if (flags.file === '-') {
                 const chunks = [];
                 for await (const chunk of process.stdin)

package/dist/commands/group-tags/get.js

@@ -9,7 +9,7 @@ export default class GroupTagsGet extends BaseCommand {
     static defaultColumns = ["id", "name", "users_count"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор тега",
+            description: "Идентификатор тега: в ссылке веб-приложения это число из параметра `tag_id`",
             required: true,
         }),
     };

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

@@ -12,7 +12,7 @@ export default class GroupTagsListUsers extends BaseCommand {
     static defaultColumns = ["id", "title", "first_name", "last_name", "email"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор тега",
+            description: "Идентификатор тега: в ссылке веб-приложения это число из параметра `tag_id`",
             required: true,
         }),
     };
@@ -52,7 +52,7 @@ export default class GroupTagsListUsers 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/group-tags/list.js

@@ -38,7 +38,7 @@ export default class GroupTagsList extends BaseCommand {
             const seenCursors = new Set();
             while (pages < 500) {
                 const query = {
-                    names: flags['names']?.split(','),
+                    'names[]': flags['names']?.split(','),
                     limit: flags.limit,
                     cursor: nextCursor,
                 };
@@ -51,7 +51,7 @@ export default class GroupTagsList 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)
@@ -85,7 +85,7 @@ export default class GroupTagsList extends BaseCommand {
             method: 'GET',
             path: '/group_tags',
             query: {
-                names: flags['names']?.split(','),
+                'names[]': flags['names']?.split(','),
                 limit: flags.limit,
                 cursor: flags.cursor,
             },

package/dist/commands/members/add.js

@@ -3,7 +3,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersAdd extends BaseCommand {
-    static description = "Добавление пользователей";
+    static description = "Добавление участников";
     static examples = [
         "Подписаться на тред сообщения — Добавь бота в участники чата треда:\n  $ pachca members add",
         "Создать канал и пригласить участников — Или добавь участников позже:\n  $ pachca members add",
@@ -25,7 +25,7 @@ export default class MembersAdd extends BaseCommand {
             description: "Массив идентификаторов пользователей, которые станут участниками",
         }),
         'silent': Flags.boolean({
-            description: "Не создавать в чате системное сообщение о добавлении участника",
+            description: "При `true` в чат не приходит системное сообщение о добавлении, а добавленные сотрудники не получают письмо с приглашением. Сообщение бывает только в закрытой беседе, письмо — в беседах и каналах у тех, кто не отключил такие письма. В треде параметр ничего не меняет.",
             allowNo: true,
         }),
     };

package/dist/commands/members/list.js

@@ -20,7 +20,7 @@ export default class MembersList extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'role': Flags.string({
-            description: "Роль в чате",
+            description: "Роль в чате. В канале пишут создатель, админы и редакторы, а участник там — подписчик.",
             options: ["all", "owner", "admin", "editor", "member"],
             default: "all",
         }),
@@ -59,7 +59,7 @@ export default class MembersList 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/members/remove-group-tag.js

@@ -3,7 +3,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersRemoveGroupTag extends BaseCommand {
-    static description = "Исключение тега";
+    static description = "Исключение тега из чата";
     static scope = "chat_members:write";
     static apiMethod = "DELETE";
     static apiPath = "/chats/{id}/group_tags/{tag_id}";

package/dist/commands/members/remove.js

@@ -3,7 +3,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersRemove extends BaseCommand {
-    static description = "Исключение пользователя";
+    static description = "Исключение участника";
     static examples = [
         "Архивация и управление чатом — Удалить участника:\n  $ pachca members remove"
     ];

package/dist/commands/members/update.js

@@ -3,7 +3,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersUpdate extends BaseCommand {
-    static description = "Редактирование роли";
+    static description = "Редактирование роли участника";
     static examples = [
         "Архивация и управление чатом — Изменить роль участника:\n  $ pachca members update"
     ];