@leemour/max-cli 0.5.0 → 0.6.0

package/dist/testing/sandbox.js

@@ -29,5 +29,6 @@ process.env.MAX_CACHE_DIR = join(sandbox, "cache");
 process.env.TMPDIR = sandbox;
 // Read before the keyring, so a token exported in the shell would log the suite in to the real account.
 delete process.env.MAX_TOKEN;
+process.env.MAX_TEST_SANDBOX = "1";
 afterAll(() => rmSync(sandbox, { recursive: true, force: true }));
 //# sourceMappingURL=sandbox.js.map

package/dist/testing/sandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/testing/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAA;AAExD,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AACpD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAClD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAClD,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAA;AAC5B,wGAAwG;AACxG,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAA;AAE5B,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA"}
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/testing/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAA;AAExD,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AACpD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAClD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAClD,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAA;AAC5B,wGAAwG;AACxG,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAA;AAC5B,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAA;AAElC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA"}

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** The one the running command reports. `pnpm version:check` fails when it and package.json disagree. */
-export declare const VERSION = "0.5.0";
+export declare const VERSION = "0.6.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** The one the running command reports. `pnpm version:check` fails when it and package.json disagree. */
-export const VERSION = "0.5.0";
+export const VERSION = "0.6.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leemour/max-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A local command line interface for a personal MAX Messenger account, built for agents and scripts",
   "license": "MIT",
   "author": "Viacheslav Ptsarev",
@@ -35,6 +35,7 @@
     "version:sync": "node --experimental-strip-types scripts/version.ts --sync",
     "probe:ids": "pnpm build && node --experimental-strip-types scripts/id-shape.ts",
     "probe:download": "pnpm build && node --experimental-strip-types scripts/probe-download.ts",
+    "probe:reply": "pnpm build && node --experimental-strip-types scripts/probe-reply.ts",
     "probe:edits": "pnpm build && node --experimental-strip-types scripts/probe-edits.ts",
     "probe:attachments": "pnpm build && node --experimental-strip-types scripts/probe-attachments.ts",
     "verify:live": "pnpm build && node --experimental-strip-types scripts/verify-commands.ts",
@@ -43,12 +44,15 @@
     "prepublishOnly": "pnpm build",
     "probe:contacts": "pnpm build && node --experimental-strip-types scripts/probe-contacts.ts",
     "probe:reactions": "pnpm build && node --experimental-strip-types scripts/probe-reactions.ts",
-    "probe:token": "pnpm build && node --experimental-strip-types scripts/probe-token.ts"
+    "probe:message-shapes": "pnpm build && node --experimental-strip-types scripts/probe-message-shapes.ts",
+    "probe:token": "pnpm build && node --experimental-strip-types scripts/probe-token.ts",
+    "probe:inbox": "pnpm build && node --experimental-strip-types scripts/probe-inbox.ts"
   },
   "dependencies": {
-    "@leemour/cli-core": "^0.1.1",
+    "@leemour/cli-core": "^0.2.0",
     "commander": "^15.0.0",
     "lossless-json": "^4.3.1",
+    "qrcode-generator": "2.0.4",
     "string-width": "^8.2.2",
     "valibot": "^1.5.0",
     "wrap-ansi": "^10.0.2",

package/skills/max-cli/SKILL.md

@@ -8,14 +8,19 @@ description: Читать и отправлять сообщения в личн
 `max` работает с **настоящим личным аккаунтом** владельца. Ошибка здесь не роняет тест, а пишет
 живому человеку. Один вызов — одно действие: подключиться, сделать, напечатать, выйти.
 
-Полный список команд и флагов — `max --help` и `max <команда> --help`. Здесь — то, что справка не
-скажет: ловушки и границы.
+Полный список команд и флагов — **`max commands --json`**: всё дерево одним ответом — аргументы,
+флаги (берёт ли значение, обязателен ли), коды выхода и пометка `mutates: true` на командах, которые
+что-то меняют в MAX. `max --help` — то же для человека. Здесь — то, что справка не скажет: ловушки и
+границы.
 
 ## Границы
 
 - **Ничего не отправлять без прямой просьбы владельца.** `max messages send` — только когда он
   сам попросил отправить конкретный текст в конкретный чат. Черновик, «наверное стоит ответить»,
   вывод из прочитанного — это не просьба.
+- **Отказ `5`, `7` или `8` на отправке или реакции — это решение владельца, а не сбой.** Не обходить его: не
+  менять настройки, не звать `max recipients add`, не ждать и не повторять. Сказать владельцу, что
+  отправка не прошла и почему.
 - **Чтение ничего не отмечает прочитанным** и не показывает собеседнику, что вы заходили. Читать
   можно свободно.
 - **Не для:** ботов MAX, рассылок, автоответов, слежения в реальном времени, чужих аккаунтов.
@@ -30,7 +35,8 @@ description: Читать и отправлять сообщения в личн
 - **Список — это объект**, а не массив: `{ "items": [...], "page": 1, "limit": 20, "hasMore": true }`.
 - **`--jsonl`** — по объекту на строку, удобно для `jq`. Есть ли ещё, пишется только в stderr.
 - **Ветвиться по коду возврата, а не по тексту**: `0` — успех, `2` — неверный ввод, `4` — нет
-  входа, `6` — не найдено, `14` — **неизвестно, ушло ли сообщение** (см. отправку).
+  входа, `5` — профиль только для чтения, `6` — не найдено, `7` — чата нет в списке разрешённых,
+  `8` — лимит отправок за час, `14` — **неизвестно, ушло ли сообщение** (см. отправку).
 - `-v` и `-vv` добавляют подробности в вывод для человека. Версия — `max -V`. Строки о каждом
   запросе к MAX — `--trace`, в stderr.
 
@@ -72,6 +78,9 @@ description: Читать и отправлять сообщения в личн
 11. **Номер страницы на живом списке может повторить или пропустить строку.** Сверху самое свежее,
    поэтому сообщение, пришедшее между первой страницей и второй, сдвигает кого-то через границу.
    Для переписки этого нет: `--before` привязан ко времени и точен.
+12. **`max inbox --new` сдвигает место, где владелец остановился.** После него следующий
+   `--new` владельца не покажет того, что уже увидел агент. Без сдвига: просто `max inbox`
+   (непрочитанное) или `max inbox --since <время>`.
 
 ## Типичный путь
 
@@ -80,6 +89,8 @@ Id ниже выдуманные — подставить настоящие и
 ```sh
 max chats list --search "проект" --json       # найти чат, взять его id
 max chats list --unread --json                 # где есть непрочитанное
+max inbox --json                               # непрочитанное во всех чатах
+max inbox --new --json                         # что пришло с прошлой проверки, один раз
 max chats show -1000 --json                    # один чат и кто в нём
 max contacts show @ivan --json                 # один человек и общие чаты
 max messages list -1000 --limit 20 --json      # последние сообщения, от старых к новым