@pachca/cli 2026.10.0 → 2026.10.2

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`). У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. В пространстве с продвинутым шифрованием — до 27 000 байт.",
+            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: "Идентификатор сообщения, на которое вы отвечаете с цитатой. Ответить можно на сообщение в любом чате, в том числе в треде: ответ отправляют в тот же чат или тред, где лежит это сообщение, иначе запрос вернёт ошибку `422`. Чтобы написать в тред под сообщением, укажите `entity_type: \"thread\"` и идентификатор треда в `entity_id`.",
+            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`). У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов. В пространстве с продвинутым шифрованием — до 27 000 байт.", 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

@@ -24,7 +24,7 @@ export default class MessagesUpdate extends BaseCommand {
             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", "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"],
+            options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_2fa_disabled", "login_grant_created", "login_grant_approved", "login_grant_denied", "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/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

@@ -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/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)

package/dist/commands/upload.js

@@ -46,16 +46,19 @@ export default class Upload extends BaseCommand {
         }
         // Step 3: Replace ${filename} in key
         const key = params.key.replace('${filename}', fileName);
-        // Step 4: Build FormData
+        // Step 4: Build FormData. A workspace gets `acl` or `bucket`, depending on its storage
         const formData = new FormData();
         formData.append('Content-Disposition', params['Content-Disposition']);
-        formData.append('acl', params.acl);
+        if (params.acl !== undefined)
+            formData.append('acl', params.acl);
         formData.append('policy', params.policy);
         formData.append('x-amz-credential', params['x-amz-credential']);
         formData.append('x-amz-algorithm', params['x-amz-algorithm']);
         formData.append('x-amz-date', params['x-amz-date']);
         formData.append('x-amz-signature', params['x-amz-signature']);
         formData.append('key', key);
+        if (params.bucket !== undefined)
+            formData.append('bucket', params.bucket);
         formData.append('file', fileBlob, fileName);
         // Step 5: Upload to external URL (no auth)
         await this.apiRequest({

package/dist/commands/users/get.js

@@ -12,7 +12,7 @@ export default class UsersGet extends BaseCommand {
     static defaultColumns = ["id", "title", "first_name", "last_name", "email"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор пользователя (pachca users list)",
+            description: "Идентификатор пользователя. В ссылке веб-приложения это число из параметра `user_id`. Параметры `profile_id` и `user-id` называют сотрудника, которому ссылку отправили. (pachca users list)",
             required: true,
         }),
     };

package/dist/commands/users/list.js

@@ -53,7 +53,7 @@ export default class UsersList 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/users/update-status.js

@@ -1,7 +1,6 @@
 // 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 UsersUpdateStatus extends BaseCommand {
     static description = "Новый статус сотрудника";
     static examples = [
@@ -11,7 +10,6 @@ export default class UsersUpdateStatus extends BaseCommand {
     static apiMethod = "PUT";
     static apiPath = "/users/{user_id}/status";
     static defaultColumns = ["title", "emoji", "expires_at", "is_away"];
-    static requiredFlags = ["emoji", "title"];
     static args = {
         user_id: Args.integer({
             description: "Идентификатор пользователя (pachca users list)",
@@ -21,13 +19,13 @@ export default class UsersUpdateStatus extends BaseCommand {
     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: "Режим «Нет на месте»",
@@ -40,33 +38,6 @@ export default class UsersUpdateStatus extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(UsersUpdateStatus);
         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 users 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/users/update.js

@@ -32,7 +32,7 @@ export default class UsersUpdate extends BaseCommand {
             description: "Телефон (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Имя пользователя (макс. 255 символов)",
+            description: "Имя пользователя. Ник бота должен оканчиваться на `_bot` и быть уникальным в пространстве, иначе метод отвечает `422` с ошибкой на поле `nickname`: `invalid` или `already_exists`. Прежний ник бота проверяется, только когда его меняют. (макс. 255 символов)",
         }),
         'department': Flags.string({
             description: "Департамент (макс. 255 символов)",
@@ -48,7 +48,7 @@ export default class UsersUpdate extends BaseCommand {
             allowNo: true,
         }),
         'list-tags': Flags.string({
-            description: "Массив названий тегов, привязываемых к сотруднику. Список заменяет прежний целиком, пустой снимает все теги. Значение, которое не является массивом непустых строк, игнорируется: теги сотрудника не меняются.",
+            description: "Массив названий тегов, привязываемых к сотруднику. Список заменяет прежний целиком, пустой снимает все теги. Значение, которое не является массивом непустых строк, игнорируется: теги сотрудника не меняются. В тег можно добавить только бота, которого может добавить в чат любой сотрудник и у которого выключена настройка «Ограничить одним чатом». Если бот этим условиям не отвечает, а в списке есть тег, которого у него ещё нет, метод отвечает `422` на поле `group_tags` и ничего не меняет: с кодом `single_chat_bot_tag_denied`, когда бот ограничен одним чатом, и `restricted_bot_tag_denied`, когда добавлять его в чаты могут не все. Подробнее — в разделе [Бот в тегах](https://dev.pachca.com/guides/bots/settings#bot-v-tegah).",
         }),
         'custom-properties': Flags.string({
             description: "Задаваемые дополнительные поля",

package/dist/commands/views/open.js

@@ -26,7 +26,7 @@ export default class ViewsOpen extends BaseCommand {
             description: "Текст кнопки отправки формы (макс. 24 символов)",
         }),
         'blocks': Flags.string({
-            description: "Массив блоков представления",
+            description: "Массив блоков представления. Имена блоков (`name`) не повторяются, в select и radio заранее выбрано не больше одного варианта, а `min_length` поля ввода не больше его `max_length`.",
         }),
         'type': Flags.string({
             description: "Способ открытия представления",
@@ -47,7 +47,7 @@ export default class ViewsOpen extends BaseCommand {
         this.parsedFlags = flags;
         const missingRequired = [
             { flag: 'title', label: "Заголовок представления", type: 'string' },
-            { flag: 'blocks', label: "Массив блоков представления", type: 'string' },
+            { flag: 'blocks', label: "Массив блоков представления. Имена блоков (`name`) не повторяются, в select и radio заранее выбрано не больше одного варианта, а `min_length` поля ввода не больше его `max_length`.", type: 'string' },
             { flag: 'type', label: "Способ открытия представления", type: 'string' },
             { flag: 'trigger-id', label: "Уникальный идентификатор события (полученный, например, в исходящем вебхуке о нажатии кнопки)", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);

package/dist/data/alternatives.json

@@ -7,6 +7,8 @@
     "bots:get": "Информация о боте",
     "bots:update": "Редактирование бота",
     "bots:delete": "Удаление бота",
+    "bots:update-avatar": "Загрузка аватара бота",
+    "bots:remove-avatar": "Удаление аватара бота",
     "bots:recreate-token": "Ротация токена бота",
     "bots:rotate-client-secret": "Ротация секрета клиента",
     "bots:list-scopes": "Каталог прав бота",
@@ -25,12 +27,12 @@
     "chats:update-avatar": "Загрузка аватара чата",
     "chats:remove-avatar": "Удаление аватара чата",
     "members:add-group-tags": "Добавление тегов",
-    "members:remove-group-tag": "Исключение тега",
+    "members:remove-group-tag": "Исключение тега из чата",
     "members:leave": "Выход из чата",
     "members:list": "Список участников чата",
-    "members:add": "Добавление пользователей",
-    "members:remove": "Исключение пользователя",
-    "members:update": "Редактирование роли",
+    "members:add": "Добавление участников",
+    "members:remove": "Исключение участника",
+    "members:update": "Редактирование роли участника",
     "chats:unarchive": "Разархивация чата",
     "chats:mark-unread": "Отметка чата непрочитанным",
     "bots:list-company": "Список ботов пространства",
@@ -94,7 +96,7 @@
     "views:open": "Открытие представления",
     "views:submit-response": "Ответ на отправку формы",
     "bots:list-events": "История событий",
-    "bots:remove-event": "Удаление события",
+    "bots:remove-event": "Удаление события истории",
     "skill:pachca-users": "pachca-users",
     "skill:pachca-oauth": "pachca-oauth",
     "skill:pachca-profile": "получить профиль, мой профиль, установить свой статус",