@pachca/cli 2026.5.6 → 2026.6.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 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,8 @@ pachca guide            # список всех сценариев
 
 | Команда | Описание |
 |---------|---------|
+| `pachca bots create` | Создание бота |
+| `pachca bots get` | Получение бота |
 | `pachca bots update` | Редактирование бота |
 | `pachca bots list-events` | История событий |
 | `pachca bots remove-event` | Удаление события |

package/dist/commands/bots/create.js

@@ -0,0 +1,70 @@
+// 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 = ["webhook"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'webhook': Flags.string({
+            description: "Объект параметров вебхука бота",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsCreate);
+        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 create" });
+            }
+        }
+        const body = { bot: {
+                webhook: flags['webhook'] ? this.parseJSON(flags['webhook'], 'webhook') : undefined,
+            } };
+        // Clean undefined fields
+        const inner = body['bot'];
+        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.js

@@ -10,7 +10,7 @@ export default class BotsUpdate extends BaseCommand {
     static scope = "bots:write";
     static apiMethod = "PUT";
     static apiPath = "/bots/{id}";
-    static defaultColumns = ["id"];
+    static defaultColumns = ["id", "webhook"];
     static requiredFlags = ["webhook"];
     static args = {
         id: Args.integer({

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,5 +1,7 @@
 {
     "security:list": "Журнал аудита событий",
+    "bots:create": "Создание бота",
+    "bots:get": "Получение бота",
     "bots:update": "Редактирование бота",
     "chats:create": "Новый чат",
     "chats:list": "Список чатов",

package/dist/data/changelog.json

@@ -1,4 +1,44 @@
 [
+    {
+        "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",