@wirecat/max-cli 0.62.0 → 0.64.0

package/scenarios/find-what-was-said.md

@@ -0,0 +1,17 @@
+---
+title: Find what someone said
+goal: Get back a message, a file or a voice note when you remember only a word or the person.
+steps:
+  - run: max search all "invoice"
+    why: messages, notes, the text of files and voice transcripts in one search, best match first
+  - run: max contacts timeline Anna
+    why: everything one person wrote or was mentioned in, newest first, from the store
+  - run: max messages context Team 1234
+    why: the message a hit points to, with what came either side of it
+look:
+  - the chat and the time of each hit
+  - the msg locator, to cite it or to open the message
+---
+
+A search finds only what the store holds. Run `max messages sync --all` once, or `max schedule command` on a timer,
+so older history is there to find.

package/scenarios/post-as-a-bot.md

@@ -0,0 +1,17 @@
+---
+title: Post as your bot
+goal: Send a message to a group as your bot, through MAX's official Bot API, not from your own account.
+steps:
+  - run: max bot auth set
+    why: checks the bot's token with MAX and keeps it; type it at the hidden prompt or pipe it on stdin
+  - run: max bot chats list
+    why: the chats this bot has seen on this machine, to pick the one to write to
+  - run: max bot messages send Team "the release is out"
+    why: sends the message as the bot; without the text it is read from stdin
+look:
+  - which bot `bot auth set` names, before anything is sent
+  - the message id the send returns, to edit or pin it later
+---
+
+A bot needs its own token from MAX; your personal login is not used. `max bot recipients add` limits which chats the
+bot may write to.

package/skills/max-cli/SKILL.md

@@ -47,6 +47,8 @@ MCP: сначала `max_tools_search`, затем `max_read` или `max_write`
 Предупредите: настройка может занять около пяти минут. QR сканирует владелец приложением MAX;
 `--method qr-chrome` и `sms` используют web.max.ru в браузере, `--method token` — скрытый ввод
 или stdin. Токен и пароль не запрашивайте в чате и не передавайте аргументами команды.
+Без терминала: `max personal setup --qr-file login.png --agent codex --json` пишет QR-код в PNG;
+покажите картинку владельцу. Файл удаляется после входа; облачный пароль MAX так не ввести.
 Повторный setup проверяет существующую сессию без нового входа. Если ключница недоступна,
 исправьте окружение по подсказке, не создавайте новую сессию. При истёкшем токене владелец
 явно запускает `max personal session start qr`.
@@ -121,7 +123,7 @@ remove|admins|update|link reset|requests accept|requests decline` видят д
 2. **Первое слово — профиль, если это не команда.** `max work chats list` — профиль `work`.
    Флага `--profile` нет; то же делает переменная `MAX_PROFILE`.
    **Профиль не подразумевается, даже единственный:** без имени команда завершается с кодом `2`
-   и перечисляет профили (`error.profiles`) — спросите владельца, какой нужен, не берите первый.
+   и перечисляет профили (`error.details.profiles`) — спросите владельца, какой нужен, не берите первый.
    Без профиля работают `--help`, `commands`, `skill show`, `account list`, `config show`. Имя профиля — латиница, цифры,
    точка, дефис и подчёркивание: оно становится именем файла и записью в ключнице. Имя в другом
    алфавите отвергается **как имя** (код `2`), и это не то же самое, что профиль, в который никто
@@ -171,7 +173,7 @@ remove|admins|update|link reset|requests accept|requests decline` видят д
 5d. **Ошибку, которую не удаётся объяснить, — в отчёт автору.** Предложите владельцу
    `max personal doctor report create`: команда пишет файл без текстов сообщений и печатает ссылку на новую
    задачу на GitHub. Задачу создаёт владелец сам: она видна всем.
-5e. **`max` не находится — `npx @wirecat/max-cli doctor`.** Он скажет, куда поставлена команда и
+5e. **`max` не находится — `npx @wirecat/max-cli personal doctor`.** Вместо `personal` подставьте имя профиля владельца. Он скажет, куда поставлена команда и
    почему терминал её не видит, и напечатает команду исправления. Клиенту MCP без терминала (Claude
    Desktop, Cursor) готовую запись с полными путями печатает `max personal mcp config`.
 6. **`messages show` и `messages context` требуют чат и id сообщения** — или одну ссылку `msg:…` из
@@ -190,7 +192,7 @@ remove|admins|update|link reset|requests accept|requests decline` видят д
    Отправка с `--offline` — всегда отказ.
 10. **Многострочный текст передаётся только через stdin.** Аргумент командной строки перевод
    строки не несёт вовсе, а тело в аргументе видно в `ps` и остаётся в истории оболочки. Последний
-   аргумент опускается, и тело читается со входа: `printf 'первая\n\nтретья' | max messages send
+   аргумент опускается, и тело читается со входа: `printf 'первая\n\nтретья' | max personal messages send
    -1000`. Один перевод строки в самом конце отбрасывается, остальные сохраняются.
 11. **Номер страницы на живом списке может повторить или пропустить строку.** Сверху самое свежее,
    поэтому сообщение, пришедшее между первой страницей и второй, сдвигает кого-то через границу.
@@ -198,8 +200,8 @@ remove|admins|update|link reset|requests accept|requests decline` видят д
 12. **`max personal inbox --new` сдвигает место, где владелец остановился.** После него следующий
    `--new` владельца не покажет того, что уже увидел агент. Без сдвига: просто `max personal inbox`
    (непрочитанное) или `max personal inbox 'date>2h'`.
-13. **`--at-time` ставит сообщение в очередь MAX, а не отправляет.** Ответ — `{item: {operation_id, operation_id,
-   message, scheduled_for}}`; ушедшее сообщение получит другой id. Очередь: `max messages scheduled <чат>`.
+13. **`--at-time` ставит сообщение в очередь MAX, а не отправляет.** Ответ — `{item: {operation_id,
+   message, scheduled_for}}`; ушедшее сообщение получит другой id. Очередь: `max personal messages scheduled <чат>`.
    Через MCP — параметр `at_time` у `max_write` (`command: "messages send"`) и инструмент `max_read` (`command: "messages scheduled"`).
    Отменить можно только в приложении MAX.
 

package/dist/session/qr-terminal.d.ts

@@ -1,9 +0,0 @@
-/**
- * A QR code as text, two modules per character cell with half blocks, so it fits a terminal
- * without being twice as tall as it is wide. `width` is in columns, for deciding whether it fits.
- */
-export declare const terminalQr: (link: string) => {
-    text: string;
-    width: number;
-};
-//# sourceMappingURL=qr-terminal.d.ts.map

package/dist/session/qr-terminal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"qr-terminal.d.ts","sourceRoot":"","sources":["../../src/session/qr-terminal.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAwBtE,CAAA"}

package/dist/session/qr-terminal.js

@@ -1,34 +0,0 @@
-import qrcode from "qrcode-generator";
-const QUIET_ZONE = 4;
-// Dark modules on a light ground whatever the terminal's theme: a phone camera reads an inverted
-// code unreliably, so the colours are forced even under NO_COLOR.
-const BLACK_ON_WHITE = "\x1b[30;107m";
-const RESET = "\x1b[0m";
-/**
- * A QR code as text, two modules per character cell with half blocks, so it fits a terminal
- * without being twice as tall as it is wide. `width` is in columns, for deciding whether it fits.
- */
-export const terminalQr = (link) => {
-    const code = qrcode(0, "M");
-    code.addData(link);
-    code.make();
-    const count = code.getModuleCount();
-    const size = count + QUIET_ZONE * 2;
-    const dark = (row, col) => {
-        const r = row - QUIET_ZONE;
-        const c = col - QUIET_ZONE;
-        return r >= 0 && c >= 0 && r < count && c < count && code.isDark(r, c);
-    };
-    const lines = [];
-    for (let row = 0; row < size; row += 2) {
-        let line = "";
-        for (let col = 0; col < size; col++) {
-            const top = dark(row, col);
-            const bottom = row + 1 < size && dark(row + 1, col);
-            line += top && bottom ? "█" : top ? "▀" : bottom ? "▄" : " ";
-        }
-        lines.push(`${BLACK_ON_WHITE}${line}${RESET}`);
-    }
-    return { text: lines.join("\n"), width: size };
-};
-//# sourceMappingURL=qr-terminal.js.map

package/dist/session/qr-terminal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"qr-terminal.js","sourceRoot":"","sources":["../../src/session/qr-terminal.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,kBAAkB,CAAA;AAErC,MAAM,UAAU,GAAG,CAAC,CAAA;AACpB,iGAAiG;AACjG,kEAAkE;AAClE,MAAM,cAAc,GAAG,cAAc,CAAA;AACrC,MAAM,KAAK,GAAG,SAAS,CAAA;AAEvB;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAmC,EAAE;IAC1E,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAClB,IAAI,CAAC,IAAI,EAAE,CAAA;IAEX,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;IACnC,MAAM,IAAI,GAAG,KAAK,GAAG,UAAU,GAAG,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE;QACxC,MAAM,CAAC,GAAG,GAAG,GAAG,UAAU,CAAA;QAC1B,MAAM,CAAC,GAAG,GAAG,GAAG,UAAU,CAAA;QAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC,CAAA;IAED,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,GAAG,EAAE,CAAA;QACb,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC1B,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;YACnD,IAAI,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QAC9D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AAChD,CAAC,CAAA"}