@pachca/cli 2026.9.1 → 2026.10.1

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"
     ];

package/dist/commands/messages/create.js

@@ -13,7 +13,7 @@ export default class MessagesCreate extends BaseCommand {
     static apiMethod = "POST";
     static apiPath = "/messages";
     static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
-    static requiredFlags = ["entity-id", "content"];
+    static requiredFlags = ["entity-id"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -21,28 +21,28 @@ export default class MessagesCreate extends BaseCommand {
             description: "Тип сущности. Регистр значения не учитывается. Значение вне списка возвращает `400` с кодом `invalid`.",
         }),
         'entity-id': Flags.integer({
-            description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника. (pachca chats list | pachca users list)",
+            description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо пользователя. У треда их два: `id` треда указывают с `entity_type: \"thread\"`, а его `chat_id` — с `discussion`, как у любого чата. (pachca chats list | pachca users list)",
         }),
         'content': Flags.string({
-            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`).",
+            description: "Текст сообщения. Обязателен, если к сообщению не приложены файлы. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). `@all` упоминает всех участников чата, `@here` — тех, кто сейчас в сети, а `@` с названием тега без пробелов — сотрудников этого тега. Имя без `@` и упоминание внутри строчного кода или блока кода упоминанием не считаются. У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. В пространстве с продвинутым шифрованием — до 27 000 байт. Сообщение уходит под именем владельца токена, у бота — с бейджем «Бот».",
         }),
         'files': Flags.string({
             description: "Прикрепляемые файлы",
         }),
         'buttons': Flags.string({
-            description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке.",
+            description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке. Кнопки показываются под текстом и работают только у сообщений, отправленных токеном бота: нажатие на кнопку с `data` приходит событием `button_click` тому самому боту, а вместе с ним `trigger_id` — на открытие формы по нему есть 3 секунды, метод [Открытие представления](POST /views/open). Кнопка с `url` просто ведёт по ссылке и события не создаёт. Подробности — в разделе [Кнопки](https://dev.pachca.com/guides/buttons).",
         }),
         'parent-message-id': Flags.integer({
-            description: "Идентификатор сообщения, на которое отвечаете. Ответ появится прямо в ленте чата, а не в треде: для треда отправляйте сообщение с `entity_type: \"thread\"`.",
+            description: "Идентификатор сообщения, на которое вы отвечаете с цитатой. Ответить можно на сообщение в любом чате, в том числе в треде: ответ отправляют в тот же чат или тред, где лежит это сообщение, иначе запрос вернёт ошибку `422`. Чтобы написать в тред под сообщением, укажите `entity_type: \"thread\"` и `id` треда в `entity_id`.",
         }),
         'display-avatar-url': Flags.string({
             description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. (макс. 255 символов)",
         }),
         'display-name': Flags.string({
-            description: "Полное специальное имя отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. (макс. 255 символов)",
+            description: "Полное специальное имя отправителя для этого сообщения. Вместе с `display_avatar_url` бот подписывает сообщение чужим именем и аватаром, и только это сообщение. Бейдж «Бот» остаётся, а в профиле отправителя видно настоящего бота. Так показывают автора из другой системы, когда переносят в Пачку чужую переписку. С личным токеном поле недоступно, ответ `403`. Подробности — в разделе [Боты](https://dev.pachca.com/guides/bots/overview). (макс. 255 символов)",
         }),
         'skip-invite-mentions': Flags.boolean({
-            description: "Пропуск добавления упоминаемых пользователей в тред. Работает только при отправке сообщения в тред.",
+            description: "Пропуск добавления упомянутых сотрудников в тред. В треде упоминание работает ещё и как приглашение: упомянутого сотрудника, которого в треде нет, Пачка туда добавляет, и он получает доступ к треду и родительскому сообщению. В беседе и канале упоминание никого не добавляет, и этот параметр там ничего не меняет.",
             allowNo: true,
         }),
         'link-preview': Flags.boolean({
@@ -62,8 +62,7 @@ export default class MessagesCreate extends BaseCommand {
             flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
         }
         const missingRequired = [
-            { flag: 'entity-id', label: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника.", type: 'integer' },
-            { flag: 'content', label: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`).", type: 'string' },
+            { flag: 'entity-id', label: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо пользователя. У треда их два: `id` треда указывают с `entity_type: \"thread\"`, а его `chat_id` — с `discussion`, как у любого чата.", type: 'integer' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {
@@ -85,7 +84,7 @@ export default class MessagesCreate extends BaseCommand {
                 }
             }
             else {
-                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --entity-id <integer>, --content <string>. pachca introspect messages create" });
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --entity-id <integer>. pachca introspect messages create" });
             }
         }
         const validationErrors = [];

package/dist/commands/messages/get.js

@@ -14,7 +14,7 @@ export default class MessagesGet extends BaseCommand {
     static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор сообщения (pachca messages list)",
+            description: "Идентификатор сообщения. Ссылка веб-приложения указывает на сообщение параметром `sidebar_message`, а без него — параметром `message`. Число из `thread_message_id` — сообщение, под которым висит тред. (pachca messages list)",
             required: true,
         }),
     };

package/dist/commands/messages/list.js

@@ -100,7 +100,7 @@ export default class MessagesList 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/messages/update.js

@@ -21,10 +21,10 @@ export default class MessagesUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'content': Flags.string({
-            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`).",
+            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. В пространстве с продвинутым шифрованием — до 27 000 байт.",
         }),
         'files': Flags.string({
-            description: "Прикрепляемые файлы",
+            description: "Прикрепляемые файлы. Переданный набор заменяет прежний: чтобы оставить уже приложенный файл, передайте его снова с тем же `key`.",
         }),
         'buttons': Flags.string({
             description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке. Для удаления кнопок пришлите пустой массив.",

package/dist/commands/profile/update-status.js

@@ -1,7 +1,6 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import * as clack from '@clack/prompts';
 export default class ProfileUpdateStatus extends BaseCommand {
     static description = "Новый свой статус";
     static examples = [
@@ -11,18 +10,17 @@ export default class ProfileUpdateStatus extends BaseCommand {
     static apiMethod = "PUT";
     static apiPath = "/profile/status";
     static defaultColumns = ["title", "emoji", "expires_at", "is_away"];
-    static requiredFlags = ["emoji", "title"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
         'emoji': Flags.string({
-            description: "Emoji символ статуса",
+            description: "Emoji символ статуса. Обязателен, если статуса ещё нет.",
         }),
         'title': Flags.string({
-            description: "Текст статуса (макс. 50 символов)",
+            description: "Текст статуса. Обязателен, если статуса ещё нет. (макс. 50 символов)",
         }),
         'expires-at': Flags.string({
-            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Сюда идёт срок, названный словами: «до трёх» это значение поля, а не часть подписи.",
+            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC.",
         }),
         'is-away': Flags.boolean({
             description: "Режим «Нет на месте»",
@@ -35,33 +33,6 @@ export default class ProfileUpdateStatus extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(ProfileUpdateStatus);
         this.parsedFlags = flags;
-        const missingRequired = [
-            { flag: 'emoji', label: "Emoji символ статуса", type: 'string' },
-            { flag: 'title', 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: "Обязательные: --emoji <string>, --title <string>. pachca introspect profile update-status" });
-            }
-        }
         const validationErrors = [];
         if (flags['title'] && String(flags['title']).length > 50) {
             validationErrors.push({ message: `--title: максимум 50 символов (передано: ${String(flags['title']).length})`, flag: 'title' });

package/dist/commands/reactions/list.js

@@ -49,7 +49,7 @@ export default class ReactionsList 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/read-member/list-readers.js

@@ -51,7 +51,7 @@ export default class ReadMemberListReaders 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/search/list-chats.js

@@ -16,7 +16,7 @@ export default class SearchListChats extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса",
+            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",
@@ -81,7 +81,7 @@ export default class SearchListChats 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/search/list-messages.js

@@ -14,7 +14,7 @@ export default class SearchListMessages extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса",
+            description: "Текст поискового запроса. Без него сообщения отбираются только фильтрами. Запрос длиннее 500 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",
@@ -68,8 +68,8 @@ export default class SearchListMessages extends BaseCommand {
                     sort: flags['sort'],
                     'created_from': flags['created-from'],
                     'created_to': flags['created-to'],
-                    'chat_ids': flags['chat-ids']?.split(','),
-                    'user_ids': flags['user-ids']?.split(','),
+                    'chat_ids[]': flags['chat-ids']?.split(','),
+                    'user_ids[]': flags['user-ids']?.split(','),
                     active: flags['active'],
                     limit: flags.limit,
                     cursor: nextCursor,
@@ -83,7 +83,7 @@ export default class SearchListMessages 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)
@@ -122,8 +122,8 @@ export default class SearchListMessages extends BaseCommand {
                 sort: flags['sort'],
                 'created_from': flags['created-from'],
                 'created_to': flags['created-to'],
-                'chat_ids': flags['chat-ids']?.split(','),
-                'user_ids': flags['user-ids']?.split(','),
+                'chat_ids[]': flags['chat-ids']?.split(','),
+                'user_ids[]': flags['user-ids']?.split(','),
                 active: flags['active'],
                 limit: flags.limit,
                 cursor: flags.cursor,

package/dist/commands/search/list-users.js

@@ -16,7 +16,7 @@ export default class SearchListUsers extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса",
+            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
         }),
         'sort': Flags.string({
             description: "Сортировка результатов",
@@ -62,7 +62,7 @@ export default class SearchListUsers extends BaseCommand {
                     order: flags['order'],
                     'created_from': flags['created-from'],
                     'created_to': flags['created-to'],
-                    'company_roles': flags['company-roles']?.split(','),
+                    'company_roles[]': flags['company-roles']?.split(','),
                     limit: flags.limit,
                     cursor: nextCursor,
                 };
@@ -75,7 +75,7 @@ export default class SearchListUsers 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)
@@ -114,7 +114,7 @@ export default class SearchListUsers extends BaseCommand {
                 order: flags['order'],
                 'created_from': flags['created-from'],
                 'created_to': flags['created-to'],
-                'company_roles': flags['company-roles']?.split(','),
+                'company_roles[]': flags['company-roles']?.split(','),
                 limit: flags.limit,
                 cursor: flags.cursor,
             },

package/dist/commands/security/list.js

@@ -24,7 +24,7 @@ export default class SecurityList extends BaseCommand {
         }),
         'event-key': Flags.string({
             description: "Фильтр по конкретному типу события",
-            options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_2fa_disabled", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "company_chats_accessed", "company_bots_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated", "bot_deleted", "bot_oauth_client_updated", "oauth_authorization_granted", "oauth_authorization_revoked", "oauth_device_authorization_approved", "oauth_device_authorization_denied", "video_call_started", "video_call_finished", "video_call_recording_ready", "exchange_disabled"],
+            options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_2fa_disabled", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "company_chats_accessed", "company_bots_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated", "bot_deleted", "bot_oauth_client_updated", "bot_oauth_client_disabled", "bot_oauth_client_secret_rotated", "bot_oauth_client_secret_issued", "bot_token_created", "bot_token_updated", "bot_token_reissued", "bot_token_deleted", "oauth_authorization_granted", "oauth_authorization_revoked", "oauth_token_revoked", "oauth_device_authorization_approved", "oauth_device_authorization_denied", "video_call_started", "video_call_finished", "video_call_recording_ready", "exchange_disabled"],
         }),
         'actor-id': Flags.string({
             description: "Идентификатор пользователя, выполнившего действие",
@@ -79,7 +79,7 @@ export default class SecurityList 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/tasks/create.js

@@ -21,7 +21,7 @@ export default class TasksCreate extends BaseCommand {
             description: "Тип",
         }),
         'content': Flags.string({
-            description: "Описание (по умолчанию — название типа)",
+            description: "Описание, по умолчанию — название типа. До 40 000 байт в UTF-8.",
         }),
         'due-at': Flags.string({
             description: "Срок выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Секунды отбрасываются: срок встаёт на начало минуты. Исключение — ровно 23:59:59: такое напоминание создаётся на весь день, без указания времени.",

package/dist/commands/tasks/get.js

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

package/dist/commands/tasks/list.js

@@ -20,7 +20,7 @@ export default class TasksList extends BaseCommand {
             options: ["done", "undone"],
         }),
         'chat-ids': Flags.string({
-            description: "Фильтр по чатам, к которым привязаны напоминания. Доступными считаются чаты, где вы состоите участником, открытые беседы и каналы пространства, а также треды, доступные вам по родительскому чату. Остальные переданные идентификаторы игнорируются без ошибки. Не более 100 идентификаторов." + " (через запятую)",
+            description: "Фильтр по чатам, к которым привязаны напоминания. Доступными считаются чаты, где вы состоите участником, открытые беседы и каналы пространства, а также треды, доступные вам по родительскому чату. Мульти-гостю открытые беседы и каналы доступны, только если он в них участник. Остальные переданные идентификаторы игнорируются без ошибки. Не более 100 идентификаторов." + " (через запятую)",
         }),
         'performer-ids': Flags.string({
             description: "Фильтр по ответственным за напоминание. Не более 100 идентификаторов." + " (через запятую)",
@@ -51,8 +51,8 @@ export default class TasksList extends BaseCommand {
             while (pages < 500) {
                 const query = {
                     status: flags['status'],
-                    'chat_ids': flags['chat-ids']?.split(','),
-                    'performer_ids': flags['performer-ids']?.split(','),
+                    'chat_ids[]': flags['chat-ids']?.split(','),
+                    'performer_ids[]': flags['performer-ids']?.split(','),
                     'author_id': flags['author-id'],
                     limit: flags.limit,
                     cursor: nextCursor,
@@ -66,7 +66,7 @@ export default class TasksList 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)
@@ -101,8 +101,8 @@ export default class TasksList extends BaseCommand {
             path: '/tasks',
             query: {
                 status: flags['status'],
-                'chat_ids': flags['chat-ids']?.split(','),
-                'performer_ids': flags['performer-ids']?.split(','),
+                'chat_ids[]': flags['chat-ids']?.split(','),
+                'performer_ids[]': flags['performer-ids']?.split(','),
                 'author_id': flags['author-id'],
                 limit: flags.limit,
                 cursor: flags.cursor,

package/dist/commands/tasks/update.js

@@ -23,7 +23,7 @@ export default class TasksUpdate extends BaseCommand {
             description: "Тип",
         }),
         'content': Flags.string({
-            description: "Описание",
+            description: "Описание. До 40 000 байт в UTF-8.",
         }),
         'due-at': Flags.string({
             description: "Срок выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Секунды отбрасываются: срок встаёт на начало минуты. Исключение — ровно 23:59:59: такое напоминание создаётся на весь день, без указания времени.",

package/dist/commands/threads/get.js

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

package/dist/commands/threads/list.js

@@ -5,7 +5,7 @@ export default class ThreadsList extends BaseCommand {
     static description = "Список тредов";
     static examples = [
         "Получить список активных тредов за период — Запроси список тредов с фильтром по времени последнего сообщения и нужным `--limit`:\n  $ pachca threads list",
-        "Получить список активных тредов за период — Если в ответе `meta.paginate.next_page` — пройди по страницам через `--cursor`:\n  $ pachca threads list"
+        "Получить список активных тредов за период — Пока `meta.paginate.has_next` равен `true`, бери следующую страницу через `--cursor=<next_page>`:\n  $ pachca threads list"
     ];
     static scope = "threads:read";
     static apiMethod = "GET";
@@ -56,7 +56,7 @@ export default class ThreadsList 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)