@pachca/cli 2026.9.1 → 2026.10.1

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

@@ -46,7 +46,7 @@ export default class UsersCreate extends BaseCommand {
             allowNo: true,
         }),
         'list-tags': Flags.string({
-            description: "Массив тегов, привязываемых к сотруднику",
+            description: "Массив названий тегов, привязываемых к сотруднику. Значение, которое не является массивом непустых строк, игнорируется.",
         }),
         'chat-ids': Flags.string({
             description: "Идентификаторы чатов, в которые сотрудник будет добавлен сразу при создании. Для роли `guest` параметр обязателен и должен содержать ровно один активный чат.",

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,7 +7,16 @@
     "bots:get": "Информация о боте",
     "bots:update": "Редактирование бота",
     "bots:delete": "Удаление бота",
+    "bots:update-avatar": "Загрузка аватара бота",
+    "bots:remove-avatar": "Удаление аватара бота",
     "bots:recreate-token": "Ротация токена бота",
+    "bots:rotate-client-secret": "Ротация секрета клиента",
+    "bots:list-scopes": "Каталог прав бота",
+    "bots:list-tokens": "Список токенов бота",
+    "bots:create-token": "Новый токен бота",
+    "bots:update-token": "Изменение токена бота",
+    "bots:delete-token": "Удаление токена бота",
+    "bots:reissue-token": "Перевыпуск токена бота",
     "chats:create": "Новый чат",
     "chats:list": "Список чатов",
     "chats:request-export": "Экспорт сообщений",
@@ -15,14 +24,17 @@
     "chats:get": "Информация о чате",
     "chats:update": "Редактирование чата",
     "chats:archive": "Архивация чата",
+    "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": "Список ботов пространства",
     "chats:list-company": "Список чатов пространства",
     "custom-properties:list": "Список дополнительных полей",
@@ -84,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": "получить профиль, мой профиль, установить свой статус",

package/dist/data/changelog.json

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