@pachca/cli 2026.5.6 → 2026.6.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 2026.6.1  (16 июня 2026)
+
+- **Изменено** (bots create): Добавлен параметр `scopes` — выбор скоупов токена бота
+- **Изменено** (bots update): Добавлен параметр `scopes` — изменение скоупов токена бота
+- **Добавлено** (bots update-webhook): Новая команда — саморегистрация исходящего вебхука бота его собственным токеном
+
+## 2026.6.0  (15 июня 2026)
+
+- **Добавлено** (bots create): Новая команда — создание бота и получение его `access_token`
+- **Добавлено** (bots get): Новая команда — получение параметров бота
+- **Изменено** (bots update): Расширены поля редактирования бота: `name`, `nickname`, `events`, `trigger_on`, `commands`
+- **Добавлено**: В сообщениях появилось поле `voice_content` и параметры файлов `duration_ms` / `waveform` для голосовых сообщений
+- **Изменено**: Чище примеры: убраны опциональные флаги и поля, чьё значение равно дефолту схемы (`--no-skip-invite-mentions`, `--no-link-preview` и т.п.); кавычки в примерах ставятся только при наличии shell-метасимволов
+
+## 2026.5.6  (21 мая 2026)
+
+- **Изменено** (api): В выводе `pachca api <МЕТОД> <путь> --describe` у полей запроса и ответа появились примеры значений
+
 ## 2026.5.4  (20 мая 2026)
 
 - **Добавлено** (threads list): Новая команда — список доступных тредов с фильтрами `--last-message-at-after` / `--last-message-at-before` и курсорной пагинацией

package/README.md

@@ -78,6 +78,9 @@ pachca guide            # список всех сценариев
 
 | Команда | Описание |
 |---------|---------|
+| `pachca bots update-webhook` | Саморегистрация вебхука бота |
+| `pachca bots create` | Новый бот |
+| `pachca bots get` | Информация о боте |
 | `pachca bots update` | Редактирование бота |
 | `pachca bots list-events` | История событий |
 | `pachca bots remove-event` | Удаление события |
@@ -89,7 +92,7 @@ pachca guide            # список всех сценариев
 | `pachca chats create` | Новый чат |
 | `pachca chats list` | Список чатов |
 | `pachca chats get` | Информация о чате |
-| `pachca chats update` | Обновление чата |
+| `pachca chats update` | Редактирование чата |
 | `pachca chats archive` | Архивация чата |
 | `pachca chats unarchive` | Разархивация чата |
 
@@ -171,12 +174,12 @@ pachca guide            # список всех сценариев
 | Команда | Описание |
 |---------|---------|
 | `pachca profile get-info` | Информация о токене |
-| `pachca profile get` | Информация о профиле |
-| `pachca profile update-avatar` | Загрузка аватара |
-| `pachca profile delete-avatar` | Удаление аватара |
-| `pachca profile get-status` | Текущий статус |
-| `pachca profile update-status` | Новый статус |
-| `pachca profile delete-status` | Удаление статуса |
+| `pachca profile get` | Свой профиль |
+| `pachca profile update-avatar` | Загрузка своего аватара |
+| `pachca profile delete-avatar` | Удаление своего аватара |
+| `pachca profile get-status` | Свой статус |
+| `pachca profile update-status` | Новый свой статус |
+| `pachca profile delete-status` | Удаление своего статуса |
 
 ### search
 
@@ -200,7 +203,7 @@ pachca guide            # список всех сценариев
 
 | Команда | Описание |
 |---------|---------|
-| `pachca users create` | Создать сотрудника |
+| `pachca users create` | Новый сотрудник |
 | `pachca users list` | Список сотрудников |
 | `pachca users get` | Информация о сотруднике |
 | `pachca users update` | Редактирование сотрудника |

package/dist/commands/bots/create.js

@@ -0,0 +1,94 @@
+// 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 BotsCreate extends BaseCommand {
+    static description = "Новый бот";
+    static examples = [
+        "Создать бота через API и получить токен:\n  $ pachca bots create",
+        "Настроить бота с исходящим вебхуком:\n  $ pachca bots create"
+    ];
+    static scope = "bots:write";
+    static apiMethod = "POST";
+    static apiPath = "/bots";
+    static defaultColumns = ["id", "webhook", "access_token"];
+    static requiredFlags = ["name"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'name': Flags.string({
+            description: "Имя бота",
+        }),
+        'nickname': Flags.string({
+            description: "Никнейм бота. Должен заканчиваться на `_bot`.",
+        }),
+        'outgoing-url': Flags.string({
+            description: "URL исходящего вебхука",
+        }),
+        'events': Flags.string({
+            description: "События, на которые подписан бот",
+        }),
+        'trigger-on': Flags.string({
+            description: "Условие срабатывания исходящего вебхука",
+        }),
+        'commands': Flags.string({
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands",
+        }),
+        'scopes': Flags.string({
+            description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию.",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsCreate);
+        this.parsedFlags = flags;
+        const missingRequired = [
+            { flag: 'name', 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: "Обязательные: --name <string>. pachca introspect bots create" });
+            }
+        }
+        const body = { webhook: {
+                name: flags['name'],
+                nickname: flags['nickname'],
+                outgoing_url: flags['outgoing-url'],
+                events: flags['events'] ? this.parseJSON(flags['events'], 'events') : undefined,
+                trigger_on: flags['trigger-on'],
+                commands: flags['commands'] ? this.parseJSON(flags['commands'], 'commands') : undefined,
+                scopes: flags['scopes'] ? this.parseJSON(flags['scopes'], 'scopes') : undefined,
+            } };
+        // Clean undefined fields
+        const inner = body['webhook'];
+        for (const [k, v] of Object.entries(inner)) {
+            if (v === undefined)
+                delete inner[k];
+        }
+        const { data } = await this.apiRequest({
+            method: 'POST',
+            path: '/bots',
+            body,
+        });
+        const responseBody = data;
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/bots/get.js

@@ -0,0 +1,33 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class BotsGet extends BaseCommand {
+    static description = "Информация о боте";
+    static examples = [
+        "Обновить Webhook URL бота:\n  $ pachca bots update"
+    ];
+    static scope = "bots:read";
+    static apiMethod = "GET";
+    static apiPath = "/bots/{id}";
+    static defaultColumns = ["id", "webhook"];
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор бота (pachca bots list)",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsGet);
+        this.parsedFlags = flags;
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: `/bots/${args.id}`,
+        });
+        const responseBody = data;
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

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

@@ -0,0 +1,72 @@
+// 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 BotsUpdateWebhook extends BaseCommand {
+    static description = "Саморегистрация вебхука бота";
+    static examples = [
+        "Обновить Webhook URL бота:\n  $ pachca bots update-webhook"
+    ];
+    static scope = "bot_self:webhook:write";
+    static apiMethod = "PUT";
+    static apiPath = "/bot/webhook";
+    static defaultColumns = ["id", "webhook"];
+    static requiredFlags = ["outgoing-url"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'outgoing-url': Flags.string({
+            description: "URL исходящего вебхука. Пустая строка отключает вебхук.",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsUpdateWebhook);
+        this.parsedFlags = flags;
+        const missingRequired = [
+            { flag: 'outgoing-url', label: "URL исходящего вебхука. Пустая строка отключает вебхук.", 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: "Обязательные: --outgoing-url <string>. pachca introspect bots update-webhook" });
+            }
+        }
+        const body = { webhook: {
+                outgoing_url: flags['outgoing-url'],
+            } };
+        // Clean undefined fields
+        const inner = body['webhook'];
+        for (const [k, v] of Object.entries(inner)) {
+            if (v === undefined)
+                delete inner[k];
+        }
+        if (Object.keys(inner).length === 0) {
+            this.validationError([{ message: 'Не указаны поля для обновления' }], { type: 'PACHCA_USAGE_ERROR' });
+        }
+        const { data } = await this.apiRequest({
+            method: 'PUT',
+            path: '/bot/webhook',
+            body,
+        });
+        const responseBody = data;
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/bots/update.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 BotsUpdate extends BaseCommand {
     static description = "Редактирование бота";
     static examples = [
@@ -10,8 +9,7 @@ export default class BotsUpdate extends BaseCommand {
     static scope = "bots:write";
     static apiMethod = "PUT";
     static apiPath = "/bots/{id}";
-    static defaultColumns = ["id"];
-    static requiredFlags = ["webhook"];
+    static defaultColumns = ["id", "webhook"];
     static args = {
         id: Args.integer({
             description: "Идентификатор бота (pachca bots list)",
@@ -20,44 +18,42 @@ export default class BotsUpdate extends BaseCommand {
     };
     static flags = {
         ...BaseCommand.baseFlags,
-        'webhook': Flags.string({
-            description: "Объект параметров вебхука",
+        'name': Flags.string({
+            description: "Имя бота",
+        }),
+        'nickname': Flags.string({
+            description: "Никнейм бота. Должен заканчиваться на `_bot`.",
+        }),
+        'outgoing-url': Flags.string({
+            description: "URL исходящего вебхука",
+        }),
+        'events': Flags.string({
+            description: "События, на которые подписан бот",
+        }),
+        'trigger-on': Flags.string({
+            description: "Условие срабатывания исходящего вебхука",
+        }),
+        'commands': Flags.string({
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands",
+        }),
+        'scopes': Flags.string({
+            description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию.",
         }),
     };
     async run() {
         const { args, flags } = await this.parse(BotsUpdate);
         this.parsedFlags = flags;
-        const missingRequired = [
-            { flag: 'webhook', 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: "Обязательные: --webhook <string>. pachca introspect bots update" });
-            }
-        }
-        const body = { bot: {
-                webhook: flags['webhook'] ? this.parseJSON(flags['webhook'], 'webhook') : undefined,
+        const body = { webhook: {
+                name: flags['name'],
+                nickname: flags['nickname'],
+                outgoing_url: flags['outgoing-url'],
+                events: flags['events'] ? this.parseJSON(flags['events'], 'events') : undefined,
+                trigger_on: flags['trigger-on'],
+                commands: flags['commands'] ? this.parseJSON(flags['commands'], 'commands') : undefined,
+                scopes: flags['scopes'] ? this.parseJSON(flags['scopes'], 'scopes') : undefined,
             } };
         // Clean undefined fields
-        const inner = body['bot'];
+        const inner = body['webhook'];
         for (const [k, v] of Object.entries(inner)) {
             if (v === undefined)
                 delete inner[k];

package/dist/commands/chats/update.js

@@ -2,7 +2,7 @@
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ChatsUpdate extends BaseCommand {
-    static description = "Обновление чата";
+    static description = "Редактирование чата";
     static examples = [
         "Переименовать или обновить чат:\n  $ pachca chats update"
     ];

package/dist/commands/profile/delete-avatar.js

@@ -3,7 +3,7 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ProfileDeleteAvatar extends BaseCommand {
-    static description = "Удаление аватара";
+    static description = "Удаление своего аватара";
     static examples = [
         "Загрузить аватар профиля:\n  $ pachca profile update-avatar",
         "Удалить аватар профиля:\n  $ pachca profile delete-avatar"

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

@@ -3,7 +3,7 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ProfileDeleteStatus extends BaseCommand {
-    static description = "Удаление статуса";
+    static description = "Удаление своего статуса";
     static examples = [
         "Установить статус:\n  $ pachca profile update-status",
         "Сбросить статус:\n  $ pachca profile delete-status"

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

@@ -1,6 +1,6 @@
 import { BaseCommand } from '../../base-command.js';
 export default class ProfileGetStatus extends BaseCommand {
-    static description = "Текущий статус";
+    static description = "Свой статус";
     static examples = [
         "Установить статус:\n  $ pachca profile update-status",
         "Сбросить статус:\n  $ pachca profile delete-status"

package/dist/commands/profile/get.js

@@ -1,6 +1,6 @@
 import { BaseCommand } from '../../base-command.js';
 export default class ProfileGet extends BaseCommand {
-    static description = "Информация о профиле";
+    static description = "Свой профиль";
     static examples = [
         "Получить свой профиль:\n  $ pachca profile get",
         "Получить кастомные поля профиля:\n  $ pachca profile get"

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

@@ -4,7 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 export default class ProfileUpdateAvatar extends BaseCommand {
-    static description = "Загрузка аватара";
+    static description = "Загрузка своего аватара";
     static examples = [
         "Загрузить аватар профиля:\n  $ pachca profile update-avatar",
         "Удалить аватар профиля:\n  $ pachca profile delete-avatar"

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

@@ -3,7 +3,7 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class ProfileUpdateStatus extends BaseCommand {
-    static description = "Новый статус";
+    static description = "Новый свой статус";
     static examples = [
         "Установить статус:\n  $ pachca profile update-status",
         "Сбросить статус:\n  $ pachca profile delete-status"

package/dist/commands/users/create.js

@@ -3,7 +3,7 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class UsersCreate extends BaseCommand {
-    static description = "Создать сотрудника";
+    static description = "Новый сотрудник";
     static examples = [
         "Проверить, кто прочитал сообщение:\n  $ pachca users list",
         "Разослать уведомление нескольким пользователям:\n  $ pachca users list",

package/dist/commands/views/open.js

@@ -20,7 +20,7 @@ export default class ViewsOpen extends BaseCommand {
             description: "Заголовок представления (макс. 24 символов)",
         }),
         'close-text': Flags.string({
-            description: "Текст кнопки закрытия представления (макс. 24 символов)",
+            description: "Текст кнопки закрытия представления. Отображается только в десктоп-вебе. В мобильных приложениях (iOS/Android) кнопка закрытия — это крестик в шапке, и заданный текст там не показывается. (макс. 24 символов)",
         }),
         'submit-text': Flags.string({
             description: "Текст кнопки отправки формы (макс. 24 символов)",

package/dist/data/alternatives.json

@@ -1,12 +1,15 @@
 {
     "security:list": "Журнал аудита событий",
+    "bots:update-webhook": "Саморегистрация вебхука бота",
+    "bots:create": "Новый бот",
+    "bots:get": "Информация о боте",
     "bots:update": "Редактирование бота",
     "chats:create": "Новый чат",
     "chats:list": "Список чатов",
     "common:request-export": "Экспорт сообщений",
     "common:get-exports": "Скачать архив экспорта",
     "chats:get": "Информация о чате",
-    "chats:update": "Обновление чата",
+    "chats:update": "Редактирование чата",
     "chats:archive": "Архивация чата",
     "members:add-group-tags": "Добавление тегов",
     "members:remove-group-tag": "Исключение тега",
@@ -38,12 +41,12 @@
     "read-member:list-readers": "Список прочитавших сообщение",
     "threads:add": "Новый тред",
     "profile:get-info": "Информация о токене",
-    "profile:get": "Информация о профиле",
-    "profile:update-avatar": "Загрузка аватара",
-    "profile:delete-avatar": "Удаление аватара",
-    "profile:get-status": "Текущий статус",
-    "profile:update-status": "Новый статус",
-    "profile:delete-status": "Удаление статуса",
+    "profile:get": "Свой профиль",
+    "profile:update-avatar": "Загрузка своего аватара",
+    "profile:delete-avatar": "Удаление своего аватара",
+    "profile:get-status": "Свой статус",
+    "profile:update-status": "Новый свой статус",
+    "profile:delete-status": "Удаление своего статуса",
     "search:list-chats": "Поиск чатов",
     "search:list-messages": "Поиск сообщений",
     "search:list-users": "Поиск сотрудников",
@@ -55,7 +58,7 @@
     "threads:list": "Список тредов",
     "threads:get": "Информация о треде",
     "common:uploads": "Получение подписи, ключа и других параметров",
-    "users:create": "Создать сотрудника",
+    "users:create": "Новый сотрудник",
     "users:list": "Список сотрудников",
     "users:get": "Информация о сотруднике",
     "users:update": "Редактирование сотрудника",

package/dist/data/changelog.json

@@ -1,4 +1,65 @@
 [
+    {
+        "version": "2026.6.1",
+        "date": "16 июня 2026",
+        "changes": [
+            {
+                "type": "~",
+                "command": "bots create",
+                "description": "Добавлен параметр `scopes` — выбор скоупов токена бота"
+            },
+            {
+                "type": "~",
+                "command": "bots update",
+                "description": "Добавлен параметр `scopes` — изменение скоупов токена бота"
+            },
+            {
+                "type": "+",
+                "command": "bots update-webhook",
+                "description": "Новая команда — саморегистрация исходящего вебхука бота его собственным токеном"
+            }
+        ]
+    },
+    {
+        "version": "2026.6.0",
+        "date": "15 июня 2026",
+        "changes": [
+            {
+                "type": "+",
+                "command": "bots create",
+                "description": "Новая команда — создание бота и получение его `access_token`"
+            },
+            {
+                "type": "+",
+                "command": "bots get",
+                "description": "Новая команда — получение параметров бота"
+            },
+            {
+                "type": "~",
+                "command": "bots update",
+                "description": "Расширены поля редактирования бота: `name`, `nickname`, `events`, `trigger_on`, `commands`"
+            },
+            {
+                "type": "+",
+                "description": "В сообщениях появилось поле `voice_content` и параметры файлов `duration_ms` / `waveform` для голосовых сообщений"
+            },
+            {
+                "type": "~",
+                "description": "Чище примеры: убраны опциональные флаги и поля, чьё значение равно дефолту схемы (`--no-skip-invite-mentions`, `--no-link-preview` и т.п.); кавычки в примерах ставятся только при наличии shell-метасимволов"
+            }
+        ]
+    },
+    {
+        "version": "2026.5.6",
+        "date": "21 мая 2026",
+        "changes": [
+            {
+                "type": "~",
+                "command": "api",
+                "description": "В выводе `pachca api <МЕТОД> <путь> --describe` у полей запроса и ответа появились примеры значений"
+            }
+        ]
+    },
     {
         "version": "2026.5.4",
         "date": "20 мая 2026",