@pachca/cli 2026.9.1 → 2026.10.1

package/dist/data/workflows.json

@@ -158,7 +158,7 @@
                 "notes": "`last_message_at_after`/`last_message_at_before` — ISO-8601, UTC+0. `limit` 1-50 (по умолчанию 50). Сортировка — по убыванию времени последнего сообщения."
             },
             {
-                "description": "Если в ответе `meta.paginate.next_page` — пройди по страницам через `--cursor`",
+                "description": "Пока `meta.paginate.has_next` равен `true`, бери следующую страницу через `--cursor=<next_page>`",
                 "command": "pachca threads list --last-message-at-after=2026-05-19T00:00:00.000Z --cursor=<next_page>"
             },
             {
@@ -343,6 +343,21 @@
             }
         ]
     },
+    {
+        "title": "Поставить или убрать аватар чата",
+        "skill": "pachca-chats",
+        "steps": [
+            {
+                "description": "Загрузи аватар беседы или канала",
+                "command": "pachca chats update-avatar <ID> --file=<путь_к_файлу>",
+                "notes": "Файл передается в формате multipart/form-data: jpg, jpeg, png или gif. У личного чата и треда аватара нет — ответ 403"
+            },
+            {
+                "description": "Чтобы убрать аватар, удали его",
+                "command": "pachca chats remove-avatar <ID> --force"
+            }
+        ]
+    },
     {
         "title": "Создать проектную беседу из шаблона",
         "skill": "pachca-chats",
@@ -362,13 +377,13 @@
         "skill": "pachca-chats",
         "steps": [
             {
-                "description": "Запроси экспорт",
-                "command": "pachca chats request-export --start-at=<YYYY-MM-DD> --end-at=<YYYY-MM-DD> --webhook-url=<URL>",
-                "notes": "`start_at`, `end_at` (YYYY-MM-DD). Запрос асинхронный: ответ приходит пустым, без номера выгрузки. `webhook_url` формально не обязателен, но без него номер взять неоткуда — присылай его всегда"
+                "description": "Запроси экспорт и возьми номер выгрузки из `data.id`",
+                "command": "pachca chats request-export --start-at=<YYYY-MM-DD> --end-at=<YYYY-MM-DD>",
+                "notes": "`start_at`, `end_at` (YYYY-MM-DD). Номер приходит с заголовком `Prefer: return=representation` и ответом `202`, CLI и SDK шлют его сами. Без заголовка ответ `204` без тела"
             },
             {
                 "description": "Скачай файл экспорта",
-                "command": "pachca chats download-export <export_id>",
+                "command": "pachca chats download-export <id>",
                 "notes": "Сервер вернёт 302, HTTP-клиент скачает файл автоматически"
             }
         ]
@@ -456,12 +471,44 @@
         "skill": "pachca-bots",
         "steps": [
             {
-                "description": "Пользовательским токеном (администратор, владелец компании или создатель бота) — перевыпусти токен по `id` бота. Прежний токен инвалидируется сразу",
+                "description": "Пользовательским токеном (создатель бота или администратор, если бот открыт администраторам) — перевыпусти основной токен по `id` бота: тот, что без имени, а если такого нет, самый старый. Прежнее значение инвалидируется сразу",
                 "command": "pachca bots recreate-token <bot_id>"
             },
             {
-                "description": "Или: бот перевыпускает собственный токен своим же токеном (скоуп `bot_self:write`). Токен, которым выполнен запрос, инвалидируется сразу — обязательно сохрани новый `access_token` из ответа, иначе бот потеряет доступ к API",
+                "description": "Или: бот перевыпускает свой основной токен сам (скоуп `bot_self:write`). Если запрос сделан основным токеном, он инвалидируется сразу — обязательно сохрани новый `access_token` из ответа, иначе бот потеряет доступ к API",
                 "command": "pachca bots recreate-token-self"
+            },
+            {
+                "description": "Отдельный токен бота перевыпускай по его `id` из `pachca bots list-tokens`: значение меняется, имя и права остаются",
+                "command": "pachca bots reissue-token <bot_id> <token_id>"
+            }
+        ]
+    },
+    {
+        "title": "Выпустить боту отдельный токен",
+        "skill": "pachca-bots",
+        "steps": [
+            {
+                "description": "Пользовательским токеном (создатель бота или администратор, если бот открыт администраторам) получи каталог прав, которые можно выдать этому боту",
+                "command": "pachca bots list-scopes <bot_id>"
+            },
+            {
+                "description": "Выпусти токен с именем и правами из каталога. Без `--scopes` токен выпускается без прав, право не из каталога отклоняется с `400`",
+                "command": "pachca bots create-token <bot_id> --name=\"Сервер уведомлений\" --scopes='[\"messages:create\"]'"
+            }
+        ]
+    },
+    {
+        "title": "Включить боту авторизацию от имени сотрудника",
+        "skill": "pachca-bots",
+        "steps": [
+            {
+                "description": "Пользовательским токеном (создатель бота или администратор, если бот открыт администраторам) включи авторизацию: где хранится секрет, адреса возврата и права, которые бот попросит у сотрудника. Права бери из `pachca bots list-scopes`",
+                "command": "pachca bots update <bot_id> --oauth-client='{\"confidential\":true,\"redirect_uris\":[\"https://example.com/oauth/callback\"],\"scopes\":[\"messages:read\",\"messages:create\"]}'"
+            },
+            {
+                "description": "Чтобы бот появился в витрине, добавь описание и опубликуй страницу",
+                "command": "pachca bots update <bot_id> --promo='{\"description\":\"Собирает сводку по задачам\",\"published\":true}'"
             }
         ]
     },
@@ -470,11 +517,11 @@
         "skill": "pachca-bots",
         "steps": [
             {
-                "description": "Пользовательским токеном (скоуп `bots:read`) получи список ботов, доступных тебе для редактирования: созданных тобой и тех, чьи настройки открывают тебе доступ. Фильтруй по имени параметром `query`, следующую страницу бери из `meta.paginate.next_page`",
+                "description": "Пользовательским токеном (скоуп `bots:read`) получи список ботов, доступных тебе для редактирования: созданных тобой и тех, чьи настройки открывают тебе доступ. Фильтруй по имени параметром `query`. Пока `meta.paginate.has_next` равен `true`, следующую страницу бери из `meta.paginate.next_page`",
                 "command": "pachca bots list --query=\"задач\""
             },
             {
-                "description": "Возьми `id` нужного бота из списка и удали его (скоуп `bots:write`). Доступно администратору, владельцу компании или создателю бота — владельцы чатов удалять бота не могут. Прежний токен инвалидируется сразу, бот исключается из всех чатов, его исходящий вебхук удаляется",
+                "description": "Возьми `id` нужного бота из списка и удали его (скоуп `bots:write`). Доступно создателю бота и администратору, если бот открыт администраторам, — владельцы чатов удалять бота не могут. Все токены бота инвалидируются сразу, бот исключается из всех чатов, его вебхуки удаляются",
                 "command": "pachca bots delete <bot_id>"
             }
         ]
@@ -539,6 +586,10 @@
         "title": "Обработка событий через историю (polling)",
         "skill": "pachca-bots",
         "steps": [
+            {
+                "description": "Включи историю событий флагом `--events-history-enabled` (Webhook URL для этого не нужен) или настройкой «Сохранять историю событий» на вкладке «Исходящий вебхук» — в интерфейсе она появляется после включения вебхука",
+                "command": "pachca bots update <bot_id> --events-history-enabled"
+            },
             {
                 "description": "Получи накопленные события",
                 "command": "pachca bots list-events --all"

package/dist/oauth.js

@@ -1,4 +1,5 @@
 import { spawn, spawnSync } from 'node:child_process';
+import * as os from 'node:os';
 import { getBaseUrl } from './client.js';
 /** Uses the global timer on purpose: `node:timers/promises` is not fakeable in tests. */
 function delay(ms) {
@@ -19,6 +20,8 @@ const DEVICE_CODE_GRANT = 'urn:ietf:params:oauth:grant-type:device_code';
 const MIN_POLL_INTERVAL_SECONDS = 5;
 /** RFC 8628: on `slow_down` the client raises its interval by 5 seconds. */
 const SLOW_DOWN_STEP_SECONDS = 5;
+/** The backend keeps a device name of at most this many characters. */
+const DEVICE_NAME_MAX_LENGTH = 255;
 export class OAuthError extends Error {
     code;
     description;
@@ -76,9 +79,31 @@ async function postForm(endpoint, params) {
     }
     return body;
 }
-/** Step 1 — ask the server for a device code and the code the user types in. */
-export async function requestDeviceCode() {
-    const body = (await postForm('device_authorization', { client_id: CLI_CLIENT_ID }));
+/**
+ * What the token list on the «API» page calls this login.
+ *
+ * Every login is a row there, revoked one by one, so the rows have to tell
+ * machines apart: the machine name, plus the profile unless it is the default —
+ * two logins from one laptop differ by nothing else. The page joins a row's
+ * fields with « · », so the profile goes in parentheses rather than after one.
+ */
+export function deviceName(profile, hostname = os.hostname()) {
+    const machine = hostname.trim().replace(/\.local$/i, '');
+    const name = profile === 'default' ? machine : machine ? `${machine} (${profile})` : profile;
+    // Counted in characters, as the backend counts them, so a cut never splits one.
+    return Array.from(name).slice(0, DEVICE_NAME_MAX_LENGTH).join('') || undefined;
+}
+/**
+ * Step 1 — ask the server for a device code and the code the user types in.
+ *
+ * A server older than device names drops the extra parameter without a word,
+ * so it is sent regardless of which server the CLI talks to.
+ */
+export async function requestDeviceCode(device) {
+    const params = { client_id: CLI_CLIENT_ID };
+    if (device)
+        params.device_name = device;
+    const body = (await postForm('device_authorization', params));
     if (!body?.device_code || !body.user_code || !body.verification_uri) {
         throw new OAuthError('invalid_response', 'Сервер вернул неполный ответ на запрос кода');
     }