@pachca/cli 2026.10.3 → 2026.11.0

package/dist/commands/messages/list.js

@@ -79,6 +79,7 @@ export default class MessagesList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'chat_id': flags['chat-id'],
@@ -96,7 +97,7 @@ export default class MessagesList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -106,7 +107,8 @@ export default class MessagesList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/messages/update.js

@@ -16,7 +16,7 @@ export default class MessagesUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'content': Flags.string({
-            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов.",
+            description: "Текст сообщения. Поддерживает упоминания: `@nickname` или `<@user_id>` (будет автоматически преобразовано в `@nickname`). Ник берут из ответа метода, а `user_id` — из данных: ник, составленный из имени, никого не упоминает. У мульти-гостя `<@user_id>` недоступного ему сотрудника остаётся в тексте как есть. До 40 000 байт в UTF-8, для кириллицы это около 20 000 символов.",
         }),
         'files': Flags.string({
             description: "Прикрепляемые файлы. Переданный набор заменяет прежний: чтобы оставить уже приложенный файл, передайте его снова с тем же `key`. Такой файл остаётся прежним вложением с тем же `id` и названием, а его поля из запроса не применяются. Чтобы показать файл под другим названием, загрузите его заново.",
@@ -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() {
@@ -40,7 +40,19 @@ export default class MessagesUpdate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            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'],

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

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

package/dist/commands/reactions/add.js

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

package/dist/commands/reactions/list.js

@@ -35,6 +35,7 @@ export default class ReactionsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     limit: flags.limit,
@@ -49,7 +50,7 @@ export default class ReactionsList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -59,7 +60,8 @@ export default class ReactionsList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/reactions/remove.js

@@ -7,7 +7,6 @@ export default class ReactionsRemove extends BaseCommand {
     static scope = "reactions:write";
     static apiMethod = "DELETE";
     static apiPath = "/messages/{id}/reactions";
-    static requiredFlags = ["code"];
     static args = {
         id: Args.integer({
             description: "Идентификатор сообщения",
@@ -17,7 +16,7 @@ export default class ReactionsRemove extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'code': Flags.string({
-            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.",
+            description: "Emoji символ реакции. Обязателен без `name`: нужен именно символ, текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` не используется.",
         }),
         'name': Flags.string({
             description: "Имя реакции, как в её поле `name`. С ним реакция ищется по имени, так снимается и кастомный эмодзи пространства.",
@@ -30,32 +29,6 @@ export default class ReactionsRemove extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(ReactionsRemove);
         this.parsedFlags = flags;
-        const missingRequired = [
-            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.", type: 'string' },
-        ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
-        if (missingRequired.length > 0) {
-            if (this.isInteractive()) {
-                for (const field of missingRequired) {
-                    const value = await clack.text({ message: field.label, validate: (v) => v.length === 0 ? 'Обязательное поле' : undefined });
-                    if (clack.isCancel(value)) {
-                        process.stderr.write('Отменено.\n');
-                        this.exit(0);
-                    }
-                    if (field.type === 'integer') {
-                        flags[field.flag] = Number.parseInt(value, 10);
-                    }
-                    else if (field.type === 'boolean') {
-                        flags[field.flag] = value === 'true';
-                    }
-                    else {
-                        flags[field.flag] = value;
-                    }
-                }
-            }
-            else {
-                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --code <string>. pachca introspect reactions remove" });
-            }
-        }
         if (!flags.force) {
             if (!this.isInteractive()) {
                 this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca reactions remove <id> --force" });

package/dist/commands/read-member/list-readers.js

@@ -34,6 +34,7 @@ export default class ReadMemberListReaders extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     limit: flags.limit,
@@ -48,7 +49,7 @@ export default class ReadMemberListReaders extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -58,7 +59,8 @@ export default class ReadMemberListReaders extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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

@@ -11,7 +11,7 @@ export default class SearchListChats extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Запрос длиннее 256 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",
@@ -55,6 +55,7 @@ export default class SearchListChats extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -76,7 +77,7 @@ export default class SearchListChats extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -86,7 +87,8 @@ export default class SearchListChats extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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

@@ -11,7 +11,7 @@ export default class SearchListMessages extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Без него сообщения отбираются только фильтрами. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Без него сообщения отбираются только фильтрами. Запрос длиннее 256 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",
@@ -58,6 +58,7 @@ export default class SearchListMessages extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -80,7 +81,7 @@ export default class SearchListMessages extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -90,7 +91,8 @@ export default class SearchListMessages extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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

@@ -11,7 +11,7 @@ export default class SearchListUsers extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Запрос длиннее 256 знаков обрезается.",
         }),
         'sort': Flags.string({
             description: "Сортировка результатов",
@@ -50,6 +50,7 @@ export default class SearchListUsers extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -70,7 +71,7 @@ export default class SearchListUsers extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -80,7 +81,8 @@ export default class SearchListUsers extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/security/list.js

@@ -22,7 +22,7 @@ export default class SecurityList extends BaseCommand {
             options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_2fa_disabled", "login_grant_created", "login_grant_approved", "login_grant_denied", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "company_chats_accessed", "company_bots_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated", "bot_deleted", "bot_oauth_client_updated", "bot_oauth_client_disabled", "bot_oauth_client_secret_rotated", "bot_oauth_client_secret_issued", "bot_token_created", "bot_token_updated", "bot_token_reissued", "bot_token_deleted", "oauth_authorization_granted", "oauth_authorization_revoked", "oauth_token_revoked", "oauth_device_authorization_approved", "oauth_device_authorization_denied", "video_call_started", "video_call_finished", "video_call_recording_ready", "exchange_disabled"],
         }),
         'actor-id': Flags.string({
-            description: "Идентификатор пользователя, выполнившего действие",
+            description: "Идентификатор актора события, как в поле `actor_id` записи. Смену роли, добавление в чат и исключение из чата, назначение и снятие тегов фильтр находит по сотруднику, которого они коснулись.",
         }),
         'actor-type': Flags.string({
             description: "Тип актора",
@@ -53,6 +53,7 @@ export default class SecurityList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'start_time': flags['start-time'],
@@ -74,7 +75,7 @@ export default class SecurityList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -84,7 +85,8 @@ export default class SecurityList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/tasks/create.js

@@ -1,14 +1,12 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import * as clack from '@clack/prompts';
 export default class TasksCreate extends BaseCommand {
     static description = "Новое напоминание";
     static scope = "tasks:create";
     static apiMethod = "POST";
     static apiPath = "/tasks";
     static defaultColumns = ["id", "content", "created_at", "kind", "due_at"];
-    static requiredFlags = ["kind"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -47,33 +45,9 @@ export default class TasksCreate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
-        }
-        const missingRequired = [
-            { flag: 'kind', label: "Тип", type: 'string' },
-        ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
-        if (missingRequired.length > 0) {
-            if (this.isInteractive()) {
-                for (const field of missingRequired) {
-                    const value = await clack.text({ message: field.label, validate: (v) => v.length === 0 ? 'Обязательное поле' : undefined });
-                    if (clack.isCancel(value)) {
-                        process.stderr.write('Отменено.\n');
-                        this.exit(0);
-                    }
-                    if (field.type === 'integer') {
-                        flags[field.flag] = Number.parseInt(value, 10);
-                    }
-                    else if (field.type === 'boolean') {
-                        flags[field.flag] = value === 'true';
-                    }
-                    else {
-                        flags[field.flag] = value;
-                    }
-                }
-            }
-            else {
-                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --kind <string>. pachca introspect tasks create" });
-            }
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const body = { task: {
                 kind: flags['kind'],

package/dist/commands/tasks/list.js

@@ -43,6 +43,7 @@ export default class TasksList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     status: flags['status'],
@@ -61,7 +62,7 @@ export default class TasksList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -71,7 +72,8 @@ export default class TasksList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/tasks/update.js

@@ -38,7 +38,7 @@ export default class TasksUpdate extends BaseCommand {
             allowNo: true,
         }),
         'done-at': Flags.string({
-            description: "Дата и время выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, отметку о выполнении снимает: ответ придёт успешный, а в нём `done_at` будет `null`.",
+            description: "Дата и время выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, отметку о выполнении снимает: ответ придёт успешный, а в нём `status` будет `undone`.",
         }),
         'custom-properties': Flags.string({
             description: "Задаваемые дополнительные поля",
@@ -53,7 +53,9 @@ export default class TasksUpdate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const body = { task: {
                 kind: flags['kind'],

package/dist/commands/threads/list.js

@@ -36,6 +36,7 @@ export default class ThreadsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'last_message_at_after': flags['last-message-at-after'],
@@ -52,7 +53,7 @@ export default class ThreadsList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -62,7 +63,8 @@ export default class ThreadsList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/upload.js

@@ -1,4 +1,4 @@
-import { Args } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { BaseCommand } from '../base-command.js';
@@ -6,7 +6,8 @@ export default class Upload extends BaseCommand {
     static description = 'Загрузить файл (получает подпись и загружает автоматически)';
     static examples = [
         '<%= config.bin %> upload photo.jpg',
-        'cat data.csv | <%= config.bin %> upload -',
+        'cat data.csv | <%= config.bin %> upload - --name data.csv',
+        '<%= config.bin %> upload ./build/out.pdf --name report.pdf',
     ];
     static scope = 'uploads:write';
     static args = {
@@ -17,10 +18,20 @@ export default class Upload extends BaseCommand {
     };
     static flags = {
         ...BaseCommand.baseFlags,
+        name: Flags.string({
+            description: 'Имя файла, которым заканчивается key. Расширение name при отправке файла в сообщении должно совпадать с расширением этого имени. По умолчанию это имя загружаемого файла, а у данных из stdin имя stdin без расширения',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(Upload);
         this.parsedFlags = flags;
+        const fromStdin = args.file === '-';
+        if (flags.name !== undefined && !isPlainFileName(flags.name)) {
+            this.validationError([{ message: 'Имя файла в --name не может быть пустым и содержать / или \\', flag: 'name' }], { type: 'PACHCA_USAGE_ERROR' });
+        }
+        if (!fromStdin && !fs.existsSync(args.file)) {
+            this.validationError([{ message: `Файл не найден: ${args.file}` }], { type: 'PACHCA_USAGE_ERROR' });
+        }
         // Step 1: Get upload params
         const { data: uploadData } = await this.apiRequest({
             method: 'POST',
@@ -30,19 +41,18 @@ export default class Upload extends BaseCommand {
         // Step 2: Read file
         let fileBlob;
         let fileName;
-        if (args.file === '-') {
+        // The key ends in this name, and the API checks the extension of `name` in
+        // a message's `files` against it. Data from stdin has no name of its own.
+        if (fromStdin) {
             const chunks = [];
             for await (const chunk of process.stdin)
                 chunks.push(chunk);
             fileBlob = new Blob([Buffer.concat(chunks)]);
-            fileName = 'stdin';
+            fileName = flags.name ?? 'stdin';
         }
         else {
-            if (!fs.existsSync(args.file)) {
-                this.validationError([{ message: `Файл не найден: ${args.file}` }], { type: 'PACHCA_USAGE_ERROR' });
-            }
             fileBlob = new Blob([fs.readFileSync(args.file)]);
-            fileName = path.basename(args.file);
+            fileName = flags.name ?? path.basename(args.file);
         }
         // Step 3: Replace ${filename} in key
         const key = params.key.replace('${filename}', fileName);
@@ -67,7 +77,16 @@ export default class Upload extends BaseCommand {
             formData,
             noAuth: true,
         });
+        // Said after the upload succeeds, so a failed one does not report a file as uploaded.
+        if (fromStdin && flags.name === undefined && !flags.quiet) {
+            process.stderr.write('⚠ Файл из stdin загружен под именем stdin без расширения: в name файла в сообщении расширения тоже не должно быть.\n' +
+                '  Имя с расширением задаёт флаг --name, например --name report.csv\n');
+        }
         // Output the key for use in messages
         this.output({ key });
     }
 }
+/** A bare file name: the key keeps its folder, so a path separator would move the file out of it. */
+function isPlainFileName(name) {
+    return name.trim() !== '' && !/[\\/]/.test(name);
+}

package/dist/commands/users/create.js

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