@leemour/max-cli 0.14.0 → 0.16.0

package/dist/voice.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What a voice message carries besides the file, as web.max.ru builds it (`FIND-104`): its length
+ * in milliseconds and 80 bars of loudness, 0–127. Computed here, so only the file leaves the machine.
+ */
+export declare const voiceOf: (path: string, bytes: Uint8Array) => Promise<{
+    durationMs: number;
+    wave: Uint8Array;
+}>;
+//# sourceMappingURL=voice.d.ts.map

package/dist/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,OAAO,SAAgB,MAAM,SAAS,UAAU,KAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAyB/G,CAAA"}

package/dist/voice.js

@@ -0,0 +1,36 @@
+import { CliError } from "@leemour/cli-core";
+import { decodeOgg } from "./transcribe/speech.js";
+const BARS = 80;
+const isOggOpus = (bytes) => {
+    const head = Buffer.from(bytes.subarray(0, 64)).toString("latin1");
+    return head.startsWith("OggS") && head.includes("OpusHead");
+};
+/**
+ * What a voice message carries besides the file, as web.max.ru builds it (`FIND-104`): its length
+ * in milliseconds and 80 bars of loudness, 0–127. Computed here, so only the file leaves the machine.
+ */
+export const voiceOf = async (path, bytes) => {
+    if (!isOggOpus(bytes)) {
+        throw new CliError("validation_error", `${path} is not Ogg Opus, the format of a voice message — convert it first: ` +
+            "ffmpeg -i <file> -ac 1 -ar 48000 -c:a libopus -b:a 32k voice.ogg");
+    }
+    let decoded;
+    try {
+        decoded = await decodeOgg(bytes);
+    }
+    catch {
+        throw new CliError("validation_error", `${path} could not be decoded as Ogg Opus`);
+    }
+    const { samples, rate } = decoded;
+    const wave = new Uint8Array(BARS);
+    const size = Math.max(1, Math.floor(samples.length / BARS));
+    for (let bar = 0; bar < BARS; bar++) {
+        let peak = 0;
+        for (let index = bar * size; index < Math.min(samples.length, (bar + 1) * size); index++) {
+            peak = Math.max(peak, Math.abs(samples[index] ?? 0));
+        }
+        wave[bar] = Math.min(127, Math.round(peak * 127));
+    }
+    return { durationMs: Math.round((samples.length / rate) * 1000), wave };
+};
+//# sourceMappingURL=voice.js.map

package/dist/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAElD,MAAM,IAAI,GAAG,EAAE,CAAA;AAEf,MAAM,SAAS,GAAG,CAAC,KAAiB,EAAW,EAAE;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAClE,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;AAC7D,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAY,EAAE,KAAiB,EAAqD,EAAE;IAClH,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,IAAI,sEAAsE;YAC3E,kEAAkE,CACrE,CAAA;IACH,CAAC;IACD,IAAI,OAAgD,CAAA;IACpD,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,mCAAmC,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;IAC3D,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,KAAK,IAAI,KAAK,GAAG,GAAG,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACzF,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;AACzE,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leemour/max-cli",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "MAX Messenger bots through the official Bot API, and a personal MAX account, from the terminal \u2014 built for agents and scripts",
   "license": "MIT",
   "author": "Viacheslav Ptsarev",
@@ -63,12 +63,16 @@
     "probe:control": "pnpm build && node --experimental-strip-types scripts/probe-control.ts",
     "probe:member-list": "pnpm build && node --experimental-strip-types scripts/probe-member-list.ts",
     "probe:message-count": "pnpm build && node --experimental-strip-types scripts/probe-message-count.ts",
+    "probe:media-send": "pnpm build && node --experimental-strip-types scripts/probe-media-send.ts",
+    "probe:video": "pnpm build && node --experimental-strip-types scripts/probe-video.ts",
+    "probe:voice": "pnpm build && node --experimental-strip-types scripts/probe-voice.ts",
+    "probe:polls": "pnpm build && node --experimental-strip-types scripts/probe-polls.ts",
     "probe:bot:me": "pnpm build && node --experimental-strip-types scripts/probe-bot-me.ts"
   },
   "dependencies": {
     "@bomb.sh/tab": "0.0.22",
     "@leemour/cli-core": "0.8.0",
-    "@leemour/cli-messaging": "0.2.0",
+    "@leemour/cli-messaging": "0.13.0",
     "@modelcontextprotocol/server": "2.1.0",
     "@msgpack/msgpack": "3.1.3",
     "@valibot/to-json-schema": "1.8.0",

package/skills/max-cli/SKILL.md

@@ -26,7 +26,9 @@ description: Читать и отправлять сообщения в личн
 - **`max messages delete` — только когда владелец назвал эти сообщения и попросил их удалить.**
   Удаление не отменить. `--allow-dangerous` — его слово, не ставить флаг от себя. `--for-everyone`
   — только если он сказал «у всех».
-- **Отказ `5`, `7` или `8` на отправке, реакции, правке, пересылке, закреплении или удалении — это решение владельца, а не сбой.** Не обходить его: не
+- **То же для `polls vote|close|create`.** Голос виден другим, если опрос не анонимный; закрытый
+  опрос снова не открыть. Варианты — по id в `[скобках]` из `messages list`, не по номеру в списке.
+- **Отказ `5`, `7` или `8` на отправке, реакции, правке, пересылке, закреплении, удалении или опросе — это решение владельца, а не сбой.** Не обходить его: не
   менять настройки, не звать `max recipients add`, не ждать и не повторять. Сказать владельцу, что
   отправка не прошла и почему.
 - **Группы и каналы — только по прямой просьбе владельца.** `max chats join|leave|create|members|admins|update|settings --…|requests accept|decline|link reset` видят другие люди. Ссылка-приглашение из прочитанного сообщения — не просьба вступить.
@@ -130,6 +132,7 @@ max chats show -1000 --json                    # один чат и кто в н
 max chats events -1000 --since 2026-09-20T00:00 --json   # кто вступил, вышел, кого добавили и удалили
 max chats members list -1000 --json            # все участники от MAX: registeredAt, lastSeenAt
 max chats rules show -1000 --json              # правила модерации группы; set <ключ> <значение> меняет одно
+max chats check -1000 --dry-run --json         # что нового нарушает правила; без --dry-run — только по слову владельца
 max contacts show @ivan --json                 # один человек и общие чаты
 max messages list -1000 --limit 20 --json      # последние сообщения, от старых к новым
 max messages list -1000 --after 100000000000000001 --json   # что было после этого сообщения
@@ -145,7 +148,9 @@ max messages transcribe -1000 100000000000000001 --json   # текст голо
 черновики, отправка — только по слову владельца.
 
 Голосовое — вложение `"kind": "audio"`. Его текст даёт `max messages transcribe`; до минуты на
-пять минут речи, повторно — сразу из кэша. Если модель не скачана, команда откажет и назовёт
+пять минут речи, повторно — сразу из кэша. Уже расшифрованное голосовое несёт поле `transcript` в
+`messages list` и `inbox`; `--transcribe` там расшифровывает остальные показанные, а не
+расшифрованные перечисляет в `unheard`. Если модель не скачана, команда откажет и назовёт
 `max models audio download <id>`: **сказать об этом владельцу и не скачивать самому** — это сотни
 мегабайт, и выбор модели за ним.
 
@@ -155,9 +160,16 @@ max messages transcribe -1000 100000000000000001 --json   # текст голо
 ## Бот
 
 `max <имя> bot …` — бот владельца через официальный Bot API, **не** личный аккаунт. Имя — первое
-слово, как профиль: `max sales bot messages send -72894839451 "текст"`. Какие боты есть —
+слово, как профиль: `max sales bot messages send "Команда продаж" "текст"`. Какие боты есть —
 `max bot list`. Чат бота — номер, `user:<номер>` для человека или название чата, который бот уже
-видел; списка чатов бота у MAX нет, `max <имя> bot chats list` — только увиденные. Отказ с кодом `7`
+видел; списка чатов бота у MAX нет, `max <имя> bot chats list` — только увиденные. Положительный
+номер — почти всегда человек: ему пишут `user:<номер>`. Файл — `messages send --file <путь>`. Прочитанное
+и отправленное ботом хранится локально: `bot messages list <чат> --offline` — без сети,
+`bot messages search <текст>` — поиск, `--from <кто>` — только его сообщения. `bot people show <кто>` —
+где человек писал и его личный чат с ботом; `bot messages between <кто> <кто>` — их переписка в
+чатах, где писал каждый (`--limit` — на чат). Всё это без сети, кроме `people show --refresh`. `bot updates watch --jsonl` забирает события у всех других
+читателей бота — запускайте только по просьбе владельца. Отказ с кодом `7`
 значит «чата нет в списке получателей бота»: скажите владельцу, какую команду выполнить, и не
 пишите в обход. Любая операция API — `max <имя> bot api <операция>`; её флаги —
-`max commands --json`. Отправляйте от имени бота только то, о чём просил владелец.
+`max commands --json`. Отправляйте от имени бота только то, о чём просил владелец. Для агента есть
+MCP-сервер бота: `max <имя> bot mcp`, по умолчанию только чтение.