@pachca/cli 2026.8.3 → 2026.9.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2026.9.1  (16 сентября 2026)
+
+- **Изменено**: Повтор после `429` ждёт не меньше срока из `Retry-After`: прежний потолок в 60 секунд убран. Пауза дольше минуты не повторяется — команда сразу возвращает ошибку с заголовком, потому что повтор внутри паузы её удваивает
+- **Исправлено** (api): `api <метод> --spec` и `--docs` показывают развёрнутые описания методов: кого метод пускает, что меняется в пространстве после вызова и чем он отличается от соседнего
+- **Добавлено** (drafts): Новая группа команд — черновики и отложенные сообщения: `create`, `get`, `list`, `update`, `delete`. Отложенное задаётся флагом `--schedule`, отменяется удалением. Токенам ботов недоступны
+- **Добавлено** (messages get): У вложений появилось поле `duration_ms` — длительность голосового, аудио- и видеофайла, и тип `video`
+- **Исправлено** (chats request-export): Флаг `--webhook-url` больше не обязателен: без него о готовности узнает только заказавший, из письма и уведомления
+- **Добавлено** (files get): Новая команда — скачивание вложения, у которого нет прямой ссылки: зашифрованного или конфиденциального. Файл сохраняется по пути из обязательного флага `--save`. Остальные вложения забираются по `url` из сообщения
+
+## 2026.9.0  (9 сентября 2026)
+
+- **Добавлено** (views submit-response): Ответ на отправку формы для бота без адреса исходящего вебхука: `view_id` и `submit_id` берутся из события `view_submit` в журнале событий
+- **Добавлено** (security list): Флаг `--event-key` принимает значение `exchange_disabled` — отключена интеграция с Exchange
+- **Исправлено** (api): `api POST /messages --spec` и `api PUT /messages/{id} --spec`: у прикрепляемых файлов показаны пределы длины — `key` до 1000 символов и `name` до 255
+- **Исправлено** (api): `api POST /views/open --spec` и `--docs`: у блока `time` начальное значение принимается и в формате `HH:mm:ss`, секунды отбрасываются
+
 ## 2026.8.3  (28 августа 2026)
 
 - **Добавлено** (security list): Флаг `--event-key` принимает значение `user_2fa_disabled` — сотрудник отключил себе двухфакторную аутентификацию

package/README.md

@@ -110,7 +110,7 @@ pachca guide            # список всех сценариев
 |---------|---------|
 | `pachca members add-group-tags` | Добавление тегов |
 | `pachca members remove-group-tag` | Исключение тега |
-| `pachca members leave` | Выход из беседы или канала |
+| `pachca members leave` | Выход из чата |
 | `pachca members list` | Список участников чата |
 | `pachca members add` | Добавление пользователей |
 | `pachca members remove` | Исключение пользователя |
@@ -127,14 +127,25 @@ pachca guide            # список всех сценариев
 | Команда | Описание |
 |---------|---------|
 | `pachca files direct-url` | Загрузка файла |
+| `pachca files get` | Скачивание файла |
 | `pachca files uploads` | Получение подписи, ключа и других параметров |
 
+### drafts
+
+| Команда | Описание |
+|---------|---------|
+| `pachca drafts create` | Новый черновик |
+| `pachca drafts list` | Список черновиков |
+| `pachca drafts get` | Информация о черновике |
+| `pachca drafts update` | Редактирование черновика |
+| `pachca drafts delete` | Удаление черновика |
+
 ### group-tags
 
 | Команда | Описание |
 |---------|---------|
 | `pachca group-tags create` | Новый тег |
-| `pachca group-tags list` | Список тегов сотрудников |
+| `pachca group-tags list` | Список тегов |
 | `pachca group-tags get` | Информация о теге |
 | `pachca group-tags update` | Редактирование тега |
 | `pachca group-tags delete` | Удаление тега |
@@ -231,6 +242,7 @@ pachca guide            # список всех сценариев
 | Команда | Описание |
 |---------|---------|
 | `pachca views open` | Открытие представления |
+| `pachca views submit-response` | Ответ на отправку формы |
 
 <!-- AUTO:COMMANDS:END -->
 

package/dist/client.js

@@ -84,12 +84,12 @@ const MAX_RETRY_AFTER_MS = 60_000;
  */
 function parseRetryAfter(header) {
     if (!header)
-        return 1000;
+        return null;
     const seconds = Number.parseInt(header, 10);
     const ms = Number.isNaN(seconds) ? Date.parse(header) - Date.now() : seconds * 1000;
     if (Number.isNaN(ms))
-        return 1000;
-    return Math.min(Math.max(ms, 0), MAX_RETRY_AFTER_MS);
+        return null;
+    return Math.max(ms, 0);
 }
 export async function request(opts, clientFlags) {
     const url = buildUrl(opts.path, opts.query);
@@ -160,12 +160,22 @@ export async function request(opts, clientFlags) {
             // Handle rate limiting (429). Safe for any method: a throttled request
             // was rejected before it was processed, so it cannot have been committed.
             if (response.status === 429 && !noRetry && attempt < MAX_RETRIES) {
-                const waitMs = parseRetryAfter(response.headers.get('retry-after'));
-                if (clientFlags?.verbose) {
-                    process.stderr.write(`${ansis.dim(`⏳ Rate limited, retrying in ${waitMs}ms...`)}\n`);
+                const retryAfterMs = parseRetryAfter(response.headers.get('retry-after'));
+                // Дольше минуты ждут только суточный предел чата и часовой бан. Раньше мы
+                // зажимали ожидание минутой и повторяли — а повтор внутри паузы её удваивает,
+                // так что три попытки превращали час в восемь. Теперь такой ответ уходит
+                // вызывающему как есть: в нём Retry-After, и когда вернуться, решает он.
+                const waitsTooLong = retryAfterMs !== null && retryAfterMs > MAX_RETRY_AFTER_MS;
+                if (!waitsTooLong) {
+                    // Retry-After — это минимум ожидания, а не оценка: ждать меньше нельзя.
+                    const base = retryAfterMs ?? 1000;
+                    const waitMs = Math.round(base * (1 + Math.random() * 0.25));
+                    if (clientFlags?.verbose) {
+                        process.stderr.write(`${ansis.dim(`⏳ Rate limited, retrying in ${waitMs}ms...`)}\n`);
+                    }
+                    await sleep(waitMs);
+                    continue;
                 }
-                await sleep(waitMs);
-                continue;
             }
             // Handle 503 with backoff. Unlike 429, a 503 from a proxy or a draining
             // load balancer says nothing about whether the backend already committed
@@ -185,6 +195,11 @@ export async function request(opts, clientFlags) {
             if (response.status === 204 || response.headers.get('content-length') === '0') {
                 data = null;
             }
+            else if (opts.isBinary && response.ok) {
+                // Тело файла нельзя читать как текст: любой байт вне UTF-8 портится
+                // при декодировании, и сохранённый файл оказывается битым.
+                data = Buffer.from(await response.arrayBuffer());
+            }
             else if (contentType.includes('application/json')) {
                 data = await response.json();
             }

package/dist/commands/chats/list.js

@@ -36,10 +36,10 @@ export default class ChatsList extends BaseCommand {
             allowNo: true,
         }),
         'last-message-at-after': Flags.string({
-            description: "Фильтрация по времени создания последнего сообщения. Будут возвращены те чаты, время последнего созданного сообщения в которых не раньше чем указанное (в формате YYYY-MM-DDThh:mm:ss.sssZ).",
+            description: "Фильтрация по времени создания последнего сообщения: вернутся чаты, где оно позже указанного. Значение в ISO-8601, смещение вида `+03:00` учитывается, время без смещения считается UTC.",
         }),
         'last-message-at-before': Flags.string({
-            description: "Фильтрация по времени создания последнего сообщения. Будут возвращены те чаты, время последнего созданного сообщения в которых не позже чем указанное (в формате YYYY-MM-DDThh:mm:ss.sssZ).",
+            description: "Фильтрация по времени создания последнего сообщения: вернутся чаты, где оно раньше указанного. Значение в ISO-8601, смещение вида `+03:00` учитывается, время без смещения считается UTC.",
         }),
         'personal': Flags.boolean({
             description: "Фильтрация по личным и групповым чатам. Если параметр не указан, возвращаются любые чаты.",

package/dist/commands/chats/request-export.js

@@ -12,18 +12,18 @@ export default class ChatsRequestExport extends BaseCommand {
     static plan = "corporation";
     static apiMethod = "POST";
     static apiPath = "/chats/exports";
-    static requiredFlags = ["start-at", "end-at", "webhook-url"];
+    static requiredFlags = ["start-at", "end-at"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
         'start-at': Flags.string({
-            description: "Дата начала для экспорта (ISO-8601, UTC+0) в формате YYYY-MM-DD",
+            description: "Дата начала для экспорта в формате YYYY-MM-DD. Если прислать дату со временем, время молча отбрасывается — экспорт всегда идёт по календарным дням.",
         }),
         'end-at': Flags.string({
-            description: "Дата окончания для экспорта (ISO-8601, UTC+0) в формате YYYY-MM-DD",
+            description: "Дата окончания для экспорта в формате YYYY-MM-DD, включительно. Если прислать дату со временем, время молча отбрасывается.",
         }),
         'webhook-url': Flags.string({
-            description: "Адрес, на который будет отправлен вебхук по завершению экспорта",
+            description: "Адрес, на который придёт вебхук с номером готовой выгрузки. Без него узнать номер неоткуда: заказавший получит письмо и уведомление, а вызывающая программа — ничего.",
         }),
         'chat-ids': Flags.string({
             description: "Массив идентификаторов чатов. Указывается, если нужно получить сообщения только некоторых чатов.",
@@ -37,9 +37,8 @@ export default class ChatsRequestExport extends BaseCommand {
         const { args, flags } = await this.parse(ChatsRequestExport);
         this.parsedFlags = flags;
         const missingRequired = [
-            { flag: 'start-at', label: "Дата начала для экспорта (ISO-8601, UTC+0) в формате YYYY-MM-DD", type: 'string' },
-            { flag: 'end-at', label: "Дата окончания для экспорта (ISO-8601, UTC+0) в формате YYYY-MM-DD", type: 'string' },
-            { flag: 'webhook-url', label: "Адрес, на который будет отправлен вебхук по завершению экспорта", type: 'string' },
+            { flag: 'start-at', label: "Дата начала для экспорта в формате YYYY-MM-DD. Если прислать дату со временем, время молча отбрасывается — экспорт всегда идёт по календарным дням.", type: 'string' },
+            { flag: 'end-at', label: "Дата окончания для экспорта в формате YYYY-MM-DD, включительно. Если прислать дату со временем, время молча отбрасывается.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {
@@ -61,7 +60,7 @@ export default class ChatsRequestExport extends BaseCommand {
                 }
             }
             else {
-                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --start-at <string>, --end-at <string>, --webhook-url <string>. pachca introspect chats request-export" });
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --start-at <string>, --end-at <string>. pachca introspect chats request-export" });
             }
         }
         const body = {

package/dist/commands/drafts/create.js

@@ -0,0 +1,98 @@
+// 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 DraftsCreate extends BaseCommand {
+    static description = "Новый черновик";
+    static examples = [
+        "Отправить сообщение позже или по расписанию — Создай отложенное сообщение: `schedule.start_date` — когда отправить, `schedule.repetition.interval` — как повторять (`once`, если один раз):\n  $ pachca drafts create"
+    ];
+    static scope = "drafts:write";
+    static apiMethod = "POST";
+    static apiPath = "/drafts";
+    static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
+    static requiredFlags = ["entity-type", "entity-id"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'entity-type': Flags.string({
+            description: "Куда пишется черновик: в беседу или канал, в тред либо в личную переписку с сотрудником",
+        }),
+        'entity-id': Flags.integer({
+            description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника (pachca chats list | pachca users list)",
+        }),
+        'content': Flags.string({
+            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может.",
+        }),
+        'parent-message-id': Flags.integer({
+            description: "Идентификатор сообщения, ответом на которое уйдёт черновик. Сообщение должно быть в том же чате.",
+        }),
+        'files': Flags.string({
+            description: "Прикрепляемые файлы, не больше десяти",
+        }),
+        'schedule': Flags.string({
+            description: "Расписание отправки. С ним создаётся отложенное сообщение, без него — обычный черновик.",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(DraftsCreate);
+        this.parsedFlags = flags;
+        // Read from stdin if --content not provided and stdin is not TTY
+        if (!flags['content'] && !process.stdin.isTTY) {
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+        }
+        const missingRequired = [
+            { flag: 'entity-type', label: "Куда пишется черновик: в беседу или канал, в тред либо в личную переписку с сотрудником", type: 'string' },
+            { flag: 'entity-id', label: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника", type: 'integer' },
+        ].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: "Обязательные: --entity-type <string>, --entity-id <integer>. pachca introspect drafts create" });
+            }
+        }
+        const body = { draft: {
+                entity_type: flags['entity-type'],
+                entity_id: flags['entity-id'],
+                content: flags['content'],
+                parent_message_id: flags['parent-message-id'],
+                files: flags['files'] ? this.parseJSON(flags['files'], 'files') : undefined,
+                schedule: flags['schedule'] ? this.parseJSON(flags['schedule'], 'schedule') : undefined,
+            } };
+        // Clean undefined fields
+        const inner = body['draft'];
+        for (const [k, v] of Object.entries(inner)) {
+            if (v === undefined)
+                delete inner[k];
+        }
+        const { data } = await this.apiRequest({
+            method: 'POST',
+            path: '/drafts',
+            body,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/drafts/delete.js

@@ -0,0 +1,45 @@
+// 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 DraftsDelete extends BaseCommand {
+    static description = "Удаление черновика";
+    static examples = [
+        "Отправить сообщение позже или по расписанию — Чтобы отменить отправку — удали отложенное сообщение:\n  $ pachca drafts delete"
+    ];
+    static scope = "drafts:write";
+    static apiMethod = "DELETE";
+    static apiPath = "/drafts/{id}";
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор черновика",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            description: 'Пропустить подтверждение',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(DraftsDelete);
+        this.parsedFlags = flags;
+        if (!flags.force) {
+            if (!this.isInteractive()) {
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca drafts delete <id> --force" });
+            }
+            const confirm = await clack.confirm({ message: 'Вы уверены?' });
+            if (clack.isCancel(confirm) || !confirm) {
+                process.stderr.write('Отменено.\n');
+                this.exit(0);
+            }
+        }
+        const { data } = await this.apiRequest({
+            method: 'DELETE',
+            path: `/drafts/${args.id}`,
+        });
+        this.success('Удалено');
+    }
+}

package/dist/commands/drafts/get.js

@@ -0,0 +1,30 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class DraftsGet extends BaseCommand {
+    static description = "Информация о черновике";
+    static scope = "drafts:read";
+    static apiMethod = "GET";
+    static apiPath = "/drafts/{id}";
+    static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор черновика",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(DraftsGet);
+        this.parsedFlags = flags;
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: `/drafts/${args.id}`,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/drafts/list.js

@@ -0,0 +1,107 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class DraftsList extends BaseCommand {
+    static description = "Список черновиков";
+    static scope = "drafts:read";
+    static apiMethod = "GET";
+    static apiPath = "/drafts";
+    static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'type': Flags.string({
+            description: "Что возвращать: `regular` — обычные черновики, `scheduled` — отложенные сообщения, `all` — и те и другие",
+            options: ["regular", "scheduled", "all"],
+            default: "regular",
+        }),
+        'entity-type': Flags.string({
+            description: "Тип чата для фильтра по одному чату. Указывается вместе с `entity_id`: если прислать только один из двух, ответ будет `422`.",
+            options: ["discussion", "thread", "user"],
+        }),
+        'entity-id': Flags.integer({
+            description: "Идентификатор того, что названо в `entity_type`. Указывается вместе с ним.",
+        }),
+        limit: Flags.integer({
+            description: 'Количество результатов на страницу',
+        }),
+        cursor: Flags.string({
+            description: 'Курсор для следующей страницы',
+        }),
+        all: Flags.boolean({
+            description: 'Загрузить все страницы автоматически',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(DraftsList);
+        this.parsedFlags = flags;
+        if (flags.all) {
+            // Auto-pagination
+            const allData = [];
+            let nextCursor = undefined;
+            let pages = 0;
+            const seenCursors = new Set();
+            while (pages < 500) {
+                const query = {
+                    type: flags['type'],
+                    'entity_type': flags['entity-type'],
+                    'entity_id': flags['entity-id'],
+                    limit: flags.limit,
+                    cursor: nextCursor,
+                };
+                const response = await this.apiRequest({ method: 'GET', path: '/drafts', query });
+                const body = response.data;
+                const items = body.data;
+                if (items)
+                    allData.push(...items);
+                const meta = body.meta;
+                const paginate = meta?.paginate;
+                nextCursor = paginate?.next_page;
+                pages++;
+                // Условие конца: списочные методы — has_next === false; методы поиска и /users?query= (без has_next) — пустой data
+                const hasNext = paginate?.has_next;
+                if (typeof hasNext === 'boolean') {
+                    if (!hasNext)
+                        break;
+                }
+                else if (!items || items.length === 0) {
+                    break;
+                }
+                if (process.stderr.isTTY) {
+                    const total = paginate?.total;
+                    const progress = total ? `${allData.length} / ${total}` : String(allData.length);
+                    process.stderr.write(`\r  Загружено: ${progress}...`);
+                }
+                if (!nextCursor)
+                    break;
+                if (seenCursors.has(nextCursor)) {
+                    process.stderr.write('\n⚠ Обнаружен цикл пагинации, остановка.\n');
+                    break;
+                }
+                seenCursors.add(nextCursor);
+            }
+            if (pages >= 500) {
+                process.stderr.write('\n⚠ Достигнут лимит 500 страниц.\n');
+            }
+            if (process.stderr.isTTY)
+                process.stderr.write('\n');
+            this.output(allData);
+            return;
+        }
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: '/drafts',
+            query: {
+                type: flags['type'],
+                'entity_type': flags['entity-type'],
+                'entity_id': flags['entity-id'],
+                limit: flags.limit,
+                cursor: flags.cursor,
+            },
+        });
+        const responseBody = (data ?? {});
+        const items = responseBody.data ?? responseBody;
+        this.output(items);
+    }
+}

package/dist/commands/drafts/update.js

@@ -0,0 +1,66 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class DraftsUpdate extends BaseCommand {
+    static description = "Редактирование черновика";
+    static scope = "drafts:write";
+    static apiMethod = "PUT";
+    static apiPath = "/drafts/{id}";
+    static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор черновика",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'content': Flags.string({
+            description: "Текст черновика",
+        }),
+        'parent-message-id': Flags.integer({
+            description: "Идентификатор сообщения, ответом на которое уйдёт черновик. `null` снимает ответ.",
+        }),
+        'files': Flags.string({
+            description: "Прикрепляемые файлы, не больше десяти. Переданный массив заменяет прежний состав: пустой снимает все вложения, а чтобы сохранить уже прикреплённый файл, передайте его с `id`. Без этого поля вложения остаются как были.",
+        }),
+        'schedule': Flags.string({
+            description: "Расписание отправки. У обычного черновика оно превращает его в отложенное сообщение. У отложенного расписание можно изменить, но не снять: `null` в ответ даст `422` с кодом `draft_type_change_forbidden`.",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(DraftsUpdate);
+        this.parsedFlags = flags;
+        // Read from stdin if --content not provided and stdin is not TTY
+        if (!flags['content'] && !process.stdin.isTTY) {
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+        }
+        const body = { draft: {
+                content: flags['content'],
+                parent_message_id: flags['parent-message-id'],
+                files: flags['files'] ? this.parseJSON(flags['files'], 'files') : undefined,
+                schedule: flags['schedule'] ? this.parseJSON(flags['schedule'], 'schedule') : undefined,
+            } };
+        // Clean undefined fields
+        const inner = body['draft'];
+        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: `/drafts/${args.id}`,
+            body,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/files/get.js

@@ -0,0 +1,43 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as fs from 'node:fs';
+import { formatSize } from '../../utils.js';
+export default class FilesGet extends BaseCommand {
+    static description = "Скачивание файла";
+    static scope = "files:read";
+    static apiMethod = "GET";
+    static apiPath = "/files/{id}";
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор файла из поля `id` вложения",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'target': Flags.string({
+            description: "Что отдать вместо исходного файла: `pdf_preview` — документ, переведённый в PDF, `pdf_first_page` — первая страница картинкой, `thumb` — уменьшенная копия изображения, `image` — изображение как есть. Без параметра приходит исходный файл. Вариант, которого у этого файла нет, приводит к `400`.",
+            options: ["pdf_preview", "pdf_first_page", "thumb", "image"],
+        }),
+        save: Flags.string({
+            description: 'Путь для сохранения файла',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FilesGet);
+        this.parsedFlags = flags;
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: `/files/${args.id}`,
+            query: {
+                target: flags['target'],
+            },
+            isBinary: true,
+        });
+        const fileBody = Buffer.isBuffer(data) ? data : Buffer.from(String(data ?? ''));
+        fs.writeFileSync(flags.save, fileBody);
+        this.success(`Сохранено: ${flags.save} (${formatSize(fileBody.length)})`);
+    }
+}

package/dist/commands/group-tags/list.js

@@ -2,7 +2,7 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class GroupTagsList extends BaseCommand {
-    static description = "Список тегов сотрудников";
+    static description = "Список тегов";
     static examples = [
         "Получить всех сотрудников тега/департамента — Найди тег по названию, возьми `id`:\n  $ pachca group-tags list"
     ];

package/dist/commands/members/leave.js

@@ -3,7 +3,7 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class MembersLeave extends BaseCommand {
-    static description = "Выход из беседы или канала";
+    static description = "Выход из чата";
     static examples = [
         "Архивация и управление чатом — Покинуть чат:\n  $ pachca members leave"
     ];

package/dist/commands/messages/create.js

@@ -21,7 +21,7 @@ export default class MessagesCreate extends BaseCommand {
             description: "Тип сущности. Регистр значения не учитывается. Значение вне списка возвращает `400` с кодом `invalid`.",
         }),
         'entity-id': Flags.integer({
-            description: "Идентификатор сущности (pachca chats list | pachca users list)",
+            description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника. (pachca chats list | pachca users list)",
         }),
         'content': Flags.string({
             description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`).",
@@ -33,7 +33,7 @@ export default class MessagesCreate extends BaseCommand {
             description: "Массив строк, каждая из которых представлена массивом кнопок. Максимум 100 кнопок у сообщения, до 8 кнопок в строке.",
         }),
         'parent-message-id': Flags.integer({
-            description: "Идентификатор сообщения. Указывается в случае, если вы отправляете ответ на другое сообщение.",
+            description: "Идентификатор сообщения, на которое отвечаете. Ответ появится прямо в ленте чата, а не в треде: для треда отправляйте сообщение с `entity_type: \"thread\"`.",
         }),
         'display-avatar-url': Flags.string({
             description: "Ссылка на специальную аватарку отправителя для этого сообщения. Использование этого поля возможно только с access_token бота. (макс. 255 символов)",
@@ -62,7 +62,7 @@ export default class MessagesCreate extends BaseCommand {
             flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
         }
         const missingRequired = [
-            { flag: 'entity-id', label: "Идентификатор сущности", type: 'integer' },
+            { flag: 'entity-id', label: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника.", type: 'integer' },
             { flag: 'content', label: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`).", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {

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

@@ -22,7 +22,7 @@ export default class ProfileUpdateStatus extends BaseCommand {
             description: "Текст статуса (макс. 50 символов)",
         }),
         'expires-at': Flags.string({
-            description: "Срок жизни статуса (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ",
+            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Сюда идёт срок, названный словами: «до трёх» это значение поля, а не часть подписи.",
         }),
         'is-away': Flags.boolean({
             description: "Режим «Нет на месте»",