@pachca/cli 2026.9.0 → 2026.10.0

package/dist/data/workflows.json

@@ -270,6 +270,26 @@
             }
         ]
     },
+    {
+        "title": "Отправить сообщение позже или по расписанию",
+        "skill": "pachca-messages",
+        "steps": [
+            {
+                "description": "Найди чат, в который нужно написать",
+                "command": "pachca search list-chats --query=\"название\""
+            },
+            {
+                "description": "Создай отложенное сообщение: `schedule.start_date` — когда отправить, `schedule.repetition.interval` — как повторять (`once`, если один раз)",
+                "command": "pachca drafts create --entity-type=discussion --entity-id=<chat_id> --content=\"Текст\" --schedule='{\"start_date\":\"2026-09-17T09:00:00Z\",\"repetition\":{\"interval\":\"once\"}}'",
+                "notes": "Время без смещения считается UTC: переведи местное время сотрудника сами или пришли со смещением. Повтор по дням недели — `interval: \"weekly\"` и `days` (0 — воскресенье). В ответе `next_send_at` — ближайшая отправка, сверься с ней."
+            },
+            {
+                "description": "Чтобы отменить отправку — удали отложенное сообщение",
+                "command": "pachca drafts delete <ID>",
+                "notes": "Другого способа отменить нет: снять расписание правкой нельзя"
+            }
+        ]
+    },
     {
         "title": "Создать канал и пригласить участников",
         "skill": "pachca-chats",
@@ -323,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",
@@ -344,7 +379,7 @@
             {
                 "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` обязателен — запрос асинхронный"
+                "notes": "`start_at`, `end_at` (YYYY-MM-DD). Запрос асинхронный: ответ приходит пустым, без номера выгрузки. `webhook_url` формально не обязателен, но без него номер взять неоткуда — присылай его всегда"
             },
             {
                 "description": "Скачай файл экспорта",
@@ -423,7 +458,7 @@
             {
                 "description": "Пользовательским токеном (с правом редактировать бота) — обнови URL по `id` бота. Пустая строка отключает вебхук",
                 "command": "pachca bots update <bot_id> --outgoing-url=\"https://example.com/webhook\"",
-                "notes": "`id` бота (его `user_id`) можно узнать во вкладке «API» настроек бота"
+                "notes": "`id` бота можно узнать методом `pachca bots list`"
             },
             {
                 "description": "Или: бот сам обновляет свой webhook своим же токеном — без `id` и без участия администратора (нужен скоуп `bot_self:webhook:write`)",
@@ -436,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}'"
             }
         ]
     },
@@ -454,7 +521,7 @@
                 "command": "pachca bots list --query=\"задач\""
             },
             {
-                "description": "Возьми `id` нужного бота из списка и удали его (скоуп `bots:write`). Доступно администратору, владельцу компании или создателю бота — владельцы чатов удалять бота не могут. Прежний токен инвалидируется сразу, бот исключается из всех чатов, его исходящий вебхук удаляется",
+                "description": "Возьми `id` нужного бота из списка и удали его (скоуп `bots:write`). Доступно создателю бота и администратору, если бот открыт администраторам, — владельцы чатов удалять бота не могут. Все токены бота инвалидируются сразу, бот исключается из всех чатов, его вебхуки удаляются",
                 "command": "pachca bots delete <bot_id>"
             }
         ]
@@ -519,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', 'Сервер вернул неполный ответ на запрос кода');
     }