telegram-userbot-cli 0.4.0__tar.gz → 0.5.0__tar.gz

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: telegram-userbot-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: Full-featured Telegram command-line client powered by a Telethon userbot (your own account, not a bot token)
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -181,6 +181,26 @@ tg logout          # remove the session
 | `tg login --account <label>` | Log in an additional account |
 | `tg vtr <chat> <msg_id>` | Transcribe a voice note (Telegram Premium required) |
 
+### Parity completion (v5)
+
+| Command | Description |
+|---|---|
+| `tg buttons <chat> <msg_id>` | List a message's inline buttons (with press indexes) |
+| `tg press <chat> <msg_id> <idx\|text>` | Press an inline button (shows the bot's answer) |
+| `tg reactions <chat> <msg_id>` | Show reactions (counts + recent reactors) |
+| `tg members <chat> [-n]` | Full member list (recent first) |
+| `tg chat-permissions <chat> [--no-send-stickers …]` | Show/set default member permissions |
+| `tg forum <chat> on\|off` | Enable/disable forum mode |
+| `tg chat-photo-del <chat>` | Remove the group/channel photo |
+| `tg folder-rm <folder> <chat...>` | Remove chats from a folder |
+| `tg upload <file>` | Upload a file without sending (prints id/md5) |
+| `tg search-public <query>` | Search public chats/users by name |
+| `tg resolve <@username>` | Resolve a username to an id |
+| `tg stickers` | List your sticker sets |
+| `tg user-photos <user> [-n]` | List a user's profile photos |
+| `tg bot-info <bot>` | Show a bot's description and commands |
+| `tg bot-commands <cmd> <desc>...` | Set your bot's commands (bot accounts only; `--clear`) |
+
 Global flags: `--account` (v1: default only), `--json` (raw JSON output).
 Exit codes: `0` ok, `1` command error, `2` config/connection/session error,
 `130` interrupted.

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/README-zh.md

@@ -158,6 +158,26 @@ tg logout          # 退出登录并删除会话
 | `tg login --account <标签>` | 登录额外账号 |
 | `tg vtr <会话> <消息id>` | 语音转文字（需要 Telegram Premium） |
 
+### 对齐补全（v5）
+
+| 命令 | 说明 |
+|---|---|
+| `tg buttons <会话> <消息id>` | 列出消息的内联按钮（带按压序号） |
+| `tg press <会话> <消息id> <序号\|文本>` | 点击内联按钮（显示 bot 应答） |
+| `tg reactions <会话> <消息id>` | 查看消息反应（计数 + 最近反应者） |
+| `tg members <会话> [-n]` | 完整成员列表（最近加入优先） |
+| `tg chat-permissions <会话> [--no-send-stickers …]` | 查看/设置群默认成员权限 |
+| `tg forum <会话> on\|off` | 开启/关闭论坛模式 |
+| `tg chat-photo-del <会话>` | 删除群/频道头像 |
+| `tg folder-rm <文件夹> <会话...>` | 从文件夹移出会话 |
+| `tg upload <文件>` | 上传文件到 Telegram 但不发送（输出 id/md5） |
+| `tg search-public <关键词>` | 按名称搜索公开群组/用户 |
+| `tg resolve <@用户名>` | 把用户名解析为 id（不依赖会话列表） |
+| `tg stickers` | 列出你的贴纸包 |
+| `tg user-photos <用户> [-n]` | 列出用户的头像 |
+| `tg bot-info <bot>` | 查看 bot 的简介与命令 |
+| `tg bot-commands <命令> <描述>...` | 设置自己 bot 的命令（仅 bot 账号；`--clear`） |
+
 全局选项：`--account`（v1 仅 default）、`--json`（原始 JSON 输出）。
 退出码：`0` 成功、`1` 命令错误、`2` 配置/连接/会话错误、`130` 中断。
 

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/README.md

@@ -168,6 +168,26 @@ tg logout          # remove the session
 | `tg login --account <label>` | Log in an additional account |
 | `tg vtr <chat> <msg_id>` | Transcribe a voice note (Telegram Premium required) |
 
+### Parity completion (v5)
+
+| Command | Description |
+|---|---|
+| `tg buttons <chat> <msg_id>` | List a message's inline buttons (with press indexes) |
+| `tg press <chat> <msg_id> <idx\|text>` | Press an inline button (shows the bot's answer) |
+| `tg reactions <chat> <msg_id>` | Show reactions (counts + recent reactors) |
+| `tg members <chat> [-n]` | Full member list (recent first) |
+| `tg chat-permissions <chat> [--no-send-stickers …]` | Show/set default member permissions |
+| `tg forum <chat> on\|off` | Enable/disable forum mode |
+| `tg chat-photo-del <chat>` | Remove the group/channel photo |
+| `tg folder-rm <folder> <chat...>` | Remove chats from a folder |
+| `tg upload <file>` | Upload a file without sending (prints id/md5) |
+| `tg search-public <query>` | Search public chats/users by name |
+| `tg resolve <@username>` | Resolve a username to an id |
+| `tg stickers` | List your sticker sets |
+| `tg user-photos <user> [-n]` | List a user's profile photos |
+| `tg bot-info <bot>` | Show a bot's description and commands |
+| `tg bot-commands <cmd> <desc>...` | Set your bot's commands (bot accounts only; `--clear`) |
+
 Global flags: `--account` (v1: default only), `--json` (raw JSON output).
 Exit codes: `0` ok, `1` command error, `2` config/connection/session error,
 `130` interrupted.

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/ROADMAP.md

@@ -76,6 +76,32 @@ Chat management:
   `messages.TranscribeAudioRequest` (telethon has no wrapper). Telegram
   Premium is required server-side; free accounts get a clean error
 
+### v5 — MCP parity completion (shipped)
+
+Closes the remaining gap against the chigwell/telegram-mcp 126-tool scope.
+Everything below is now aligned; only the agent-oriented event tools stay
+out of scope.
+
+- ✅ `buttons` / `press` — inline keyboard interaction (press shows the
+  bot's callback answer)
+- ✅ `reactions` — view message reactions (counts + recent reactors)
+- ✅ `members` — full participant list (supergroups paginated via
+  `ChannelParticipantsRecent`; basic groups via `GetFullChat`)
+- ✅ `chat-permissions` — show/set default member rights
+  (`messages.editChatDefaultBannedRights`; flags use
+  `--send-messages/--no-send-messages` pairs)
+- ✅ `search-public` — public chat/user search (`contacts.Search`)
+- ✅ `resolve` — username → id (`contacts.ResolveUsername`)
+- ✅ `forum on|off` — forum mode toggle
+- ✅ `chat-photo-del` — remove group/channel photo (`InputChatPhotoEmpty`)
+- ✅ `stickers` — list installed sticker sets
+- ✅ `user-photos` — list a user's profile photos
+- ✅ `folder-rm` — remove chats from a folder (folders cannot become empty)
+- ✅ `upload` — upload a file without sending
+- ✅ `bot-info` — bot description + commands (`users.GetFullUser`)
+- ✅ `bot-commands` — set own bot's commands (bot accounts only, like
+  telegram-mcp's implementation)
+
 ### Out of scope
 
 - ❌ Agent-oriented event tools (`wait_for_settled_message`, incoming feed

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "telegram-userbot-cli"
-version = "0.4.0"
+version = "0.5.0"
 description = "Full-featured Telegram command-line client powered by a Telethon userbot (your own account, not a bot token)"
 readme = "README.md"
 license = "Apache-2.0"

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/src/tgcli/__init__.py

@@ -1,3 +1,3 @@
 """tgcli — standalone Telegram command-line client."""
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/src/tgcli/cli.py

@@ -6,7 +6,18 @@ import sys
 
 from telethon import errors
 
-from . import __version__, auth, chats, contacts, dialogs, groups, media, messages, resolve
+from . import (
+    __version__,
+    auth,
+    chats,
+    contacts,
+    dialogs,
+    discovery,
+    groups,
+    media,
+    messages,
+    resolve,
+)
 from .output import TgError
 
 
@@ -44,7 +55,7 @@ def build_parser() -> argparse.ArgumentParser:
     sp3 = sub.add_parser("accounts", parents=[common], help="List configured accounts")
     sp3.set_defaults(func=auth.cmd_accounts)
 
-    for mod in (messages, chats, media, dialogs, groups, contacts):
+    for mod in (messages, chats, media, dialogs, groups, contacts, discovery):
         mod.setup(sub, common)
 
     resolve.setup_alias(sub, common)

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/src/tgcli/dialogs.py

@@ -266,6 +266,29 @@ async def cmd_folder_assign(args) -> None:
         print(f"Added {added} chat(s) to folder [{filt.id}] {_filter_title(filt)}")
 
 
+async def cmd_folder_rm(args) -> None:
+    async with run_with_client(args) as client:
+        filt = await _find_filter(client, args.folder)
+        wanted = {utils.get_peer_id(await _input_peer(client, c)) for c in args.chat}
+        kept = [p for p in filt.include_peers if utils.get_peer_id(p) not in wanted]
+        removed = len(filt.include_peers) - len(kept)
+        if not removed:
+            raise TgError("none of the given chats are in that folder")
+        # the server rejects filters with an empty include_peers unless they
+        # match by category (contacts/groups/…)
+        if not kept and not any(
+            getattr(filt, f, False)
+            for f in ("contacts", "non_contacts", "groups", "broadcasts", "bots")
+        ):
+            raise TgError(
+                "a folder cannot become empty",
+                "delete it instead: tg folder-del <folder>",
+            )
+        filt.include_peers = kept
+        await client(functions.messages.UpdateDialogFilterRequest(id=filt.id, filter=filt))
+        print(f"Removed {removed} chat(s) from folder [{filt.id}] {_filter_title(filt)}")
+
+
 async def cmd_folder_del(args) -> None:
     async with run_with_client(args) as client:
         filt = await _find_filter(client, args.folder)
@@ -374,6 +397,11 @@ def setup(subparsers, common=None) -> None:
     sp.add_argument("chat", nargs="+")
     sp.set_defaults(func=cmd_folder_assign)
 
+    sp = subparsers.add_parser("folder-rm", parents=parents, help="Remove chats from a folder")
+    sp.add_argument("folder", help="folder name or id")
+    sp.add_argument("chat", nargs="+")
+    sp.set_defaults(func=cmd_folder_rm)
+
     sp = subparsers.add_parser("folder-del", parents=parents, help="Delete a folder")
     sp.add_argument("folder", help="folder name or id")
     sp.set_defaults(func=cmd_folder_del)

telegram_userbot_cli-0.5.0/src/tgcli/discovery.py

@@ -0,0 +1,197 @@
+"""Public surface discovery: search chats, resolve usernames, stickers,
+user photos, bot info/commands."""
+
+from telethon import functions, types
+
+from .client import run_with_client
+from .output import TgError, json_pp
+from .resolve import resolve_chat
+
+
+def _marked(peer) -> int:
+    """Marked id (-100 prefix for channels) via the peer's bare id/type."""
+    if isinstance(peer, types.PeerChannel):
+        return int(f"-100{peer.channel_id}")
+    if isinstance(peer, types.PeerUser):
+        return peer.user_id
+    if isinstance(peer, types.PeerChat):
+        return -peer.chat_id
+    return 0
+
+
+async def cmd_search_public(args) -> None:
+    async with run_with_client(args) as client:
+        res = await client(functions.contacts.SearchRequest(q=args.query, limit=args.n))
+        chats = getattr(res, "chats", []) or []
+        users = getattr(res, "users", []) or []
+        if args.json:
+            print(
+                json_pp(
+                    {"chats": [c.to_dict() for c in chats], "users": [u.to_dict() for u in users]}
+                )
+            )
+            return
+        if not chats and not users:
+            print("(no results)")
+            return
+        for c in chats:
+            uname = getattr(c, "username", None) or ""
+            kind = "channel" if getattr(c, "broadcast", False) else "group"
+            print(f"{c.id:>14}  {kind:<8} {c.title}  {'@' + uname if uname else ''}")
+        for u in users:
+            name = " ".join(x for x in (u.first_name, u.last_name) if x)
+            uname = getattr(u, "username", None) or ""
+            print(f"{u.id:>14}  {'user':<8} {name}  {'@' + uname if uname else ''}")
+
+
+async def cmd_resolve(args) -> None:
+    async with run_with_client(args) as client:
+        res = await client(
+            functions.contacts.ResolveUsernameRequest(username=args.username.lstrip("@"))
+        )
+        peer = res.peer
+        chats = {c.id: c for c in getattr(res, "chats", []) or []}
+        users = {u.id: u for u in getattr(res, "users", []) or []}
+        if isinstance(peer, types.PeerUser):
+            u = users.get(peer.user_id)
+            name = (
+                " ".join(
+                    x for x in (getattr(u, "first_name", None), getattr(u, "last_name", None)) if x
+                )
+                if u
+                else "?"
+            )
+            print(f"user    {peer.user_id:>14}  {name}")
+        elif isinstance(peer, types.PeerChannel):
+            c = chats.get(peer.channel_id)
+            title = getattr(c, "title", "?") if c else "?"
+            kind = "supergroup" if getattr(c, "megagroup", False) else "channel"
+            print(f"{kind}  -100{peer.channel_id}  {title}")
+        else:
+            print(peer)
+
+
+async def cmd_stickers(args) -> None:
+    async with run_with_client(args) as client:
+        res = await client(functions.messages.GetAllStickersRequest(hash=0))
+        sets = getattr(res, "sets", []) or []
+        if args.json:
+            print(json_pp([s.to_dict() for s in sets]))
+            return
+        if not sets:
+            print("(no sticker sets)")
+            return
+        for s in sets:
+            flag = "*" if getattr(s, "installed", False) else " "
+            print(f"{s.id:>14} {flag} {s.title}  ({s.count})")
+            print(f"            t.me/addstickers/{s.short_name}")
+
+
+async def cmd_user_photos(args) -> None:
+    async with run_with_client(args) as client:
+        user = await resolve_chat(client, args.user)
+        res = await client(
+            functions.photos.GetUserPhotosRequest(user_id=user, offset=0, max_id=0, limit=args.n)
+        )
+        photos = getattr(res, "photos", []) or []
+        if args.json:
+            print(json_pp([p.to_dict() for p in photos]))
+            return
+        if not photos:
+            print("(no profile photos)")
+            return
+        for p in photos:
+            date = p.date.astimezone().strftime("%Y-%m-%d %H:%M")
+            biggest = max(p.sizes, key=lambda s: getattr(s, "w", 0) or 0, default=None)
+            dims = f"{biggest.w}x{biggest.h}" if biggest and getattr(biggest, "w", 0) else ""
+            print(f"{p.id:>20}  {date}  {dims}")
+
+
+async def cmd_bot_info(args) -> None:
+    async with run_with_client(args) as client:
+        user = await resolve_chat(client, args.bot)
+        res = await client(functions.users.GetFullUserRequest(id=user))
+        info = getattr(res.full_user, "bot_info", None)
+        if info is None:
+            raise TgError(f"'{args.bot}' is not a bot (no bot info)")
+        if args.json:
+            print(json_pp(info.to_dict()))
+            return
+        desc = getattr(info, "description", "") or ""
+        about = getattr(info, "about", "") or ""
+        if about:
+            print(about)
+        if desc:
+            print(desc)
+        commands = getattr(info, "commands", []) or []
+        if commands:
+            print("\ncommands:")
+            for c in commands:
+                print(f"  /{c.command}  {c.description}")
+        if not (about or desc or commands):
+            print("(no public bot info)")
+
+
+async def cmd_bot_commands(args) -> None:
+    async with run_with_client(args) as client:
+        me = await client.get_me()
+        if not getattr(me, "bot", False):
+            raise TgError(
+                "only bot accounts can set their own commands",
+                "log the bot in with: tg login --account <bot-label>, then pass --account",
+            )
+        if args.clear:
+            commands: list = []
+        else:
+            p = args.pairs
+            if len(p) % 2:
+                raise TgError("commands come in <command> <description> pairs")
+            commands = [
+                types.BotCommand(command=p[i].lstrip("/"), description=p[i + 1])
+                for i in range(0, len(p), 2)
+            ]
+        await client(
+            functions.bots.SetBotCommandsRequest(
+                scope=types.BotCommandScopeDefault(), lang_code="", commands=commands
+            )
+        )
+        print(f"{'Cleared' if args.clear else 'Set'} {len(commands)} bot command(s)")
+
+
+def setup(subparsers, common=None) -> None:
+    parents = [common] if common else []
+    sp = subparsers.add_parser(
+        "search-public", parents=parents, help="Search public chats/users by name"
+    )
+    sp.add_argument("query")
+    sp.add_argument("-n", type=int, default=10)
+    sp.set_defaults(func=cmd_search_public)
+
+    sp = subparsers.add_parser(
+        "resolve", parents=parents, help="Resolve a @username to an id without dialogs"
+    )
+    sp.add_argument("username")
+    sp.set_defaults(func=cmd_resolve)
+
+    sp = subparsers.add_parser("stickers", parents=parents, help="List your sticker sets")
+    sp.set_defaults(func=cmd_stickers)
+
+    sp = subparsers.add_parser("user-photos", parents=parents, help="List a user's profile photos")
+    sp.add_argument("user")
+    sp.add_argument("-n", type=int, default=10)
+    sp.set_defaults(func=cmd_user_photos)
+
+    sp = subparsers.add_parser(
+        "bot-info", parents=parents, help="Show a bot's description and commands"
+    )
+    sp.add_argument("bot")
+    sp.set_defaults(func=cmd_bot_info)
+
+    sp = subparsers.add_parser(
+        "bot-commands",
+        parents=parents,
+        help="Set your bot's commands (bot accounts only): /cmd desc [cmd desc...]",
+    )
+    sp.add_argument("pairs", nargs="*", default=[], metavar="CMD_DESC")
+    sp.add_argument("--clear", action="store_true", help="remove all commands")
+    sp.set_defaults(func=cmd_bot_commands)

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/src/tgcli/groups.py

@@ -1,5 +1,6 @@
 """Group administration: create, members, bans, admins, slow mode, topics, admin log."""
 
+import argparse
 import random
 import re
 from datetime import datetime, timedelta, timezone
@@ -427,6 +428,143 @@ async def cmd_admin_log(args) -> None:
             print(f"[{e.id}] {date}  {_display(users, e.user_id)}: {_action_text(e.action)}")
 
 
+# ---- members, default permissions, forum mode, group photo ----
+
+# rights shown by `chat-permissions`; True in ChatBannedRights means banned,
+# so the CLI exposes them as "allowed" flags and inverts when sending
+_PERMISSION_RIGHTS = [
+    "send_messages",
+    "send_media",
+    "send_stickers",
+    "send_gifs",
+    "send_games",
+    "send_inline",
+    "embed_links",
+    "send_polls",
+    "send_photos",
+    "send_videos",
+    "send_roundvideos",
+    "send_audios",
+    "send_voices",
+    "send_docs",
+    "send_plain",
+    "send_reactions",
+    "change_info",
+    "invite_users",
+    "pin_messages",
+    "manage_topics",
+]
+
+# Telegram's out-of-the-box defaults when a chat has no explicit rights set
+_DEFAULT_ALLOWED = {r: not r.startswith(("change_", "pin_", "manage_")) for r in _PERMISSION_RIGHTS}
+
+
+async def cmd_members(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        kind = _require_group(peer)
+        rows: list = []
+        users: dict = {}
+        if kind == "channel":
+            want = min(args.n, 1000)
+            offset = 0
+            while len(rows) < want:
+                res = await client(
+                    functions.channels.GetParticipantsRequest(
+                        peer,
+                        types.ChannelParticipantsRecent(),
+                        offset=offset,
+                        limit=min(100, want - len(rows)),
+                        hash=0,
+                    )
+                )
+                rows.extend(res.participants)
+                users.update(_users_by_id(res))
+                if len(res.participants) < 100:
+                    break
+                offset += len(res.participants)
+        else:
+            res = await client(functions.messages.GetFullChatRequest(chat_id=peer.chat_id))
+            rows = list(res.full_chat.participants.participants)
+            users = _users_by_id(res)
+        if args.json:
+            print(json_pp([p.to_dict() for p in rows]))
+            return
+        if not rows:
+            print("(no participants)")
+            return
+        for p in rows:
+            uid = getattr(p, "user_id", None)
+            if uid is None:  # ChannelParticipantBanned wraps a Peer
+                uid = getattr(getattr(p, "peer", None), "user_id", "?")
+            rank = getattr(p, "rank", "") or ""
+            print(f"{uid:>14}  {rank:<12} {_display(users, uid)}")
+
+
+async def cmd_chat_permissions(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        ent = await client.get_entity(peer)
+        cur = getattr(ent, "default_banned_rights", None)
+        allowed = {
+            r: (not getattr(cur, r, False)) if cur else _DEFAULT_ALLOWED[r]
+            for r in _PERMISSION_RIGHTS
+        }
+        overrides = {}
+        for r in _PERMISSION_RIGHTS:
+            v = getattr(args, r, None)
+            if v is not None:
+                overrides[r] = v
+                allowed[r] = v
+        if not overrides:
+            banned = [r for r in _PERMISSION_RIGHTS if not allowed[r]]
+            print("current default permissions:")
+            print(
+                "  allowed: " + (", ".join(r for r in _PERMISSION_RIGHTS if allowed[r]) or "(none)")
+            )
+            print("  banned:  " + (", ".join(banned) or "(none)"))
+            return
+        banned_rights = types.ChatBannedRights(
+            until_date=None, view_messages=False, **{r: not allowed[r] for r in _PERMISSION_RIGHTS}
+        )
+        await client(
+            functions.messages.EditChatDefaultBannedRightsRequest(
+                peer=peer, banned_rights=banned_rights
+            )
+        )
+        newly = ", ".join(f"no-{r.replace('_', '-')}" for r, v in overrides.items() if not v)
+        restored = ", ".join(f"{r.replace('_', '-')}" for r, v in overrides.items() if v)
+        msg = "Default permissions updated"
+        if newly:
+            msg += f"; banned: {newly}"
+        if restored:
+            msg += f"; allowed: {restored}"
+        print(msg)
+
+
+async def cmd_forum(args) -> None:
+    if args.state not in ("on", "off"):
+        raise TgError('state must be "on" or "off"')
+    async with run_with_client(args) as client:
+        peer = await _require_channel(await _peer(client, args.chat))
+        await client(functions.channels.ToggleForumRequest(peer, args.state == "on", args.tabs))
+        print(f"Forum mode {'enabled' if args.state == 'on' else 'disabled'}")
+
+
+async def cmd_chat_photo_del(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        if _require_group(peer) == "channel":
+            await client(functions.channels.EditPhotoRequest(peer, types.InputChatPhotoEmpty()))
+        else:
+            await client(
+                functions.messages.EditChatPhotoRequest(
+                    chat_id=peer.chat_id, photo=types.InputChatPhotoEmpty()
+                )
+            )
+        print("Chat photo removed")
+
+
 def setup(subparsers, common=None) -> None:
     parents = [common] if common else []
     sp = subparsers.add_parser(
@@ -532,3 +670,35 @@ def setup(subparsers, common=None) -> None:
     sp.add_argument("chat")
     sp.add_argument("-n", type=int, default=20)
     sp.set_defaults(func=cmd_admin_log)
+
+    sp = subparsers.add_parser("members", parents=parents, help="List group members (recent first)")
+    sp.add_argument("chat")
+    sp.add_argument("-n", type=int, default=100, help="max members (default 100)")
+    sp.set_defaults(func=cmd_members)
+
+    sp = subparsers.add_parser(
+        "chat-permissions",
+        parents=parents,
+        help="Show or set default member permissions (--send-messages / --no-send-messages …)",
+    )
+    sp.add_argument("chat")
+    for r in _PERMISSION_RIGHTS:
+        sp.add_argument(
+            f"--{r.replace('_', '-')}",
+            action=argparse.BooleanOptionalAction,
+            default=None,
+            dest=r,
+        )
+    sp.set_defaults(func=cmd_chat_permissions)
+
+    sp = subparsers.add_parser(
+        "forum", parents=parents, help="Enable/disable forum mode: tg forum <chat> on|off"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("state", help="on or off")
+    sp.add_argument("--tabs", action="store_true", help="enable forum tabs (on only)")
+    sp.set_defaults(func=cmd_forum)
+
+    sp = subparsers.add_parser("chat-photo-del", parents=parents, help="Remove the chat photo")
+    sp.add_argument("chat")
+    sp.set_defaults(func=cmd_chat_photo_del)

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/src/tgcli/media.py

@@ -123,6 +123,19 @@ async def cmd_vtr(args) -> None:
         print(text)
 
 
+async def cmd_upload(args) -> None:
+    path = os.path.expanduser(args.file)
+    if not os.path.exists(path):
+        raise TgError(f"file not found: {path}")
+    async with run_with_client(args) as client:
+        handle = await client.upload_file(path)
+        md5 = getattr(handle, "md5", None)
+        print(f"Uploaded {path}")
+        print(f"  id={handle.id}  parts={handle.parts}  name={handle.name}")
+        if md5:
+            print(f"  md5={md5.hex()}")
+
+
 def setup(subparsers, common=None) -> None:
     parents = [common] if common else []
     sp = subparsers.add_parser(
@@ -170,3 +183,9 @@ def setup(subparsers, common=None) -> None:
     sp.add_argument("chat")
     sp.add_argument("msg_id", type=int)
     sp.set_defaults(func=cmd_vtr)
+
+    sp = subparsers.add_parser(
+        "upload", parents=parents, help="Upload a file to Telegram without sending it"
+    )
+    sp.add_argument("file")
+    sp.set_defaults(func=cmd_upload)

{telegram_userbot_cli-0.4.0 → telegram_userbot_cli-0.5.0}/src/tgcli/messages.py

@@ -1,6 +1,7 @@
 """Messaging commands: send, reply, edit, del, fwd, poll, schedule, draft,
-reactions, pinning, read state, message links, contact cards."""
+reactions, pinning, read state, message links, contact cards, buttons."""
 
+import contextlib
 import random
 import re
 from datetime import datetime, timedelta
@@ -235,6 +236,82 @@ async def cmd_contact_card(args) -> None:
         print(f"Contact card sent (id: {msg.id})")
 
 
+def _reaction_text(reaction) -> str:
+    if isinstance(reaction, types.ReactionEmoji):
+        return reaction.emoticon
+    if isinstance(reaction, types.ReactionCustomEmoji):
+        return f"custom-emoji:{reaction.document_id}"
+    return str(reaction)
+
+
+async def cmd_buttons(args) -> None:
+    async with run_with_client(args) as client:
+        entity = await resolve_chat(client, args.chat)
+        msg = await client.get_messages(entity, ids=args.msg_id)
+        rows = getattr(msg, "buttons", None)
+        if not rows:
+            raise TgError(f"message {args.msg_id} has no inline buttons")
+        idx = 0
+        for row in rows:
+            cells = []
+            for b in row:
+                kind = "url" if getattr(b, "url", None) else "callback"
+                cells.append(f"[{idx}] {b.text} ({kind})")
+                idx += 1
+            print("  ".join(cells))
+        print(f"\npress one with: tg press {args.chat} {args.msg_id} <index|text>")
+
+
+async def cmd_press(args) -> None:
+    async with run_with_client(args) as client:
+        entity = await resolve_chat(client, args.chat)
+        msg = await client.get_messages(entity, ids=args.msg_id)
+        if not getattr(msg, "buttons", None):
+            raise TgError(f"message {args.msg_id} has no inline buttons")
+        spec = args.button
+        if spec.lstrip("-").isdigit():
+            res = await msg.click(int(spec))
+        else:
+            res = await msg.click(text=spec)
+        answer = getattr(res, "message", None) if res is not None else None
+        alert = bool(getattr(res, "alert", None)) if res is not None else False
+        out = f"Pressed button {spec!r}"
+        if answer:
+            out += f" — bot answered: {answer!r}" + (" (alert)" if alert else "")
+        print(out)
+
+
+async def cmd_reactions(args) -> None:
+    async with run_with_client(args) as client:
+        entity = await resolve_chat(client, args.chat)
+        msg = await client.get_messages(entity, ids=args.msg_id)
+        r = getattr(msg, "reactions", None)
+        # after removing your own reaction the server still returns an
+        # (empty) MessageReactions object instead of None
+        if r is None or not getattr(r, "results", None):
+            print("(no reactions)")
+            return
+        if args.json:
+            print(json_pp(r.to_dict()))
+            return
+        for rc in r.results:
+            chosen = " *" if rc.chosen_order is not None else ""
+            print(f"{_reaction_text(rc.reaction)}  x{rc.count}{chosen}")
+        recent = getattr(r, "recent_reactions", None) or []
+        if recent:
+            print("\nrecent:")
+            for rr in recent:
+                pid = getattr(rr.peer_id, "user_id", None) or rr.peer_id
+                who = str(pid)
+                with contextlib.suppress(Exception):
+                    ent = await client.get_entity(rr.peer_id)
+                    who = (
+                        " ".join(x for x in (ent.first_name, getattr(ent, "last_name", None)) if x)
+                        or f"@{ent.username}"
+                    )
+                print(f"  {_reaction_text(rr.reaction)}  {who}")
+
+
 def setup(subparsers, common=None) -> None:
     parents = [common] if common else []
     sp = subparsers.add_parser(
@@ -363,3 +440,23 @@ def setup(subparsers, common=None) -> None:
     sp.add_argument("name", help='contact name, e.g. "John Doe"')
     sp.add_argument("phone")
     sp.set_defaults(func=cmd_contact_card)
+
+    sp = subparsers.add_parser(
+        "buttons", parents=parents, help="List a message's inline buttons (with press indexes)"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("msg_id", type=int)
+    sp.set_defaults(func=cmd_buttons)
+
+    sp = subparsers.add_parser(
+        "press", parents=parents, help="Press an inline button by index (from `buttons`) or text"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("msg_id", type=int)
+    sp.add_argument("button", help="button index (0-based, from `buttons`) or its text")
+    sp.set_defaults(func=cmd_press)
+
+    sp = subparsers.add_parser("reactions", parents=parents, help="Show reactions on a message")
+    sp.add_argument("chat")
+    sp.add_argument("msg_id", type=int)
+    sp.set_defaults(func=cmd_reactions)