@leemour/cli-messaging 0.153.0 → 0.155.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leemour/cli-messaging",
-  "version": "0.153.0",
+  "version": "0.155.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "MIT",
   "author": "Viacheslav Ptsarev",
@@ -67,10 +67,14 @@
     "./charts": {
       "types": "./dist/charts/index.d.ts",
       "default": "./dist/charts/index.js"
+    },
+    "./models": {
+      "types": "./dist/models/index.d.ts",
+      "default": "./dist/models/index.js"
     }
   },
   "scripts": {
-    "build": "tsc --build && node scripts/bundle-drizzle.ts && node scripts/copy-snowball.ts",
+    "build": "tsc --build && node scripts/bundle-drizzle.ts && node scripts/copy-snowball.ts && node scripts/copy-chart-fonts.ts",
     "check:dist": "node scripts/check-dist.ts",
     "typecheck": "tsc --build --force --emitDeclarationOnly && tsc -p tsconfig.test.json && tsc -p tsconfig.scripts.json",
     "lint": "biome check .",
@@ -99,6 +103,7 @@
     "@leemour/cli-messaging-sqlite": "1.0.0",
     "@leemour/cli-tasks": "0.1.0",
     "@modelcontextprotocol/server": "2.1.0",
+    "@resvg/resvg-js": "2.6.2",
     "@valibot/to-json-schema": "1.8.0",
     "echarts": "6.1.0",
     "lossless-json": "4.3.0",

package/parity.json

@@ -37,6 +37,10 @@
     "--allow-any-file": {
       "meaning": "send a --file even from a hidden folder, ~/.ssh or the tool's own folders"
     },
+    "--allow-chats": {
+      "meaning": "replace allowed chat ids, comma-separated; empty clears",
+      "value": "<ids>"
+    },
     "--allow-dangerous": {
       "meaning": "go ahead without the question an ask level puts before a deletion"
     },
@@ -52,6 +56,10 @@
       "meaning": "offer the tool that applies a group's rules — delete others' messages, remove people",
       "note": "retired access flag: accepted with a warning, grants no permissions in either CLI"
     },
+    "--allow-people": {
+      "meaning": "replace allowed sender ids, comma-separated; empty clears",
+      "value": "<ids>"
+    },
     "--allow-send": {
       "meaning": "offer the send tool; without it the server can only read",
       "note": "retired access flag: accepted with a warning, grants no permissions in either CLI"
@@ -77,6 +85,9 @@
     "--as-file": {
       "meaning": "send every --file as a plain file to download, a video included"
     },
+    "--as-reply": {
+      "meaning": "send as a reply to the matched message"
+    },
     "--at-time": {
       "value": "<time>",
       "meaning": "let the messenger send it later, even with this machine off: a local time like 2026-09-25T09:00, or 30m"
@@ -146,6 +157,10 @@
       "meaning": "a chat, by id or name; repeat it for more",
       "note": "chat addressing follows each messenger's supported names, usernames and Saved Messages aliases, so it differs on purpose (Help text rule 4); both message searches resolve stored names without networking"
     },
+    "--chats": {
+      "meaning": "only these chat ids, comma-separated; empty for any",
+      "value": "<ids>"
+    },
     "--check": {
       "meaning": "say whether a newer version exists, and install nothing"
     },
@@ -161,17 +176,33 @@
       "value": "<person>",
       "meaning": "the person to tag or untag: their id, @username or name, as the local store knows them"
     },
+    "--contacts-only": {
+      "meaning": "match only contacts"
+    },
     "--context": {
       "value": "<n>",
       "meaning": "messages before and after each hit"
     },
+    "--days": {
+      "meaning": "days of the working window, such as mon-fri or sat,sun",
+      "value": "<days>"
+    },
     "--deep": {
       "value": "<n>",
-      "meaning": "also check the top n in full — profile, photos, everything they wrote, and the public ban lists, which are sent their ids — one person a second"
+      "meaning": "also check the top n in full — profile, photos, everything they wrote, and the public ban lists, which are sent their ids — one person a second",
+      "note": "max-cli main still uses the older SDK help; current tg-cli names the bounded Telegram audit. Align after both adopt the HTTP confirmation SDK release."
     },
     "--defaults": {
       "meaning": "change what every profile gets, rather than this profile"
     },
+    "--deny-chats": {
+      "meaning": "replace denied chat ids, comma-separated; empty clears; deny wins",
+      "value": "<ids>"
+    },
+    "--deny-people": {
+      "meaning": "replace denied sender ids, comma-separated; empty clears; deny wins",
+      "value": "<ids>"
+    },
     "--description": {
       "value": "<text>",
       "meaning": "the new about text — of a chat or of your account"
@@ -180,6 +211,10 @@
       "value": "<n>",
       "meaning": "remote: the vector size — needed with --base-url; shortens an OpenAI model's"
     },
+    "--do": {
+      "meaning": "actions: reply, task, or both, comma-separated",
+      "value": "<actions>"
+    },
     "--download": {
       "meaning": "first save, from the messenger, the files no download saved yet"
     },
@@ -233,7 +268,11 @@
       "meaning": "the text is HTML: <b>, <i>, <a href>, <code>"
     },
     "--http": {
-      "meaning": "serve MCP over HTTP on 127.0.0.1 behind the owner's tunnel, with a one-owner login; every write asks first"
+      "meaning": "serve MCP over HTTP on 127.0.0.1 behind the owner's tunnel, with a one-owner login; every write asks first by default"
+    },
+    "--http-confirmation": {
+      "value": "<mode>",
+      "meaning": "required (default): every write needs a server form; permissions: follow the effective profile levels"
     },
     "--idle": {
       "value": "<duration>",
@@ -249,6 +288,10 @@
       "value": "<kind>",
       "meaning": "only chats of this kind: dialog, group, channel or saved"
     },
+    "--kinds": {
+      "meaning": "chat kinds: dialog, group; comma-separated, empty for any",
+      "value": "<kinds>"
+    },
     "--language": {
       "value": "<lucene|legacy>",
       "meaning": "the query language: strict Lucene or legacy discovery",
@@ -317,6 +360,9 @@
       "value": "<on|off>",
       "meaning": "members may see the invite link"
     },
+    "--mentions-me": {
+      "meaning": "require a mention of you or a reply to you"
+    },
     "--message": {
       "value": "<message>",
       "meaning": "the message to tag or untag: its id in --chat, or a msg: locator alone"
@@ -332,7 +378,7 @@
     "--model": {
       "value": "<id>",
       "meaning": "which downloaded speech model hears them; `models audio list` shows them",
-      "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
+      "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13); replies edit uses this option for template model mode: fill-only or may-reword; rewording is not yet available"
     },
     "--multiple": {
       "meaning": "people may pick several answers"
@@ -346,24 +392,48 @@
     "--newest": {
       "meaning": "newest first instead of best first"
     },
+    "--no-as-reply": {
+      "meaning": "send without linking to the matched message"
+    },
     "--no-ban": {
       "meaning": "remove without banning; by default a removed person cannot come back by the link"
     },
+    "--no-contacts-only": {
+      "meaning": "do not require a contact"
+    },
+    "--no-hours": {
+      "meaning": "clear the working window"
+    },
     "--no-mark-read": {
       "meaning": "do not mark read, whatever the catchUpMarksRead setting says"
     },
+    "--no-mentions-me": {
+      "meaning": "do not require a mention of you or a reply to you"
+    },
     "--no-preview": {
       "meaning": "no preview card for a link in the text"
     },
+    "--no-question": {
+      "meaning": "do not require a question"
+    },
     "--no-record": {
       "meaning": "do not keep it, whatever the configuration says"
     },
     "--no-registries": {
-      "meaning": "do not ask the public ban lists; nothing about them leaves this machine"
+      "meaning": "do not ask the public ban lists; nothing about them leaves this machine",
+      "note": "max-cli main still uses the older SDK help; current tg-cli distinguishes public registries from Telegram profile reads. Align after both adopt the HTTP confirmation SDK release."
     },
     "--no-serve": {
       "meaning": "do not start it; log in on this command's own connection unless one is running"
     },
+    "--not-chats": {
+      "meaning": "leave these chat ids out, comma-separated; empty clears",
+      "value": "<ids>"
+    },
+    "--not-people": {
+      "meaning": "leave these sender ids out, comma-separated; empty clears",
+      "value": "<ids>"
+    },
     "--notification": {
       "value": "<text>",
       "meaning": "a note only the person who pressed sees"
@@ -409,6 +479,10 @@
       "default": ".",
       "note": "`attachments extract` takes it only with --download, and has no default there, so extraction never fills the working folder unasked"
     },
+    "--outside": {
+      "meaning": "answer outside this 24-hour window, such as 09:00-19:00",
+      "value": "<hours>"
+    },
     "--page": {
       "value": "<n>",
       "meaning": "which page, starting at 1"
@@ -424,6 +498,22 @@
       "default": "5s",
       "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
     },
+    "--people": {
+      "meaning": "only these sender ids, comma-separated; empty for any",
+      "value": "<ids>"
+    },
+    "--per-chat": {
+      "meaning": "at most this many per chat, such as 1/12h",
+      "value": "<limit>"
+    },
+    "--per-person": {
+      "meaning": "at most this many per person, such as 1/1d",
+      "value": "<limit>"
+    },
+    "--permission": {
+      "value": "<key=level>",
+      "meaning": "override a permission for this MCP server only; repeat for more keys"
+    },
     "--personal": {
       "meaning": "the personal account's section of the profile's settings"
     },
@@ -447,6 +537,9 @@
       "value": "<png>",
       "meaning": "write the QR code to this PNG instead of drawing it, for an agent to pass on"
     },
+    "--question": {
+      "meaning": "match only questions"
+    },
     "--quiet": {
       "meaning": "diagnostics off",
       "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
@@ -473,6 +566,10 @@
     "--replace": {
       "meaning": "overwrite a saved search of the same name"
     },
+    "--reply": {
+      "meaning": "answer all or only listed senders and chats: all, listed",
+      "value": "<mode>"
+    },
     "--reply-to": {
       "value": "<message>",
       "meaning": "answer this message id in the same chat"
@@ -550,6 +647,10 @@
       "value": "<tag>",
       "meaning": "only this tag"
     },
+    "--template": {
+      "meaning": "the reply template",
+      "value": "<text>"
+    },
     "--text": {
       "value": "<text>",
       "meaning": "the message's new text; - reads stdin"
@@ -589,7 +690,8 @@
     "--timezone": {
       "value": "<zone>",
       "meaning": "the IANA timezone for calendar date boundaries",
-      "default": "system IANA timezone"
+      "default": "system IANA timezone",
+      "note": "replies edit uses this option for the IANA timezone for the working window"
     },
     "--title": {
       "value": "<title>",
@@ -652,6 +754,10 @@
       "value": "<file>",
       "meaning": "send an Ogg Opus file as a voice message, alone, with no text"
     },
+    "--words": {
+      "meaning": "match any of these whole words, comma-separated; empty clears",
+      "value": "<words>"
+    },
     "--workers": {
       "value": "<n>",
       "meaning": "sessions in parallel, each with its own copy of the model"
@@ -1842,6 +1948,20 @@
         "--allow-send": "all",
         "--confirm-send": "all",
         "--http": "all",
+        "--http-confirmation": {
+          "in": [],
+          "planned": {
+            "max": "HTTP confirmation compatibility",
+            "tg": "HTTP confirmation compatibility"
+          }
+        },
+        "--permission": {
+          "in": [],
+          "planned": {
+            "max": "HTTP confirmation compatibility",
+            "tg": "HTTP confirmation compatibility"
+          }
+        },
         "--port": "all",
         "--public-url": "all",
         "--revoke": "all",
@@ -1875,6 +1995,13 @@
         },
         "--allow-send": "all",
         "--confirm-send": "all",
+        "--permission": {
+          "in": [],
+          "planned": {
+            "max": "HTTP confirmation compatibility",
+            "tg": "HTTP confirmation compatibility"
+          }
+        },
         "--yes": {
           "in": [],
           "planned": {
@@ -1932,6 +2059,13 @@
             "max": "local MCP setup",
             "tg": "local MCP setup"
           }
+        },
+        "--permission": {
+          "in": [],
+          "planned": {
+            "max": "HTTP confirmation compatibility",
+            "tg": "HTTP confirmation compatibility"
+          }
         }
       }
     },
@@ -1990,6 +2124,13 @@
             "max": "local MCP setup",
             "tg": "local MCP setup"
           }
+        },
+        "--permission": {
+          "in": [],
+          "planned": {
+            "max": "HTTP confirmation compatibility",
+            "tg": "HTTP confirmation compatibility"
+          }
         }
       }
     },
@@ -2289,6 +2430,241 @@
     "replies": {
       "in": "all"
     },
+    "replies add": {
+      "in": [],
+      "planned": {
+        "max": "next cli-messaging bump",
+        "tg": "next cli-messaging bump"
+      }
+    },
+    "replies audience": {
+      "in": [],
+      "planned": {
+        "max": "next cli-messaging bump",
+        "tg": "next cli-messaging bump"
+      },
+      "options": {
+        "--allow-chats": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--allow-people": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--deny-chats": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--deny-people": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--reply": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        }
+      }
+    },
+    "replies edit": {
+      "in": [],
+      "planned": {
+        "max": "next cli-messaging bump",
+        "tg": "next cli-messaging bump"
+      },
+      "options": {
+        "--as-reply": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--chats": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--contacts-only": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--days": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--do": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--kinds": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--mentions-me": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--model": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--no-as-reply": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--no-contacts-only": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--no-hours": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--no-mentions-me": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--no-question": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--not-chats": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--not-people": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--outside": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--people": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--per-chat": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--per-person": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--question": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--template": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--timezone": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        },
+        "--words": {
+          "in": [],
+          "planned": {
+            "max": "next cli-messaging bump",
+            "tg": "next cli-messaging bump"
+          }
+        }
+      }
+    },
+    "replies off": {
+      "in": [],
+      "planned": {
+        "max": "next cli-messaging bump",
+        "tg": "next cli-messaging bump"
+      }
+    },
+    "replies on": {
+      "in": [],
+      "planned": {
+        "max": "next cli-messaging bump",
+        "tg": "next cli-messaging bump"
+      }
+    },
     "replies pause": {
       "in": "all"
     },