@pachca/cli 2026.10.4 → 2026.11.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2026.11.0  (4 ноября 2026)
+
+- **Изменено** (tasks create): Работает без `--kind` и не спрашивает тип в терминале: по умолчанию создаётся простое напоминание
+- **Изменено** (reactions remove): Снимает реакцию по `--name` без `--code`
+- **Добавлено** (profile update-status, users update-status): `--expires-at null` убирает срок статуса, а `--away-message null` убирает текст «Нет на месте»
+- **Добавлено** (bots create, bots update, bots update-webhook, messages update, reactions add, users create, users update): Длина значений проверяется до запроса: `--outgoing-url`, `--challenge-key`, `--display-avatar-url`, `--display-name` и `--title` до 255 символов, а `--code` у `reactions add` до 16
+- **Добавлено**: В выводе команд с сообщениями и черновиками есть поле `voice_content.transcript_status`: статус расшифровки голосового сообщения
+- **Изменено** (api): Справка `--docs` и схема `--spec` показывают необязательными поля деталей журнала аудита, которых нет в записи без значения, а список скоупов без `files:write`, `webhooks:read` и `webhooks:write`
+- **Изменено**: Справка команд следует уточнённым описаниям API: ник сотрудника и бота, пустой бот, события, команды и `--ignore-self-messages` бота, поиск сотрудников и ботов, длина поискового запроса, подпись сообщения бота, название чата, упоминания в черновике, текст «Нет на месте», смена почты, приостановка владельца, `--actor-id` у `pachca security list` и `--done-at` у `pachca tasks update`
+
 ## 2026.10.4  (31 октября 2026)
 
 - **Исправлено** (api): Справка `--docs` и схема `--spec` показывают `dlp_rule_id` в деталях события `dlp_violation_detected` строкой, как его отдаёт API

package/dist/commands/bots/create.js

@@ -16,19 +16,19 @@ export default class BotsCreate extends BaseCommand {
             description: "Имя бота (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Никнейм бота. Должен заканчиваться на `_bot`. (макс. 255 символов)",
+            description: "Никнейм бота: латинские буквы, цифры и `_`, в конце `_bot`, свободный в пространстве. Ник не по формату отвечает `400` на поле `bot.nickname` с кодом `invalid`, а занятый ник — с кодом `taken`. Без поля ник собирается из имени в латинской транслитерации с `_bot` в конце, а если такой ник занят, с `_2_bot`, `_3_bot` и далее. (макс. 255 символов)",
         }),
         'outgoing-url': Flags.string({
-            description: "URL исходящего вебхука",
+            description: "URL исходящего вебхука (макс. 255 символов)",
         }),
         'events': Flags.string({
-            description: "События, на которые подписан бот",
+            description: "События, на которые подписан бот. Без поля бот подписан на `message_new`.",
         }),
         'trigger-on': Flags.string({
             description: "Условие срабатывания исходящего вебхука",
         }),
         'commands': Flags.string({
-            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Событие о сообщении приходит боту, когда первое слово текста совпадает с одной из команд целиком, с учётом регистра. Команду можно задать и без слэша в начале. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Событие о сообщении приходит боту, когда первое слово текста совпадает с одной из команд целиком, с учётом регистра. Команду можно задать и без слэша в начале. Суммарная длина команд вместе с разделителями `, ` (запятая и пробел) не должна превышать 255 символов.",
         }),
         'scopes': Flags.string({
             description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию. Боту доступны не все скоупы: часть из них разрешена только пользовательским ролям, и попытка назначить такой скоуп возвращает `400`. Служебные значения `bot` и `all` назначать нельзя.",
@@ -40,14 +40,14 @@ export default class BotsCreate extends BaseCommand {
             description: "Шаблонизатор для обработки шаблона входящего вебхука. Без этого поля бот получает `liquid`, а пустой бот (`empty: true`) — `mustache`.",
         }),
         'challenge-key': Flags.string({
-            description: "Название поля проверки для верификации входящего вебхука",
+            description: "Название поля проверки для верификации входящего вебхука (макс. 255 символов)",
         }),
         'link-preview-enabled': Flags.boolean({
             description: "Показывать превью ссылок в сообщениях входящего вебхука",
             allowNo: true,
         }),
         'ignore-self-messages': Flags.boolean({
-            description: "Не присылать боту события о его собственных сообщениях и реакциях",
+            description: "Не присылать боту события о сообщениях, которые он отправил сам, и о реакциях на эти сообщения, кто бы их ни поставил или снял. Нажатия кнопок приходят всегда.",
             allowNo: true,
         }),
         'events-history-enabled': Flags.boolean({
@@ -71,7 +71,7 @@ export default class BotsCreate extends BaseCommand {
             description: "Домены, ссылки на которые бот разворачивает, не больше 5. Работают вместе с событием `message_link_shared`.",
         }),
         'empty': Flags.boolean({
-            description: "Создать пустого бота: без токена и без входящего вебхука. Без этого поля бот создаётся с входящим вебхуком в своём формате, а его токен приходит в `access_token`.",
+            description: "Создать пустого бота: без входящего вебхука и, если не переданы скоупы, без токена. Без этого поля бот создаётся с входящим вебхуком в своём формате, а его токен приходит в `access_token`.",
             allowNo: true,
         }),
         'oauth-client': Flags.string({
@@ -117,6 +117,12 @@ export default class BotsCreate extends BaseCommand {
         if (flags['nickname'] && String(flags['nickname']).length > 255) {
             validationErrors.push({ message: `--nickname: максимум 255 символов (передано: ${String(flags['nickname']).length})`, flag: 'nickname' });
         }
+        if (flags['outgoing-url'] && String(flags['outgoing-url']).length > 255) {
+            validationErrors.push({ message: `--outgoing-url: максимум 255 символов (передано: ${String(flags['outgoing-url']).length})`, flag: 'outgoing-url' });
+        }
+        if (flags['challenge-key'] && String(flags['challenge-key']).length > 255) {
+            validationErrors.push({ message: `--challenge-key: максимум 255 символов (передано: ${String(flags['challenge-key']).length})`, flag: 'challenge-key' });
+        }
         if (validationErrors.length > 0) {
             this.validationError(validationErrors);
         }

package/dist/commands/bots/list.js

@@ -11,7 +11,7 @@ export default class BotsList extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Поисковая фраза для фильтрации ботов по имени",
+            description: "Поисковая фраза для фильтрации ботов по имени или нику",
         }),
         limit: Flags.integer({
             description: 'Количество результатов на страницу',

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

@@ -13,7 +13,7 @@ export default class BotsUpdateWebhook extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'outgoing-url': Flags.string({
-            description: "URL исходящего вебхука. Пустая строка отключает вебхук.",
+            description: "URL исходящего вебхука. Пустая строка отключает вебхук. (макс. 255 символов)",
         }),
     };
     async run() {
@@ -45,6 +45,13 @@ export default class BotsUpdateWebhook extends BaseCommand {
                 this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --outgoing-url <string>. pachca introspect bots update-webhook" });
             }
         }
+        const validationErrors = [];
+        if (flags['outgoing-url'] && String(flags['outgoing-url']).length > 255) {
+            validationErrors.push({ message: `--outgoing-url: максимум 255 символов (передано: ${String(flags['outgoing-url']).length})`, flag: 'outgoing-url' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
         const body = { webhook: {
                 outgoing_url: flags['outgoing-url'],
             } };

package/dist/commands/bots/update.js

@@ -20,10 +20,10 @@ export default class BotsUpdate extends BaseCommand {
             description: "Имя бота (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Никнейм бота. Должен заканчиваться на `_bot`. (макс. 255 символов)",
+            description: "Никнейм бота: латинские буквы, цифры и `_`, в конце `_bot`, свободный в пространстве. Ник не по формату отвечает `400` на поле `bot.nickname` с кодом `invalid`, а занятый ник — с кодом `taken`. (макс. 255 символов)",
         }),
         'outgoing-url': Flags.string({
-            description: "URL исходящего вебхука",
+            description: "URL исходящего вебхука (макс. 255 символов)",
         }),
         'events': Flags.string({
             description: "События, на которые подписан бот. Список заменяется целиком.",
@@ -32,7 +32,7 @@ export default class BotsUpdate extends BaseCommand {
             description: "Условие срабатывания исходящего вебхука",
         }),
         'commands': Flags.string({
-            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Событие о сообщении приходит боту, когда первое слово текста совпадает с одной из команд целиком, с учётом регистра. Команду можно задать и без слэша в начале. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Событие о сообщении приходит боту, когда первое слово текста совпадает с одной из команд целиком, с учётом регистра. Команду можно задать и без слэша в начале. Суммарная длина команд вместе с разделителями `, ` (запятая и пробел) не должна превышать 255 символов.",
         }),
         'scopes': Flags.string({
             description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию. Боту доступны не все скоупы: часть из них разрешена только пользовательским ролям, и попытка назначить такой скоуп возвращает `400`. Служебные значения `bot` и `all` назначать нельзя.",
@@ -44,14 +44,14 @@ export default class BotsUpdate extends BaseCommand {
             description: "Шаблонизатор для обработки шаблона входящего вебхука",
         }),
         'challenge-key': Flags.string({
-            description: "Название поля проверки для верификации входящего вебхука",
+            description: "Название поля проверки для верификации входящего вебхука (макс. 255 символов)",
         }),
         'link-preview-enabled': Flags.boolean({
             description: "Показывать превью ссылок в сообщениях входящего вебхука",
             allowNo: true,
         }),
         'ignore-self-messages': Flags.boolean({
-            description: "Не присылать боту события о его собственных сообщениях и реакциях",
+            description: "Не присылать боту события о сообщениях, которые он отправил сам, и о реакциях на эти сообщения, кто бы их ни поставил или снял. Нажатия кнопок приходят всегда.",
             allowNo: true,
         }),
         'events-history-enabled': Flags.boolean({
@@ -91,6 +91,12 @@ export default class BotsUpdate extends BaseCommand {
         if (flags['nickname'] && String(flags['nickname']).length > 255) {
             validationErrors.push({ message: `--nickname: максимум 255 символов (передано: ${String(flags['nickname']).length})`, flag: 'nickname' });
         }
+        if (flags['outgoing-url'] && String(flags['outgoing-url']).length > 255) {
+            validationErrors.push({ message: `--outgoing-url: максимум 255 символов (передано: ${String(flags['outgoing-url']).length})`, flag: 'outgoing-url' });
+        }
+        if (flags['challenge-key'] && String(flags['challenge-key']).length > 255) {
+            validationErrors.push({ message: `--challenge-key: максимум 255 символов (передано: ${String(flags['challenge-key']).length})`, flag: 'challenge-key' });
+        }
         if (validationErrors.length > 0) {
             this.validationError(validationErrors);
         }

package/dist/commands/chats/update.js

@@ -16,7 +16,7 @@ export default class ChatsUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'name': Flags.string({
-            description: "Название (макс. 255 символов)",
+            description: "Название беседы или канала. Пустое название или название из одних пробелов отвечает `400` с кодом `blank`. (макс. 255 символов)",
         }),
         'public': Flags.boolean({
             description: "Открытый доступ",

package/dist/commands/drafts/create.js

@@ -20,7 +20,7 @@ export default class DraftsCreate extends BaseCommand {
             description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника (pachca chats list | pachca users list)",
         }),
         'content': Flags.string({
-            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. До 40 000 байт в UTF-8.",
+            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. Поддерживает упоминания, как текст в методе [Новое сообщение](POST /messages). `<@user_id>` остаётся в тексте черновика как передан, а при отправке становится `@nickname`. До 40 000 байт в UTF-8.",
         }),
         'parent-message-id': nullableInteger({
             description: "Идентификатор сообщения, ответом на которое уйдёт черновик. Сообщение должно быть в том же чате.",

package/dist/commands/drafts/update.js

@@ -17,7 +17,7 @@ export default class DraftsUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'content': Flags.string({
-            description: "Текст черновика. До 40 000 байт в UTF-8.",
+            description: "Текст черновика. Поддерживает упоминания, как текст в методе [Новое сообщение](POST /messages). `<@user_id>` остаётся в тексте черновика как передан, а при отправке становится `@nickname`. До 40 000 байт в UTF-8.",
         }),
         'parent-message-id': nullableInteger({
             description: "Идентификатор сообщения, ответом на которое уйдёт черновик. `null` снимает ответ. Чтобы передать null, укажите `--parent-message-id null`.",

package/dist/commands/messages/create.js

@@ -31,10 +31,10 @@ export default class MessagesCreate extends BaseCommand {
             description: "Идентификатор сообщения, на которое вы отвечаете с цитатой. Ответить можно на сообщение в любом чате, в том числе в треде: ответ отправляют в тот же чат или тред, где лежит это сообщение, иначе запрос вернёт ошибку `422`. Чтобы написать в тред под сообщением, укажите `entity_type: \"thread\"` и `id` треда в `entity_id`.",
         }),
         'display-avatar-url': Flags.string({
-            description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. (макс. 255 символов)",
+            description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. До 255 байт в UTF-8. (макс. 255 символов)",
         }),
         'display-name': Flags.string({
-            description: "Полное специальное имя отправителя для этого сообщения. Вместе с `display_avatar_url` бот подписывает сообщение чужим именем и аватаром, и только это сообщение. Бейдж «Бот» остаётся, а в профиле отправителя видно настоящего бота. Так показывают автора из другой системы, когда переносят в Пачку чужую переписку. С личным токеном поле недоступно, ответ `403`. Подробности — в разделе [Боты](https://dev.pachca.com/guides/bots/overview). (макс. 255 символов)",
+            description: "Полное специальное имя отправителя для этого сообщения. Вместе с `display_avatar_url` бот подписывает сообщение чужим именем и аватаром, и только это сообщение. Бейдж «Бот» остаётся, а в профиле отправителя видно настоящего бота. Так показывают автора из другой системы, когда переносят в Пачку чужую переписку. С личным токеном поле недоступно, ответ `403`. До 255 байт в UTF-8, для кириллицы это около 127 символов. Подробности — в разделе [Боты](https://dev.pachca.com/guides/bots/overview). (макс. 255 символов)",
         }),
         'skip-invite-mentions': Flags.boolean({
             description: "Пропуск добавления упомянутых сотрудников в тред. В треде упоминание работает ещё и как приглашение: упомянутого сотрудника, которого в треде нет, Пачка туда добавляет, и он получает доступ к треду и родительскому сообщению. Если в пространстве включена настройка «Использовать сквозные треды» (так по умолчанию), упоминание добавляет и сотрудника не из родительского чата, а с `true` в этом поле упоминание никого не добавляет, и тот, кого в треде нет, не получает и уведомления. Упоминание от гостя или мульти-гостя при этом добавляет только тех, с кем у автора есть общий чат. Если настройка выключена, упоминание добавляет только участников родительского чата, и это поле ничего не меняет. В беседе и канале упоминание никого не добавляет, и этот параметр там ничего не меняет.",

package/dist/commands/messages/update.js

@@ -25,10 +25,10 @@ export default class MessagesUpdate extends BaseCommand {
             description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке. Для удаления кнопок пришлите пустой массив.",
         }),
         'display-avatar-url': Flags.string({
-            description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота.",
+            description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. До 255 байт в UTF-8. (макс. 255 символов)",
         }),
         'display-name': Flags.string({
-            description: "Полное специальное имя отправителя для этого сообщения. Использование этого поля возможно только с access_token бота.",
+            description: "Полное специальное имя отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. До 255 байт в UTF-8, для кириллицы это около 127 символов. (макс. 255 символов)",
         }),
     };
     async run() {
@@ -44,6 +44,16 @@ export default class MessagesUpdate extends BaseCommand {
             if (piped)
                 flags['content'] = piped;
         }
+        const validationErrors = [];
+        if (flags['display-avatar-url'] && String(flags['display-avatar-url']).length > 255) {
+            validationErrors.push({ message: `--display-avatar-url: максимум 255 символов (передано: ${String(flags['display-avatar-url']).length})`, flag: 'display-avatar-url' });
+        }
+        if (flags['display-name'] && String(flags['display-name']).length > 255) {
+            validationErrors.push({ message: `--display-name: максимум 255 символов (передано: ${String(flags['display-name']).length})`, flag: 'display-name' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
         const body = { message: {
                 content: flags['content'],
                 files: flags['files'] ? this.parseJSON(flags['files'], 'files') : undefined,

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

@@ -1,6 +1,7 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
+import { nullableString } from '../../lib/flags.js';
 export default class ProfileUpdateStatus extends BaseCommand {
     static description = "Новый свой статус";
     static scope = "profile_status:write";
@@ -16,15 +17,15 @@ export default class ProfileUpdateStatus extends BaseCommand {
         'title': Flags.string({
             description: "Текст статуса. Обязателен, если статуса ещё нет. (макс. 50 символов)",
         }),
-        'expires-at': Flags.string({
-            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC.",
+        'expires-at': nullableString({
+            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. `null` убирает срок: статус не снимется сам. Чтобы передать null, укажите `--expires-at null`.",
         }),
         'is-away': Flags.boolean({
             description: "Режим «Нет на месте»",
             allowNo: true,
         }),
-        'away-message': Flags.string({
-            description: "Текст сообщения при режиме «Нет на месте». Отображается в профиле и при личных сообщениях/упоминаниях. (макс. 1024 символов)",
+        'away-message': nullableString({
+            description: "Текст сообщения при режиме «Нет на месте». Отображается в профиле и при личных сообщениях/упоминаниях. Поддерживает Markdown и упоминания `@nickname` и `<@user_id>`, но сохраняется и возвращается обычным текстом: разметка убирается, а упоминание сотрудника заменяется на `@` с его именем и фамилией. Предел 1024 символа действует и на присланный текст, и на получившийся, сверх него ответ `400` с кодом `too_long`. `null` или пустая строка убирает текст. Чтобы передать null, укажите `--away-message null`. (макс. 1024 символов)",
         }),
     };
     async run() {

package/dist/commands/reactions/add.js

@@ -18,7 +18,7 @@ export default class ReactionsAdd extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'code': Flags.string({
-            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение: оно сохраняется как передано.",
+            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение до 16 символов: оно сохраняется как передано. (макс. 16 символов)",
         }),
         'name': Flags.string({
             description: "Имя кастомного эмодзи пространства. С ним реакцией ставится этот эмодзи, а если его в пространстве нет, ответ `404`.",
@@ -28,7 +28,7 @@ export default class ReactionsAdd extends BaseCommand {
         const { args, flags } = await this.parse(ReactionsAdd);
         this.parsedFlags = flags;
         const missingRequired = [
-            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение: оно сохраняется как передано.", type: 'string' },
+            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение до 16 символов: оно сохраняется как передано.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {
@@ -53,6 +53,13 @@ export default class ReactionsAdd extends BaseCommand {
                 this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --code <string>. pachca introspect reactions add" });
             }
         }
+        const validationErrors = [];
+        if (flags['code'] && String(flags['code']).length > 16) {
+            validationErrors.push({ message: `--code: максимум 16 символов (передано: ${String(flags['code']).length})`, flag: 'code' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
         const body = {
             code: flags['code'],
             name: flags['name'],

package/dist/commands/reactions/remove.js

@@ -7,7 +7,6 @@ export default class ReactionsRemove extends BaseCommand {
     static scope = "reactions:write";
     static apiMethod = "DELETE";
     static apiPath = "/messages/{id}/reactions";
-    static requiredFlags = ["code"];
     static args = {
         id: Args.integer({
             description: "Идентификатор сообщения",
@@ -17,7 +16,7 @@ export default class ReactionsRemove extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'code': Flags.string({
-            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.",
+            description: "Emoji символ реакции. Обязателен без `name`: нужен именно символ, текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` не используется.",
         }),
         'name': Flags.string({
             description: "Имя реакции, как в её поле `name`. С ним реакция ищется по имени, так снимается и кастомный эмодзи пространства.",
@@ -30,32 +29,6 @@ export default class ReactionsRemove extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(ReactionsRemove);
         this.parsedFlags = flags;
-        const missingRequired = [
-            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.", 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: "Обязательные: --code <string>. pachca introspect reactions remove" });
-            }
-        }
         if (!flags.force) {
             if (!this.isInteractive()) {
                 this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca reactions remove <id> --force" });

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

@@ -11,7 +11,7 @@ export default class SearchListChats extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Запрос длиннее 256 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",

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

@@ -11,7 +11,7 @@ export default class SearchListMessages extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Без него сообщения отбираются только фильтрами. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Без него сообщения отбираются только фильтрами. Запрос длиннее 256 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",

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

@@ -11,7 +11,7 @@ export default class SearchListUsers extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Запрос длиннее 256 знаков обрезается.",
         }),
         'sort': Flags.string({
             description: "Сортировка результатов",

package/dist/commands/security/list.js

@@ -22,7 +22,7 @@ export default class SecurityList extends BaseCommand {
             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: "Идентификатор пользователя, выполнившего действие",
+            description: "Идентификатор актора события, как в поле `actor_id` записи. Смену роли, добавление в чат и исключение из чата, назначение и снятие тегов фильтр находит по сотруднику, которого они коснулись.",
         }),
         'actor-type': Flags.string({
             description: "Тип актора",

package/dist/commands/tasks/create.js

@@ -1,14 +1,12 @@
 // 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 TasksCreate extends BaseCommand {
     static description = "Новое напоминание";
     static scope = "tasks:create";
     static apiMethod = "POST";
     static apiPath = "/tasks";
     static defaultColumns = ["id", "content", "created_at", "kind", "due_at"];
-    static requiredFlags = ["kind"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -51,32 +49,6 @@ export default class TasksCreate extends BaseCommand {
             if (piped)
                 flags['content'] = piped;
         }
-        const missingRequired = [
-            { flag: 'kind', 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: "Обязательные: --kind <string>. pachca introspect tasks create" });
-            }
-        }
         const body = { task: {
                 kind: flags['kind'],
                 content: flags['content'],

package/dist/commands/tasks/update.js

@@ -38,7 +38,7 @@ export default class TasksUpdate extends BaseCommand {
             allowNo: true,
         }),
         'done-at': Flags.string({
-            description: "Дата и время выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, отметку о выполнении снимает: ответ придёт успешный, а в нём `done_at` будет `null`.",
+            description: "Дата и время выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, отметку о выполнении снимает: ответ придёт успешный, а в нём `status` будет `undone`.",
         }),
         'custom-properties': Flags.string({
             description: "Задаваемые дополнительные поля",

package/dist/commands/users/create.js

@@ -25,13 +25,13 @@ export default class UsersCreate extends BaseCommand {
             description: "Телефон (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Имя пользователя (макс. 255 символов)",
+            description: "Имя пользователя: латинские и кириллические буквы, цифры, `_`, `-` и `.`, иначе ответ `400` с кодом `invalid`. Ники `here` и `all` зарезервированы: на них ответ `400` с кодом `use_of_system_words`. (макс. 255 символов)",
         }),
         'department': Flags.string({
             description: "Департамент (макс. 255 символов)",
         }),
         'title': Flags.string({
-            description: "Должность",
+            description: "Должность (макс. 255 символов)",
         }),
         'role': Flags.string({
             description: "Уровень доступа",
@@ -102,6 +102,9 @@ export default class UsersCreate extends BaseCommand {
         if (flags['department'] && String(flags['department']).length > 255) {
             validationErrors.push({ message: `--department: максимум 255 символов (передано: ${String(flags['department']).length})`, flag: 'department' });
         }
+        if (flags['title'] && String(flags['title']).length > 255) {
+            validationErrors.push({ message: `--title: максимум 255 символов (передано: ${String(flags['title']).length})`, flag: 'title' });
+        }
         if (validationErrors.length > 0) {
             this.validationError(validationErrors);
         }

package/dist/commands/users/list.js

@@ -11,7 +11,7 @@ export default class UsersList extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Поисковая фраза для фильтрации результатов. Поиск работает по полям: `first_name` (имя), `last_name` (фамилия), `email` (электронная почта), `phone_number` (телефон) и `nickname` (никнейм).",
+            description: "Поисковая фраза для фильтрации результатов. Поиск работает по полям: `first_name` (имя), `last_name` (фамилия), `nickname` (никнейм), `title` (должность) и `department` (департамент). Если вызывающему видны персональные данные (правило то же, что у поля `email`), поиск идёт ещё по `phone_number` (телефон), значениям дополнительных полей и по полному адресу `email`.",
         }),
         limit: Flags.integer({
             description: 'Количество результатов на страницу',

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

@@ -1,6 +1,7 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
+import { nullableString } from '../../lib/flags.js';
 export default class UsersUpdateStatus extends BaseCommand {
     static description = "Новый статус сотрудника";
     static scope = "user_status:write";
@@ -21,15 +22,15 @@ export default class UsersUpdateStatus extends BaseCommand {
         'title': Flags.string({
             description: "Текст статуса. Обязателен, если статуса ещё нет. (макс. 50 символов)",
         }),
-        'expires-at': Flags.string({
-            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC.",
+        'expires-at': nullableString({
+            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. `null` убирает срок: статус не снимется сам. Чтобы передать null, укажите `--expires-at null`.",
         }),
         'is-away': Flags.boolean({
             description: "Режим «Нет на месте»",
             allowNo: true,
         }),
-        'away-message': Flags.string({
-            description: "Текст сообщения при режиме «Нет на месте». Отображается в профиле и при личных сообщениях/упоминаниях. (макс. 1024 символов)",
+        'away-message': nullableString({
+            description: "Текст сообщения при режиме «Нет на месте». Отображается в профиле и при личных сообщениях/упоминаниях. Поддерживает Markdown и упоминания `@nickname` и `<@user_id>`, но сохраняется и возвращается обычным текстом: разметка убирается, а упоминание сотрудника заменяется на `@` с его именем и фамилией. Предел 1024 символа действует и на присланный текст, и на получившийся, сверх него ответ `400` с кодом `too_long`. `null` или пустая строка убирает текст. Чтобы передать null, укажите `--away-message null`. (макс. 1024 символов)",
         }),
     };
     async run() {

package/dist/commands/users/update.js

@@ -22,19 +22,19 @@ export default class UsersUpdate extends BaseCommand {
             description: "Фамилия (макс. 255 символов)",
         }),
         'email': Flags.string({
-            description: "Электронная почта (макс. 255 символов)",
+            description: "Электронная почта. После её смены сотрудник считается ещё не входившим: `invite_status` приходит `sent`, а `last_activity_at` — `null`, пока он снова не зайдёт в Пачку. (макс. 255 символов)",
         }),
         'phone-number': Flags.string({
             description: "Телефон (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Имя пользователя. Ник бота должен оканчиваться на `_bot` и быть уникальным в пространстве, иначе метод отвечает `422` с ошибкой на поле `nickname`: `invalid` или `already_exists`. Прежний ник бота проверяется, только когда его меняют. (макс. 255 символов)",
+            description: "Имя пользователя: латинские и кириллические буквы, цифры, `_`, `-` и `.`, иначе ответ `400` с кодом `invalid`. Ники `here` и `all` зарезервированы: на них ответ `400` с кодом `use_of_system_words`. Ник, занятый другим сотрудником без учёта регистра, отвечает `400` с кодом `already_exists`: случайные символы, как в методе [Новый сотрудник](POST /users), здесь не дописываются. У сотрудника с `sso: true` занятый ник молча остаётся прежним. Ник бота состоит из латинских букв, цифр и `_`, оканчивается на `_bot` и уникален в пространстве, иначе метод отвечает `422` с ошибкой на поле `nickname`: `invalid` или `already_exists`. Другие ошибки ника бота при его смене, например `blank` или `too_long`, тоже приходят с `422`. Прежний ник бота проверяется, только когда его меняют. (макс. 255 символов)",
         }),
         'department': Flags.string({
             description: "Департамент (макс. 255 символов)",
         }),
         'title': Flags.string({
-            description: "Должность",
+            description: "Должность (макс. 255 символов)",
         }),
         'role': Flags.string({
             description: "Уровень доступа",
@@ -43,7 +43,7 @@ export default class UsersUpdate extends BaseCommand {
             description: "Чат, в котором останется сотрудник при переводе в гости (`role: \"guest\"`): ровно одна активная беседа или канал, куда у токена есть право добавлять участников. Без такого чата ответ `400` по этому полю, и не меняется ничего. При других ролях и у того, кто уже гость, поле не учитывается.",
         }),
         'suspended': Flags.boolean({
-            description: "Деактивация пользователя",
+            description: "Деактивация пользователя. Владельца пространства приостановить нельзя никому, в том числе ему самому: ответ `403`.",
             allowNo: true,
         }),
         'list-tags': Flags.string({
@@ -75,6 +75,9 @@ export default class UsersUpdate extends BaseCommand {
         if (flags['department'] && String(flags['department']).length > 255) {
             validationErrors.push({ message: `--department: максимум 255 символов (передано: ${String(flags['department']).length})`, flag: 'department' });
         }
+        if (flags['title'] && String(flags['title']).length > 255) {
+            validationErrors.push({ message: `--title: максимум 255 символов (передано: ${String(flags['title']).length})`, flag: 'title' });
+        }
         if (validationErrors.length > 0) {
             this.validationError(validationErrors);
         }