@pachca/cli 2026.10.4 → 2026.11.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 2026.11.1  (9 ноября 2026)
+
+- **Изменено** (auth status): Показывает токен, с которым работают команды, в том числе из `--token` и `PACHCA_TOKEN`. Владельца, права и срок жизни такого токена команда спрашивает у сервера и называет сохранённый профиль, который не используется, пока задан `PACHCA_TOKEN`.
+- **Изменено**: Подсказки к отказу `insufficient_scope` ведут к `pachca auth status` с тем же `--token` или `--profile`, что у команды, а для сохранённого профиля в `-o json` ещё и с `--remote`
+- **Изменено** (auth login): Подсказка `pachca auth status` после входа называет профиль, если без него команда покажет другой токен, а при заданном `PACHCA_TOKEN` вход предупреждает, что команды используют переменную
+- **Добавлено** (messages get, messages list, messages create, messages update, search list-messages): В ответах с сообщениями есть поля `source` и `application`: через что сотрудник отправил сообщение и какая программа
+- **Изменено** (chats list, messages list): `--order` без `--sort` задаёт направление по `id`
+- **Изменено** (bots create, bots update, bots update-webhook): В описании адреса вебхука коды отказа, а в описании шаблона проверка синтаксиса
+- **Изменено** (users update): В описании чата для перевода в гости письмо о смене роли
+
+## 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/base-command.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { resolveToken, TokenNotFoundError, ProfileNotFoundError, getAuthMethod, getDefaults, profileFlag, } from './profiles.js';
+import { resolveToken, TokenNotFoundError, ProfileNotFoundError, getAuthMethod, getDefaults, profileFlag, tokenSource, } from './profiles.js';
 import { ApiError, getExitCode, formatDryRun, request } from './client.js';
 import { outputData, outputError, outputSuccess } from './output.js';
 import { defaultOutputFormat, isInteractive } from './utils.js';
@@ -246,8 +246,21 @@ export class BaseCommand extends Command {
     reportScopeError(err) {
         const format = this.getOutputFormat();
         const scope = typeof err.details.scope === 'string' ? err.details.scope : undefined;
-        if (format === 'json' || !process.stderr.isTTY) {
-            outputError(err.details, format);
+        // `auth status` checks the token every command uses. A bare run finds PACHCA_TOKEN
+        // and the active profile by itself; a token or profile named on this command has
+        // to be named again. The token value is never echoed back.
+        const source = tokenSource({ token: this.parsedFlags.token, profile: this.parsedFlags.profile });
+        const human = format !== 'json' && process.stderr.isTTY;
+        const again = source.kind === 'flag'
+            ? human ? ' --token <токен>' : ' --token <token>'
+            : source.kind === 'profile' && source.via === '--profile'
+                ? ` --profile ${source.profileName}`
+                : '';
+        if (!human) {
+            // A saved profile keeps the scope list from login, which may still name the
+            // scope just refused: only the server's answer settles it.
+            const remote = source.kind === 'profile' ? ' --remote' : '';
+            outputError({ ...err.details, hint: `pachca auth status${remote}${again}` }, format);
             this.exit(3);
         }
         const resolved = this.tryResolveProfile();
@@ -255,7 +268,7 @@ export class BaseCommand extends Command {
         process.stderr.write(`✗ Не хватает права${scope ? ` ${scope}` : ''}.\n`);
         if (!profile) {
             process.stderr.write(`  У токена ${scope ? 'этого' : 'нужного'} права нет.\n`);
-            process.stderr.write(`  Проверить права токена: pachca oauth token-info -o json\n`);
+            process.stderr.write(`  Проверить токен и его права: pachca auth status${again}\n`);
             this.exit(3);
         }
         // The scope list in the profile is a copy taken at login. When it still names
@@ -265,7 +278,7 @@ export class BaseCommand extends Command {
         const listedLocally = !!scope && !!profile.scopes?.includes(scope);
         if (listedLocally) {
             process.stderr.write(`  В сохранённом списке право есть, но у токена его уже нет: список устарел.\n`);
-            process.stderr.write(`  Обновить список: pachca auth status --remote${flag}\n`);
+            process.stderr.write(`  Обновить список: pachca auth status --remote${again}\n`);
         }
         else {
             process.stderr.write(`  У токена ${scope ? 'этого' : 'нужного'} права нет.\n`);

package/dist/commands/auth/login.js

@@ -1,9 +1,10 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import { setProfile, setActiveProfile, getActiveProfile, getProfile, getSecretStorage, expiresAtFromNow, } from '../../profiles.js';
+import { setProfile, setActiveProfile, getActiveProfile, getProfile, getSecretStorage, expiresAtFromNow, tokenSource, } from '../../profiles.js';
 import { isSecretStoreAvailable } from '../../secret-store.js';
 import { ApiError, request } from '../../client.js';
 import { outputError } from '../../output.js';
+import { fetchIdentity } from '../../identity.js';
 import { OAuthError, copyToClipboard, deviceName, openBrowser, pollForToken, requestDeviceCode, } from '../../oauth.js';
 export default class AuthLogin extends BaseCommand {
     static description = 'Вход в аккаунт и сохранение профиля';
@@ -68,7 +69,7 @@ export default class AuthLogin extends BaseCommand {
             ? { access_token: flags.token }
             : await this.deviceLogin(profileName, !flags['no-browser'], flags.quiet);
         const tokenInfo = await this.verifyToken(grant.access_token);
-        const identity = await this.fetchIdentity(grant.access_token, tokenInfo.user_id);
+        const identity = await fetchIdentity(grant.access_token, tokenInfo.user_id);
         const scopes = grant.scope ? grant.scope.split(' ').filter(Boolean) : tokenInfo.scopes;
         const profile = {
             type: identity.isBot ? 'bot' : 'user',
@@ -197,22 +198,6 @@ export default class AuthLogin extends BaseCommand {
             throw error;
         }
     }
-    async fetchIdentity(token, userId) {
-        try {
-            const response = await request({ method: 'GET', path: '/profile', token }, { quiet: true });
-            const data = response.data.data;
-            const name = `${data.first_name || ''} ${data.last_name || ''}`.trim();
-            return {
-                name: name || `User #${userId}`,
-                email: data.email || null,
-                isBot: data.bot || false,
-            };
-        }
-        catch {
-            // profile:read scope not available — user_id from token info is enough
-            return { name: `User #${userId}`, email: null, isBot: false };
-        }
-    }
     report(profileName, profile, scopes) {
         const format = this.getOutputFormat();
         if (format === 'json') {
@@ -243,7 +228,14 @@ export default class AuthLogin extends BaseCommand {
         else {
             process.stderr.write(`  Токен в файле конфигурации (хранилище ключей недоступно)\n`);
         }
-        process.stderr.write(`  Состояние входа: pachca auth status\n`);
+        // A bare `auth status` shows the token other commands would use: PACHCA_TOKEN
+        // when it is set, or the active profile, which need not be the one just saved.
+        const src = tokenSource({});
+        const statusFlag = src.kind === 'profile' && src.profileName === profileName ? '' : ` --profile ${profileName}`;
+        process.stderr.write(`  Состояние входа: pachca auth status${statusFlag}\n`);
+        if (src.kind === 'env') {
+            process.stderr.write(`  Пока задан PACHCA_TOKEN, команды используют его, а не профиль ${profileName}\n`);
+        }
     }
 }
 /** Read a token piped into the command, so it never appears in the shell history. */

package/dist/commands/auth/status.js

@@ -1,8 +1,9 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import { getActiveProfile, getAuthMethod, getProfile, getSecretStorage, updateProfileScopes, } from '../../profiles.js';
-import { request } from '../../client.js';
+import { getActiveProfile, getAuthMethod, getProfile, getSecretStorage, listProfiles, tokenSource, updateProfileScopes, } from '../../profiles.js';
+import { ApiError, request } from '../../client.js';
 import { outputError } from '../../output.js';
+import { fetchIdentity } from '../../identity.js';
 /** Human-readable time left, or null when the token has no expiry at all. */
 function describeExpiry(profile) {
     if (getAuthMethod(profile) === 'token')
@@ -18,10 +19,11 @@ function describeExpiry(profile) {
     return minutes < 60 ? `осталось ${minutes} мин` : `осталось ${Math.round(minutes / 60)} ч`;
 }
 export default class AuthStatus extends BaseCommand {
-    static description = 'Статус текущего профиля';
+    static description = 'Чей токен используют команды и какие у него права';
     static examples = [
         '<%= config.bin %> auth status',
         '<%= config.bin %> auth status -o json',
+        'PACHCA_TOKEN=$TOKEN <%= config.bin %> auth status -o json',
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -33,12 +35,30 @@ export default class AuthStatus extends BaseCommand {
     async run() {
         const { flags } = await this.parse(AuthStatus);
         this.parsedFlags = flags;
-        const profileName = flags.profile || process.env.PACHCA_PROFILE || getActiveProfile();
         const format = this.getOutputFormat();
-        if (!profileName) {
-            outputError({ error: 'No active profile. Run: pachca auth login', type: 'PACHCA_USAGE_ERROR', code: null }, format);
+        // The token every other command would use, picked in the same order:
+        // --token, --profile, PACHCA_TOKEN, PACHCA_PROFILE, the active profile.
+        // Agents and CI usually pass PACHCA_TOKEN with no profile at all, and this
+        // is the command they are sent to check the connection.
+        const source = tokenSource({ token: flags.token, profile: flags.profile });
+        if (source.kind === 'flag') {
+            await this.showPassedToken(flags.token, '--token');
+            return;
+        }
+        if (source.kind === 'env') {
+            await this.showPassedToken(process.env.PACHCA_TOKEN, 'PACHCA_TOKEN');
+            return;
+        }
+        if (source.kind === 'none') {
+            outputError({
+                error: 'No active profile. Run: pachca auth login',
+                type: 'PACHCA_USAGE_ERROR',
+                code: null,
+                hint: 'pachca auth login, or set PACHCA_TOKEN',
+            }, format);
             this.exit(2);
         }
+        const profileName = source.kind === 'profile' ? source.profileName : undefined;
         const profile = getProfile(profileName);
         if (!profile) {
             outputError({ error: `Profile "${profileName}" not found`, type: 'PACHCA_USAGE_ERROR', code: null }, format);
@@ -67,6 +87,7 @@ export default class AuthStatus extends BaseCommand {
         if (format === 'json') {
             this.output({
                 profile: profileName,
+                source: source.kind === 'profile' ? source.via : null,
                 type: profile.type,
                 user: profile.user,
                 email: profile.email || null,
@@ -111,10 +132,88 @@ export default class AuthStatus extends BaseCommand {
             process.stderr.write(`  Список прав в профиле расходился с сервером и был обновлён\n`);
         }
     }
+    /**
+     * A token passed to the command rather than saved in a profile. Nothing about it
+     * is stored, so everything comes from the server: whose it is and what it carries.
+     * A revoked token or no network ends the command with the usual error and hint.
+     */
+    async showPassedToken(token, label) {
+        // A PACHCA_TOKEN left in the environment silently wins over the profile the
+        // person thinks they are using. Name that profile, so the mix-up is visible,
+        // also when the forgotten token no longer works.
+        const profileName = label === 'PACHCA_TOKEN' ? process.env.PACHCA_PROFILE || getActiveProfile() : undefined;
+        const unusedProfile = profileName && listProfiles()[profileName] ? profileName : null;
+        const clientFlags = { ...this.getClientFlags(), quiet: true };
+        let info;
+        try {
+            const response = await request({ method: 'GET', path: '/oauth/token/info', token }, clientFlags);
+            info = response.data.data;
+        }
+        catch (error) {
+            // A dead token (401) or one whose owner lost access (403 access_denied):
+            // the profile it hides may still work, so say so.
+            const dead = error instanceof ApiError &&
+                (error.details.code === 401 || (error.details.code === 403 && error.details.validation_code === 'access_denied'));
+            if (dead && unusedProfile) {
+                const human = this.getOutputFormat() !== 'json' && process.stderr.isTTY;
+                error.details.unused_profile = unusedProfile;
+                error.details.hint = human
+                    ? `Профиль ${unusedProfile} не используется, пока задан PACHCA_TOKEN: уберите переменную или добавьте --profile ${unusedProfile}`
+                    : `unset PACHCA_TOKEN, or add --profile ${unusedProfile}`;
+            }
+            throw error;
+        }
+        const identity = await fetchIdentity(token, info.user_id, clientFlags);
+        const type = identity.isBot === null ? null : identity.isBot ? 'bot' : 'user';
+        const user = identity.isBot ? `${identity.name} (бот)` : identity.name;
+        const scopes = info.scopes ?? [];
+        // A CLI login or an app's token lives an hour from issue, and nothing renews a
+        // token passed to the command. Other tokens have no lifetime at all.
+        const expiresIn = info.expires_in ?? null;
+        const issuedAt = info.created_at ? Date.parse(info.created_at) : Number.NaN;
+        const expiresAt = expiresIn && !Number.isNaN(issuedAt) ? new Date(issuedAt + expiresIn * 1000) : null;
+        if (this.getOutputFormat() === 'json') {
+            this.output({
+                profile: null,
+                source: label,
+                type,
+                user,
+                user_id: info.user_id,
+                email: identity.email,
+                auth: 'token',
+                expires_at: expiresAt ? expiresAt.toISOString() : null,
+                expires_in: expiresIn,
+                scopes,
+                scopes_source: 'server',
+                storage: null,
+                secret_readable: true,
+                unused_profile: unusedProfile,
+            });
+            return;
+        }
+        const emailStr = identity.email ? ` (${identity.email})` : '';
+        const from = label === '--token' ? 'флага --token' : 'PACHCA_TOKEN';
+        const typeStr = type ?? (identity.noScope ? 'бот или сотрудник: без права profile:read не узнать' : 'бот или сотрудник: профиль не прочитан');
+        process.stderr.write(`  Подключён как: ${user}${emailStr}  [${typeStr}]\n`);
+        if (expiresIn) {
+            const minutesLeft = expiresAt ? Math.round((expiresAt.getTime() - Date.now()) / 60_000) : null;
+            const left = minutesLeft === null ? `живёт ${Math.round(expiresIn / 60)} мин от выдачи` : minutesLeft > 0 ? `осталось ${minutesLeft} мин` : 'истёк';
+            process.stderr.write(`  Вход: токеном из ${from}, ${left}, CLI его не продлевает\n`);
+        }
+        else {
+            process.stderr.write(`  Вход: готовым токеном из ${from}\n`);
+        }
+        process.stderr.write(scopes.length
+            ? `  Права по данным сервера (${scopes.length}): ${scopes.join(', ')}\n`
+            : `  Права по данным сервера: ни одного\n`);
+        if (unusedProfile) {
+            process.stderr.write(`  Профиль ${unusedProfile} не используется, пока задан PACHCA_TOKEN. Чтобы работать с ним, добавьте --profile ${unusedProfile} или уберите переменную.\n`);
+        }
+    }
     /** Ask the server what the token really carries. Null when it cannot be asked. */
     async fetchRemoteScopes(token) {
         try {
-            const response = await request({ method: 'GET', path: '/oauth/token/info', token }, { quiet: true });
+            const response = await request({ method: 'GET', path: '/oauth/token/info', token }, { ...this.getClientFlags(), quiet: true });
             const info = response.data.data;
             return info?.scopes ?? null;
         }

package/dist/commands/bots/create.js

@@ -16,38 +16,38 @@ 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 исходящего вебхука: публичный адрес с протоколом `http` или `https`. Иначе ответ `400` на поле `webhook.outgoing_url` с кодом `webhook_url_invalid`, `webhook_url_unresolved` или `webhook_url_forbidden`. (макс. 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` назначать нельзя.",
         }),
         'template': Flags.string({
-            description: "Шаблон форматирования входящего вебхука",
+            description: "Шаблон форматирования входящего вебхука. Шаблон с синтаксической ошибкой у источника `simple`, в том числе у пустого бота с `kind: simple`, даёт ответ `400` на этом поле с кодом `invalid`, и бот не создаётся. Причина приходит в `message`.",
         }),
         'template-engine': Flags.string({
             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,14 +13,14 @@ export default class BotsUpdateWebhook extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'outgoing-url': Flags.string({
-            description: "URL исходящего вебхука. Пустая строка отключает вебхук.",
+            description: "URL исходящего вебхука: публичный адрес с протоколом `http` или `https`. Иначе ответ `400` на поле `webhook.outgoing_url` с кодом `webhook_url_invalid`, `webhook_url_unresolved` или `webhook_url_forbidden`. Пустая строка отключает вебхук. (макс. 255 символов)",
         }),
     };
     async run() {
         const { args, flags } = await this.parse(BotsUpdateWebhook);
         this.parsedFlags = flags;
         const missingRequired = [
-            { flag: 'outgoing-url', label: "URL исходящего вебхука. Пустая строка отключает вебхук.", type: 'string' },
+            { flag: 'outgoing-url', label: "URL исходящего вебхука: публичный адрес с протоколом `http` или `https`. Иначе ответ `400` на поле `webhook.outgoing_url` с кодом `webhook_url_invalid`, `webhook_url_unresolved` или `webhook_url_forbidden`. Пустая строка отключает вебхук.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {
@@ -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 исходящего вебхука: публичный адрес с протоколом `http` или `https`. Иначе ответ `400` на поле `webhook.outgoing_url` с кодом `webhook_url_invalid`, `webhook_url_unresolved` или `webhook_url_forbidden`. (макс. 255 символов)",
         }),
         'events': Flags.string({
             description: "События, на которые подписан бот. Список заменяется целиком.",
@@ -32,26 +32,26 @@ 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` назначать нельзя.",
         }),
         'template': Flags.string({
-            description: "Шаблон форматирования входящего вебхука",
+            description: "Шаблон форматирования входящего вебхука. Шаблон проверяется, когда в запросе меняются `template`, `template_engine` или `kind`, поэтому смена одного шаблонизатора или включение `kind: simple` проверяет и уже сохранённый шаблон. Шаблон с синтаксической ошибкой у источника `simple` даёт ответ `400` на этом поле с кодом `invalid`, и запрос не применяется. Причина приходит в `message`.",
         }),
         'template-engine': Flags.string({
             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/list.js

@@ -16,7 +16,7 @@ export default class ChatsList extends BaseCommand {
             default: "id",
         }),
         'order': Flags.string({
-            description: "Направление сортировки. Применяется вместе с `sort`, например `sort=last_message_at&order=desc`. Без `sort` чаты идут по убыванию `id` при любом `order`.",
+            description: "Направление сортировки по полю `sort`, например `sort=last_message_at&order=desc`. Без `sort` направление применяется к `id`.",
             options: ["asc", "desc"],
             default: "desc",
         }),

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

@@ -26,7 +26,7 @@ export default class MessagesList extends BaseCommand {
             default: "id",
         }),
         'order': Flags.string({
-            description: "Направление сортировки. Применяется вместе с `sort`: сообщения от старых к новым дают `sort=id` и `order=asc`. Без `sort` сообщения идут от новых к старым при любом `order`.",
+            description: "Направление сортировки по `id`: `asc` отдаёт сообщения от старых к новым, `desc` от новых к старым.",
             options: ["asc", "desc"],
             default: "desc",
         }),

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() {