@leemour/max-cli 0.14.0 → 0.15.0

package/README.md

@@ -6,7 +6,8 @@
 
 Ваши боты [MAX](https://max.ru) и ваш личный аккаунт — в терминале и в ИИ-агентах. `max` —
 программа для терминала и MCP-сервер: пишите от имени бота через официальный Bot API, а в свои
-чаты — сами или руками Claude, Codex, Cursor и других агентов.
+чаты — сами или руками Claude, Codex, Cursor и других агентов. Для групп, которые вы ведёте, —
+вопросы без ответа, новенькие и уборка спама по вашим правилам.
 
 ```sh
 max sales bot messages send "Команда продаж" "Сборка готова"   # от имени бота
@@ -22,15 +23,21 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
 ```sh
 max sales bot auth set                                   # токен — в скрытом вводе, MAX его проверит
 max sales bot me                                         # какой это бот
-max sales bot messages send -72894839451 "Сборка готова"
-max sales bot messages list -72894839451
-max sales bot recipients add -72894839451                # писать только сюда
+max sales bot api get-updates --limit 10                 # номер группы — в поле chat_id
+max sales bot messages send "Команда продаж" "Сборка готова" --file report.pdf
+max sales bot recipients add "Команда продаж"            # писать только сюда
 max bot list --check                                     # все боты на этом компьютере
 ```
 
+Чат называют по номеру или, когда бот его уже видел, по названию; человеку пишут как
+`user:<номер>`. Где взять номер чата — [docs/bot.md](docs/bot.md#где-взять-номер-чата).
+
 - **Сообщения и чаты.** Отправка в чат по номеру, человеку как `user:<номер>` или в чат по
   названию; правка, удаление, чтение, закрепление. `chats list` — чаты, которые бот видел: списка
   чатов бота у MAX нет.
+- **Файлы, участники, комментарии, кнопки, меню команд, вебхуки.** `messages send --file`,
+  `members`, `admins`, `comments`, `callbacks answer`, `commands`, `webhooks` — у каждой записи тот
+  же список получателей и журнал.
 - **Любая операция API.** Все операции Bot API доступны как `max bot api <операция>` — с флагами
   для параметров и JSON-телом, которое сверяется со схемой до отправки.
 - **Бот не напишет лишнего.** У каждого бота свой список чатов, куда ему можно писать, и журнал
@@ -76,6 +83,9 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
 - **Черновики ответов.** Агент предлагает текст, а отправляете вы — или он сам, если вы разрешили
   писать в этот чат.
 - **Поиск.** «Когда мы договорились о встрече с Иваном?» — ответ с датой и самим сообщением.
+- **Группа, которую вы ведёте.** Какие вопросы висят без ответа, кто вступил за неделю и с каким
+  аккаунтом, удалить приглашения в чужие чаты — по вашим правилам и с вашим «да»
+  ([ниже](#группы-которые-вы-ведёте)).
 
 Как это выглядит:
 
@@ -98,6 +108,21 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
 агента под каждую задачу — готовые запросы, расписание и ограничения:
 [docs/recipes.md](docs/recipes.md).
 
+## Группы, которые вы ведёте
+
+```sh
+max review --chat "Поход" --unanswered            # вопросы, на которые сутки никто не ответил
+max chats events "Поход"                          # кто вступил и вышел за неделю
+max chats members list "Поход"                    # все участники: когда заведён аккаунт
+max chats rules set "Поход" invites delete        # приглашения в чужие чаты — удалять
+max chats check "Поход" --allow-dangerous         # проверить группу и сделать, что разрешено
+```
+
+Проверка сверяет новое в группе с вашими правилами: заблокированные люди, приглашения, ссылки,
+пересланное, флуд, совсем новые аккаунты. По умолчанию она только отмечает. Для каждого действия
+вы решаете сами: никогда, только с флагом, с вашим подтверждением или сразу. Сценарии с агентом,
+все правила и ограничения — [docs/groups.md](docs/groups.md).
+
 ## Как это работает
 
 `max` работает от вашего имени, как ещё одно ваше устройство, а не как бот. Вы входите один раз
@@ -129,10 +154,12 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
   расшифровка голосовых в текст на вашем компьютере, выгрузка переписки в JSONL или Markdown.
 - **Искать.** Сообщения — по тексту всего прочитанного, без подключения к MAX. Чаты и контакты —
   по части названия или имени.
-- **Писать.** Текст и разметка, ответы, фото и файлы, правка, пересылка, закрепление, реакции,
+- **Писать.** Текст и разметка, ответы, фото, видео, файлы и голосовые, правка, пересылка, закрепление, реакции,
   отложенная отправка, удаление — у себя или у всех.
 - **Вести группы и каналы.** Создать группу, вступить по ссылке, выйти, участники и админы,
-  название и настройки, заявки на вступление, ссылка-приглашение, папки.
+  название и настройки, заявки на вступление, ссылка-приглашение, папки. Для админа — вопросы без
+  ответа, кто вступил и вышел, все участники с возрастом аккаунта, правила и проверка группы по ним
+  ([docs/groups.md](docs/groups.md)).
 - **Контакты и аккаунт.** Найти человека по номеру, добавить, удалить, импортировать из файла;
   изменить профиль; посмотреть и завершить другие сеансы.
 - **Входить удобным способом.** QR-код прямо в терминале, QR-код или SMS через web.max.ru в
@@ -145,6 +172,10 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
 - **Агент не напишет лишнего.** Есть профиль только для чтения, список чатов, в которые можно
   писать, и лимит сообщений в час. MCP-сервер может показывать вам каждое действие до того, как его выполнить.
   Если имя подходит к двум чатам, `max` не выбирает сам, а показывает оба.
+- **Модерация по вашим правилам, а не по чужим.** Проверка группы по умолчанию только отмечает.
+  Удалить сообщение или человека она может, только если вы разрешили: для каждого действия —
+  никогда, с флагом, с вашим подтверждением или сразу. Не больше 10 действий за раз, и ничего не
+  следит за группой в фоне.
 - **Сообщение не уйдёт дважды.** Если связь оборвалась во время отправки, `max` прямо говорит, что
   не знает, дошло ли сообщение, и даёт команду для повтора. MAX узнаёт повтор и второго сообщения не
   создаёт.
@@ -192,9 +223,11 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
 | удаление сообщений — у себя или у всех, с лимитом | ✅ | ✅ | — |
 | отметка «прочитано» по запросу | ✅ | ✅ | — |
 | группы и каналы: создать, вступить, участники, админы | ✅ | ✅ | чтение каналов |
+| для админа группы: вопросы без ответа, новенькие, проверка по правилам | ✅ | — | — |
 | контакты, профиль, другие сеансы | ✅ | ✅ | — |
-| отправка видео и кружков | — | ✅ | — |
-| отправка голосовых | — | ⚠️ в 2.4.1 не проходит ([#102](https://github.com/MaxApiTeam/PyMax/issues/102), [#103](https://github.com/MaxApiTeam/PyMax/issues/103)) | — |
+| отправка видео | ✅ | ✅ | — |
+| отправка кружков | — | ✅ | — |
+| отправка голосовых | ✅ | ⚠️ в 2.4.1 не проходит ([#102](https://github.com/MaxApiTeam/PyMax/issues/102), [#103](https://github.com/MaxApiTeam/PyMax/issues/103)) | — |
 | опросы | — | ✅ | — |
 | пароль и двухфакторный вход, фото профиля | — | ✅ | — |
 
@@ -205,6 +238,7 @@ max messages send "Иван Петров" "Опаздываю на 15 минут
 
 - [Бот](#бот)
 - [Личный аккаунт](#личный-аккаунт)
+- [Группы, которые вы ведёте](#группы-которые-вы-ведёте)
 - [Установка](#установка)
 - [Вход](#вход)
 - [Использование](#использование)
@@ -380,6 +414,7 @@ max chats list --json
 - [docs/sessions.md](docs/sessions.md) — токен, хранилище паролей, профили
 - [docs/configuration.md](docs/configuration.md) — настройки, переменные, порядок разрешения
 - [docs/mcp.md](docs/mcp.md) — MCP-сервер: подключение, отправка, соединение с MAX
+- [docs/groups.md](docs/groups.md) — группы, которые вы ведёте: сценарии с агентом, правила, проверка
 - [docs/recipes.md](docs/recipes.md) — рецепты для агентов: сводки, отчёты, долги, напоминания, расписание
 - [docs/diagnostics.md](docs/diagnostics.md) — `--trace`, `--record`, `max runs`
 - [docs/ROADMAP.md](docs/ROADMAP.md) — что планируется
@@ -412,7 +447,6 @@ pnpm generate                         # переписать сгенериро
 
 Ближайшее:
 
-- голосовые сообщения и видео;
 - опросы: показывать при чтении и голосовать;
 - локальная копия по желанию — можно работать совсем без неё.
 

package/dist/bot/client.d.ts

@@ -11,7 +11,7 @@ export declare class BotApiClient {
     me(): Promise<BotInfoType>;
     chat(chatId: string): Promise<Chat>;
     message(messageId: string, selfId?: string): Promise<Message>;
-    /** Newest last, as MAX returns them. */
+    /** Oldest first, like `max messages list`; MAX answers newest first (`BUG-59`). */
     messages(chatId: string, count: number, selfId?: string): Promise<Message[]>;
     /** A message from any answer — a send's result, an update — decoded the same way as a read. */
     decodeMessage(raw: unknown, selfId?: string): Message;

package/dist/bot/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/bot/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAI3D,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAyB,MAAM,sBAAsB,CAAA;AAEzF,OAAO,EAAgB,KAAK,SAAS,EAAa,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE/F,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,SAAS,iBAAiB,EAAe,CAAA;AAUrE,wEAAwE;AACxE,qBAAa,YAAY;;IAGvB,YAAY,OAAO,EAAE,gBAAgB,EAEpC;IAEK,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC,CAU/B;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxC;IAEK,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGlE;IAED,wCAAwC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAKjF;IAED,+FAA+F;IAC/F,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD;IAED,IAAI,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE;CAyCF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/bot/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAI3D,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAyB,MAAM,sBAAsB,CAAA;AAEzF,OAAO,EAAgB,KAAK,SAAS,EAAa,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE/F,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,SAAS,iBAAiB,EAAe,CAAA;AAUrE,wEAAwE;AACxE,qBAAa,YAAY;;IAGvB,YAAY,OAAO,EAAE,gBAAgB,EAEpC;IAEK,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC,CAU/B;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxC;IAEK,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGlE;IAED,mFAAmF;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAKjF;IAED,+FAA+F;IAC/F,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD;IAED,IAAI,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE;CAyCF"}

package/dist/bot/client.js

@@ -38,12 +38,12 @@ export class BotApiClient {
         const answer = await this.#transport.call(required("getMessageById"), { path: { messageId } });
         return this.#message(answer, selfId);
     }
-    /** Newest last, as MAX returns them. */
+    /** Oldest first, like `max messages list`; MAX answers newest first (`BUG-59`). */
     async messages(chatId, count, selfId) {
         const answer = (await this.#transport.call(required("getMessages"), {
             query: { chat_id: chatId, count: String(count) },
         }));
-        return (answer?.messages ?? []).map((raw) => this.#message(raw, selfId));
+        return (answer?.messages ?? []).map((raw) => this.#message(raw, selfId)).reverse();
     }
     /** A message from any answer — a send's result, an update — decoded the same way as a read. */
     decodeMessage(raw, selfId) {

package/dist/bot/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/bot/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE9F,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAkB,SAAS,EAAyB,MAAM,gBAAgB,CAAA;AAE/F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAiC,UAAU,CAAA;AAErE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;AAEvF,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAqB,EAAE;IACjD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACvC,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,2CAA2C,EAAE,EAAE,CAAC,CAAA;IAC1G,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,wEAAwE;AACxE,MAAM,OAAO,YAAY;IACd,UAAU,CAAc;IAEjC,YAAY,OAAyB;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,EAAE;QACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;QAChE,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,8DAA8D,EAAE;gBACrG,SAAS,EAAE,WAAW;gBACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC;aACtE,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;QACpF,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,MAAe;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;QAC9F,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,KAAa,EAAE,MAAe;QAC3D,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE;YAClE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;SACjD,CAAC,CAAoC,CAAA;QACtC,OAAO,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED,+FAA+F;IAC/F,aAAa,CAAC,GAAY,EAAE,MAAe;QACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,CAAC,SAA4B,EAAE,KAAgB;QACjD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,CAAI,MAAmC,EAAE,MAAe,EAAE,SAAiB;QAChF,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,gBAAgB,SAAS,wCAAwC,EAAE;gBACxG,SAAS;gBACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC;aACtE,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAY,EAAE,MAAe;QACpC,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,CAAA;QAC9C,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC,MAAoB,EAAE,MAAM,CAAC,CAAA;QACzE,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAI1B,CAAA;QACD,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,SAAS,CAAC;YACxC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,IAAI,SAAS,CAAC;YACrD,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YAC/D,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE;YAC5B,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,SAAS,EAAE,IAAI;YACf,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,EAAE;SAC9F,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/bot/client.ts"],"names":[],"mappings":"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"}

package/dist/bot/keep.d.ts

@@ -0,0 +1,25 @@
+import type { Chat, Message } from "@leemour/cli-messaging";
+import { type AccountKey, type IngestedVia, type MessageStore } from "@leemour/cli-messaging/store";
+import type { ChatRegistry } from "./registry.js";
+/** How a bot's messages are told apart from a personal account's in the shared store and its locators. */
+export declare const PROVIDER = "max-bot";
+export declare const accountOf: (botId: string) => AccountKey;
+export declare const keep: (botId: string, messages: readonly Message[], via: IngestedVia, warn: (message: string) => void) => Promise<boolean>;
+/**
+ * Only a chat MAX has just described in full: the store replaces a title it is not given
+ * (`RISK-53`), and the partial facts stay in the registry, which merges them.
+ */
+export declare const keepChat: (botId: string | undefined, chat: Chat, warn: (message: string) => void) => Promise<void>;
+/**
+ * A message MAX says was deleted. The store keeps it as a tombstone: reads, `--offline` and
+ * search stop returning it.
+ */
+export declare const forget: (botId: string, removals: readonly {
+    chatId: string;
+    messageId: string;
+}[], warn: (message: string) => void) => Promise<boolean>;
+/** A send's answer names the bot as its sender, so the store needs no `me()` to know whose it is. */
+export declare const keepSent: (registry: ChatRegistry, sent: unknown, warn: (message: string) => void) => Promise<void>;
+/** For `--offline` and `search`: here the store is the answer, so a failure is the command's failure. */
+export declare const fromStore: <T>(read: (store: MessageStore) => T) => Promise<T>;
+//# sourceMappingURL=keep.d.ts.map

package/dist/bot/keep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep.d.ts","sourceRoot":"","sources":["../../src/bot/keep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAa,MAAM,8BAA8B,CAAA;AAC9G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,0GAA0G;AAC1G,eAAO,MAAM,QAAQ,YAAY,CAAA;AAIjC,eAAO,MAAM,SAAS,UAAW,MAAM,KAAG,UAAsD,CAAA;AAkChG,eAAO,MAAM,IAAI,UACR,MAAM,YACH,SAAS,OAAO,EAAE,OACvB,WAAW,QACV,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAC9B,OAAO,CAAC,OAAO,CASjB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAiB,MAAM,GAAG,SAAS,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,kBAEpG,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,UACV,MAAM,YACH,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,QACpD,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAC9B,OAAO,CAAC,OAAO,CAMjB,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,QAAQ,aAAoB,YAAY,QAAQ,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,kBAKpG,CAAA;AAED,yGAAyG;AACzG,eAAO,MAAM,SAAS,GAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,KAAK,CAAC,KAAG,OAAO,CAAC,CAAC,CAY9E,CAAA"}

package/dist/bot/keep.js

@@ -0,0 +1,96 @@
+import { CliError } from "@leemour/cli-core";
+import { openStore } from "@leemour/cli-messaging/store";
+/** How a bot's messages are told apart from a personal account's in the shared store and its locators. */
+export const PROVIDER = "max-bot";
+const CHAT_ID = /^-?\d+$/;
+export const accountOf = (botId) => ({ provider: PROVIDER, account: botId });
+/**
+ * Only a real chat and a real message: the fallback decoder says `unknown`, and `user:<id>` is a
+ * send address — stored, either would make a chat that does not exist (`RISK-54`).
+ */
+const storable = (message) => CHAT_ID.test(message.chatId) && message.id.startsWith("mid.");
+/** The reason, never the path — a home directory is nobody else's business. */
+const reasonOf = (error) => {
+    const code = error?.code;
+    if (typeof code === "string")
+        return code;
+    return error instanceof Error ? error.name : "an unknown problem";
+};
+/**
+ * **A store that fails never fails the command** — MAX answered, and the answer is printed either
+ * way; the reason goes to stderr. Returns whether it was saved, for `updates watch`, which must not
+ * move its marker past what it failed to keep.
+ */
+const quietly = async (write, warn) => {
+    let store;
+    try {
+        store = await openStore();
+        write(store);
+        return true;
+    }
+    catch (error) {
+        warn(`the local copy was not updated: ${reasonOf(error)}`);
+        return false;
+    }
+    finally {
+        store?.close();
+    }
+};
+export const keep = async (botId, messages, via, warn) => {
+    const byChat = new Map();
+    for (const message of messages.filter(storable)) {
+        byChat.set(message.chatId, [...(byChat.get(message.chatId) ?? []), message]);
+    }
+    if (byChat.size === 0)
+        return true;
+    return quietly((store) => {
+        for (const [chatId, chatMessages] of byChat)
+            store.saveMessages(accountOf(botId), chatId, chatMessages, { via });
+    }, warn);
+};
+/**
+ * Only a chat MAX has just described in full: the store replaces a title it is not given
+ * (`RISK-53`), and the partial facts stay in the registry, which merges them.
+ */
+export const keepChat = async (botId, chat, warn) => {
+    if (botId && CHAT_ID.test(chat.id))
+        await quietly((store) => store.saveChats(accountOf(botId), [chat]), warn);
+};
+/**
+ * A message MAX says was deleted. The store keeps it as a tombstone: reads, `--offline` and
+ * search stop returning it.
+ */
+export const forget = async (botId, removals, warn) => {
+    const known = removals.filter((removal) => CHAT_ID.test(removal.chatId));
+    if (known.length === 0)
+        return true;
+    return quietly((store) => {
+        for (const { chatId, messageId } of known)
+            store.markDeleted(accountOf(botId), [messageId], { chatId });
+    }, warn);
+};
+/** A send's answer names the bot as its sender, so the store needs no `me()` to know whose it is. */
+export const keepSent = async (registry, sent, warn) => {
+    const message = sent;
+    if (typeof message?.senderId !== "string" || typeof message.id !== "string")
+        return;
+    registry.rememberBot(message.senderId);
+    await keep(message.senderId, [message], "send", warn);
+};
+/** For `--offline` and `search`: here the store is the answer, so a failure is the command's failure. */
+export const fromStore = async (read) => {
+    let store;
+    try {
+        store = await openStore();
+    }
+    catch (error) {
+        throw new CliError("configuration_error", `the local copy cannot be opened: ${reasonOf(error)}`);
+    }
+    try {
+        return read(store);
+    }
+    finally {
+        store.close();
+    }
+};
+//# sourceMappingURL=keep.js.map

package/dist/bot/keep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep.js","sourceRoot":"","sources":["../../src/bot/keep.ts"],"names":[],"mappings":"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"}

package/dist/bot/registry.d.ts

@@ -15,6 +15,9 @@ export declare class ChatRegistry {
     #private;
     constructor(profile: string, env?: NodeJS.ProcessEnv);
     list(): SeenChat[];
+    /** The bot's own user id, once any command has learned it — the key its messages are stored under. */
+    botId(): string | undefined;
+    rememberBot(id: string): void;
     /** Makes this bot known to `max bot list` before it has seen any chat. */
     touch(): void;
     /** Newer facts win; a chat seen only as an id keeps the title it had. */

package/dist/bot/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/bot/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAElD,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,8FAA8F;AAC9F,eAAO,MAAM,aAAa,SAAS,MAAM,CAAC,UAAU,KAAiB,MACS,CAAA;AAE9E;;;;;GAKG;AACH,qBAAa,YAAY;;IAGvB,YAAY,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAEhE;IAED,IAAI,IAAI,QAAQ,EAAE,CAQjB;IAED,0EAA0E;IAC1E,KAAK,IAAI,IAAI,CAEZ;IAED,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAuBxF;CACF;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,SAAS,MAAM,CAAC,UAAU,KAAiB,MAAM,EAO7E,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/bot/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAElD,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,8FAA8F;AAC9F,eAAO,MAAM,aAAa,SAAS,MAAM,CAAC,UAAU,KAAiB,MACS,CAAA;AAE9E;;;;;GAKG;AACH,qBAAa,YAAY;;IAGvB,YAAY,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAEhE;IAED,IAAI,IAAI,QAAQ,EAAE,CAGjB;IAED,sGAAsG;IACtG,KAAK,IAAI,MAAM,GAAG,SAAS,CAG1B;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG5B;IAED,0EAA0E;IAC1E,KAAK,IAAI,IAAI,CAEZ;IAED,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAuBxF;CAeF;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,SAAS,MAAM,CAAC,UAAU,KAAiB,MAAM,EAO7E,CAAA"}

package/dist/bot/registry.js

@@ -15,15 +15,18 @@ export class ChatRegistry {
         this.#path = join(botsDirectory(env), `${profile}.json`);
     }
     list() {
-        if (!existsSync(this.#path))
-            return [];
-        try {
-            const parsed = JSON.parse(readFileSync(this.#path, "utf8"));
-            return Array.isArray(parsed.chats) ? parsed.chats : [];
-        }
-        catch {
-            return [];
-        }
+        const { chats } = this.#read();
+        return Array.isArray(chats) ? chats : [];
+    }
+    /** The bot's own user id, once any command has learned it — the key its messages are stored under. */
+    botId() {
+        const { botId } = this.#read();
+        return typeof botId === "string" ? botId : undefined;
+    }
+    rememberBot(id) {
+        const file = this.#read();
+        if (file.botId !== id)
+            this.#write({ ...file, botId: id });
     }
     /** Makes this bot known to `max bot list` before it has seen any chat. */
     touch() {
@@ -52,7 +55,21 @@ export class ChatRegistry {
                 lastSeenAt: at,
             });
         }
-        writeSecurely(this.#path, `${JSON.stringify({ chats: [...byId.values()] }, null, 2)}\n`, 0o600);
+        this.#write({ ...this.#read(), chats: [...byId.values()] });
+    }
+    #read() {
+        if (!existsSync(this.#path))
+            return {};
+        try {
+            const parsed = JSON.parse(readFileSync(this.#path, "utf8"));
+            return parsed && typeof parsed === "object" ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    #write(file) {
+        writeSecurely(this.#path, `${JSON.stringify(file, null, 2)}\n`, 0o600);
     }
 }
 /** Every profile that has ever kept a registry — the bots this machine has used. */

package/dist/bot/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/bot/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/bot/registry.ts"],"names":[],"mappings":"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"}

package/dist/bot/uploads.d.ts

@@ -0,0 +1,34 @@
+import { type SleepLike } from "@leemour/cli-core";
+import { type FetchLike } from "@leemour/cli-core/http";
+export declare const UPLOAD_TYPES: readonly ["image", "video", "audio", "file"];
+export type UploadType = (typeof UPLOAD_TYPES)[number];
+export declare const uploadTypeOf: (path: string) => UploadType;
+/** What goes into a message body's `attachments`. */
+export interface Attachment {
+    type: UploadType;
+    payload: Record<string, unknown>;
+}
+export interface UploadEndpoint {
+    url: string;
+    token?: string | null;
+}
+export declare const endpointOf: (answer: unknown) => UploadEndpoint;
+/**
+ * The second step: the bytes, streamed from disk as multipart field `data`. The upload URL is not
+ * the Bot API host and is itself a credential, so it gets no token and never appears in an error.
+ * Video and audio answer XML and are named by step one's token; image and file by the answer.
+ */
+export declare const uploadFile: (options: {
+    path: string;
+    type: UploadType;
+    endpoint: UploadEndpoint;
+    fetch: FetchLike;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}) => Promise<Attachment>;
+/**
+ * Repeats a send only while MAX refuses it as not ready — a refusal, so nothing was sent. Any
+ * other failure, an unclear outcome above all, goes straight back to the caller.
+ */
+export declare const whenAttachmentReady: <T>(send: () => Promise<T>, signal?: AbortSignal, sleep?: SleepLike) => Promise<T>;
+//# sourceMappingURL=uploads.d.ts.map

package/dist/bot/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../../src/bot/uploads.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,wBAAwB,CAAA;AAIrE,eAAO,MAAM,YAAY,YAAI,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAwBtD,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,UAA0E,CAAA;AAEtH,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,eAAO,MAAM,UAAU,WAAY,OAAO,KAAG,cAQ5C,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAmB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KAAG,OAAO,CAAC,UAAU,CAkDrB,CAAA;AAWD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAU,CAAC,QACnC,MAAM,OAAO,CAAC,CAAC,CAAC,WACb,WAAW,UACb,SAAS,KACf,OAAO,CAAC,CAAC,CAUX,CAAA"}

package/dist/bot/uploads.js

@@ -0,0 +1,122 @@
+import { openAsBlob, statSync } from "node:fs";
+import { basename, extname } from "node:path";
+import { CliError, realSleep } from "@leemour/cli-core";
+import { statusToCode } from "@leemour/cli-core/http";
+import { parse } from "lossless-json";
+import { plainJson } from "./transport.js";
+export const UPLOAD_TYPES = ["image", "video", "audio", "file"];
+const BY_EXTENSION = {
+    jpg: "image",
+    jpeg: "image",
+    png: "image",
+    gif: "image",
+    tif: "image",
+    tiff: "image",
+    bmp: "image",
+    heic: "image",
+    mp4: "video",
+    mov: "video",
+    mkv: "video",
+    webm: "video",
+    mp3: "audio",
+    wav: "audio",
+    m4a: "audio",
+    ogg: "audio",
+    opus: "audio",
+    aac: "audio",
+    flac: "audio",
+};
+export const uploadTypeOf = (path) => BY_EXTENSION[extname(path).slice(1).toLowerCase()] ?? "file";
+export const endpointOf = (answer) => {
+    const endpoint = plainJson(answer);
+    if (typeof endpoint?.url !== "string") {
+        throw new CliError("invalid_response", "MAX answered getUploadUrl with no upload URL", {
+            operation: "getUploadUrl",
+        });
+    }
+    return { url: endpoint.url, token: endpoint.token ?? null };
+};
+const UPLOAD_TIMEOUT_MS = 10 * 60_000;
+/**
+ * The second step: the bytes, streamed from disk as multipart field `data`. The upload URL is not
+ * the Bot API host and is itself a credential, so it gets no token and never appears in an error.
+ * Video and audio answer XML and are named by step one's token; image and file by the answer.
+ */
+export const uploadFile = async (options) => {
+    const { path, type, endpoint } = options;
+    const name = basename(path);
+    const stat = (() => {
+        try {
+            return statSync(path);
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    if (!stat?.isFile())
+        throw new CliError("not_found", `no file at ${path}`);
+    const form = new FormData();
+    form.append("data", await openAsBlob(path), name);
+    const signals = [
+        AbortSignal.timeout(options.timeoutMs ?? UPLOAD_TIMEOUT_MS),
+        ...(options.signal ? [options.signal] : []),
+    ];
+    let response;
+    try {
+        response = await options.fetch(endpoint.url, { method: "POST", body: form, signal: AbortSignal.any(signals) });
+    }
+    catch {
+        throw new CliError("network_error", `the upload of ${name} did not finish; nothing was sent to the chat`, {
+            retryable: false,
+        });
+    }
+    const text = await response.text();
+    if (!response.ok) {
+        throw new CliError(statusToCode(response.status), `the upload server refused ${name} (${response.status}); nothing was sent to the chat`, { status: response.status });
+    }
+    if (type === "video" || type === "audio") {
+        if (!endpoint.token) {
+            throw new CliError("invalid_response", `MAX gave no token for a ${type} upload`, { operation: "getUploadUrl" });
+        }
+        return { type, payload: { token: endpoint.token } };
+    }
+    let answer;
+    try {
+        answer = plainJson(parse(text));
+    }
+    catch {
+        throw new CliError("invalid_response", `the upload server answered ${name} with something that is not JSON`);
+    }
+    if (type === "image" && answer.photos)
+        return { type, payload: { photos: answer.photos } };
+    if (typeof answer.token !== "string") {
+        throw new CliError("invalid_response", `the upload server answered ${name} with no token`);
+    }
+    return { type, payload: { token: answer.token } };
+};
+/** maxigo-client's `DefaultRetryIntervals` (`options.go`): MAX is still processing the file. */
+const NOT_READY_WAITS_MS = [500, 1000, 2000, 5000];
+const notReady = (error) => {
+    const failure = error;
+    if (failure.code === "outcome_unknown")
+        return false;
+    return /not\.ready|not\.processed/.test(`${failure.details?.maxCode ?? ""} ${failure.message ?? ""}`);
+};
+/**
+ * Repeats a send only while MAX refuses it as not ready — a refusal, so nothing was sent. Any
+ * other failure, an unclear outcome above all, goes straight back to the caller.
+ */
+export const whenAttachmentReady = async (send, signal, sleep = realSleep) => {
+    for (let attempt = 0;; attempt++) {
+        try {
+            return await send();
+        }
+        catch (error) {
+            const wait = NOT_READY_WAITS_MS[attempt];
+            if (wait === undefined || !notReady(error))
+                throw error;
+            await sleep(wait, signal, "retry");
+        }
+    }
+};
+//# sourceMappingURL=uploads.js.map

package/dist/bot/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../../src/bot/uploads.ts"],"names":[],"mappings":"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"}