telegram-userbot-cli 0.2.0__tar.gz → 0.3.0__tar.gz

{telegram_userbot_cli-0.2.0 → telegram_userbot_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: telegram-userbot-cli
-Version: 0.2.0
+Version: 0.3.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
@@ -27,6 +27,8 @@ no daemon, no external service**. Everything the CLI does lives in the CLI.
 - QR-code login (`tg login --qr`) with an independent session
 - Messaging: send / reply / edit / delete / forward / polls / schedule /
   drafts / reactions / pinning
+- Group administration: create groups/channels, invite / kick / ban,
+  admin promotion with granular rights, slow mode, forum topics, admin log
 - Chat management: archive, mute, edit title / description / photo,
   invite links, clear history
 - Media: download, send files / albums / voice notes / stickers / GIFs,
@@ -135,6 +137,27 @@ tg logout          # remove the session
 | `tg status <user>` | Show a user's online status |
 | `tg common-chats <user>` | List chats you share with a user |
 
+### Group administration (v3)
+
+| Command | Description |
+|---|---|
+| `tg new-group <title> <user...>` | Create a basic group with initial members |
+| `tg new-channel <title> [--about text]` | Create a channel; `--group` creates a supergroup |
+| `tg invite <chat> <user...>` | Invite users (supergroups & basic groups) |
+| `tg kick <chat> <user...>` | Remove users (supergroup kick = view-messages ban; `unban` to reverse) |
+| `tg leave <chat>` | Leave a group/channel |
+| `tg ban <chat> <user> [days]` | Ban a user (permanent unless days given); supergroups only |
+| `tg unban <chat> <user>` | Unban a user |
+| `tg banned <chat>` | List banned users (`--json` supported) |
+| `tg admins <chat>` | List admins with ranks |
+| `tg promote <chat> <user> [--title rank]` | Promote with the standard right set |
+| `tg demote <chat> <user>` | Remove admin rights |
+| `tg admin-rights <chat> <user> <flags...>` | Set exact rights: `--change-info --post-messages --edit-messages --delete-messages --ban-users --invite-users --pin-messages --add-admins --anonymous --manage-call --other --manage-topics …`; `--rank` |
+| `tg slow-mode <chat> [seconds]` | Set slow mode (0 = disable); supergroups only |
+| `tg topics <chat>` | List forum topics |
+| `tg topic-create <chat> <title> [text]` | Create a forum topic, optionally with a first message |
+| `tg admin-log <chat> [-n]` | Recent admin actions |
+
 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.2.0 → telegram_userbot_cli-0.3.0}/README-zh.md

@@ -13,6 +13,7 @@
 
 - 扫码登录（`tg login --qr`），使用独立会话
 - 消息：发送 / 引用回复 / 编辑 / 删除 / 转发 / 投票 / 定时 / 草稿 / 表情回应 / 置顶
+- 群组管理：建群 / 建频道、邀请 / 踢人 / 封禁、管理员升降级（细粒度权限）、慢速模式、论坛话题、管理日志
 - 聊天管理：归档、免打扰、修改群名 / 简介 / 群头像、邀请链接、清空历史
 - 媒体：下载、发文件 / 相册 / 语音条 / 贴纸 / GIF、发送名片
 - 聊天：会话列表、历史记录、置顶消息、会话内与全局搜索、在线状态、共同群组
@@ -114,6 +115,27 @@ tg logout          # 退出登录并删除会话
 | `tg status <用户>` | 查看用户在线状态 |
 | `tg common-chats <用户>` | 列出与该用户的共同群组 |
 
+### 群组管理（v3）
+
+| 命令 | 说明 |
+|---|---|
+| `tg new-group <标题> <用户...>` | 建基本群并拉入初始成员 |
+| `tg new-channel <标题> [--about 简介]` | 建频道；`--group` 建超级群组 |
+| `tg invite <会话> <用户...>` | 邀请用户（超级群组与基本群都支持） |
+| `tg kick <会话> <用户...>` | 移出用户（超级群组的踢人 = 禁言封禁，`unban` 可恢复） |
+| `tg leave <会话>` | 退出群组/频道 |
+| `tg ban <会话> <用户> [天数]` | 封禁（不带天数 = 永久）；仅超级群组 |
+| `tg unban <会话> <用户>` | 解除封禁 |
+| `tg banned <会话>` | 封禁名单（支持 `--json`） |
+| `tg admins <会话>` | 管理员列表（含头衔） |
+| `tg promote <会话> <用户> [--title 头衔]` | 升级为管理员（标准权限集） |
+| `tg demote <会话> <用户>` | 撤销管理员 |
+| `tg admin-rights <会话> <用户> <权限...>` | 设置精确权限：`--change-info --post-messages --edit-messages --delete-messages --ban-users --invite-users --pin-messages --add-admins --anonymous --manage-call --other --manage-topics …`；`--rank` 定头衔 |
+| `tg slow-mode <会话> [秒]` | 设置慢速模式（0 = 关闭）；仅超级群组 |
+| `tg topics <会话>` | 列出论坛话题 |
+| `tg topic-create <会话> <标题> [首条消息]` | 创建论坛话题 |
+| `tg admin-log <会话> [-n]` | 近期管理操作日志 |
+
 全局选项：`--account`（v1 仅 default）、`--json`（原始 JSON 输出）。
 退出码：`0` 成功、`1` 命令错误、`2` 配置/连接/会话错误、`130` 中断。
 

{telegram_userbot_cli-0.2.0 → telegram_userbot_cli-0.3.0}/README.md

@@ -14,6 +14,8 @@ no daemon, no external service**. Everything the CLI does lives in the CLI.
 - QR-code login (`tg login --qr`) with an independent session
 - Messaging: send / reply / edit / delete / forward / polls / schedule /
   drafts / reactions / pinning
+- Group administration: create groups/channels, invite / kick / ban,
+  admin promotion with granular rights, slow mode, forum topics, admin log
 - Chat management: archive, mute, edit title / description / photo,
   invite links, clear history
 - Media: download, send files / albums / voice notes / stickers / GIFs,
@@ -122,6 +124,27 @@ tg logout          # remove the session
 | `tg status <user>` | Show a user's online status |
 | `tg common-chats <user>` | List chats you share with a user |
 
+### Group administration (v3)
+
+| Command | Description |
+|---|---|
+| `tg new-group <title> <user...>` | Create a basic group with initial members |
+| `tg new-channel <title> [--about text]` | Create a channel; `--group` creates a supergroup |
+| `tg invite <chat> <user...>` | Invite users (supergroups & basic groups) |
+| `tg kick <chat> <user...>` | Remove users (supergroup kick = view-messages ban; `unban` to reverse) |
+| `tg leave <chat>` | Leave a group/channel |
+| `tg ban <chat> <user> [days]` | Ban a user (permanent unless days given); supergroups only |
+| `tg unban <chat> <user>` | Unban a user |
+| `tg banned <chat>` | List banned users (`--json` supported) |
+| `tg admins <chat>` | List admins with ranks |
+| `tg promote <chat> <user> [--title rank]` | Promote with the standard right set |
+| `tg demote <chat> <user>` | Remove admin rights |
+| `tg admin-rights <chat> <user> <flags...>` | Set exact rights: `--change-info --post-messages --edit-messages --delete-messages --ban-users --invite-users --pin-messages --add-admins --anonymous --manage-call --other --manage-topics …`; `--rank` |
+| `tg slow-mode <chat> [seconds]` | Set slow mode (0 = disable); supergroups only |
+| `tg topics <chat>` | List forum topics |
+| `tg topic-create <chat> <title> [text]` | Create a forum topic, optionally with a first message |
+| `tg admin-log <chat> [-n]` | Recent admin actions |
+
 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.2.0 → telegram_userbot_cli-0.3.0}/ROADMAP.md

@@ -37,16 +37,23 @@ Chat management:
   keep the other side's copy)
 - ✅ `status <user>` / `common-chats <user>` — online status, common chats
 
-### v3 — Group administration
+### v3 — Group administration (shipped)
 
-- 🚧 `new-group <title> <user...>` / `new-channel <title>` — create groups/channels
-- 🚧 `invite <chat> <user...>` / `kick <chat> <user...>` / `leave <chat>`
-- 🚧 `ban <chat> <user> [days]` / `unban <chat> <user>` / `banned <chat>`
-- 🚧 `admins <chat>` / `promote <chat> <user> [--title]` / `demote <chat> <user>` /
+- ✅ `new-group <title> <user...>` / `new-channel <title>` — create groups
+  (`--group` flag makes a supergroup) /channels
+- ✅ `invite <chat> <user...>` / `kick <chat> <user...>` / `leave <chat>`
+  (basic-group kick/leave use `messages.DeleteChatUser`, supergroup kick is a
+  view-messages ban like official clients)
+- ✅ `ban <chat> <user> [days]` / `unban <chat> <user>` / `banned <chat>`
+  (the working participant filter on the current TL layer is
+  `ChannelParticipantsKicked`, not `ChannelParticipantsBanned`)
+- ✅ `admins <chat>` / `promote <chat> <user> [--title]` / `demote <chat> <user>` /
   `admin-rights <chat> <user> ...` — admin management with granular rights
-- 🚧 `slow-mode <chat> [seconds]` — set/disable slow mode
-- 🚧 `topic <chat> ...` — forum topics (list/create)
-- 🚧 `admin-log <chat>` — recent admin actions
+  (basic groups use `messages.EditChatAdmin`, no titles)
+- ✅ `slow-mode <chat> [seconds]` — set/disable slow mode
+- ✅ `topics <chat>` / `topic-create <chat> <title> [text]` — forum topics
+  (list/create)
+- ✅ `admin-log <chat>` — recent admin actions
 
 ### v4 — Contacts, profile & misc
 

{telegram_userbot_cli-0.2.0 → telegram_userbot_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "telegram-userbot-cli"
-version = "0.2.0"
+version = "0.3.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.2.0 → telegram_userbot_cli-0.3.0}/src/tgcli/__init__.py

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

{telegram_userbot_cli-0.2.0 → telegram_userbot_cli-0.3.0}/src/tgcli/cli.py

@@ -6,7 +6,7 @@ import sys
 
 from telethon import errors
 
-from . import __version__, auth, chats, dialogs, media, messages, resolve
+from . import __version__, auth, chats, dialogs, groups, media, messages, resolve
 from .output import TgError
 
 
@@ -41,7 +41,7 @@ def build_parser() -> argparse.ArgumentParser:
     sp2 = sub.add_parser("logout", parents=[common], help="Log out and remove the session")
     sp2.set_defaults(func=auth.cmd_logout)
 
-    for mod in (messages, chats, media, dialogs):
+    for mod in (messages, chats, media, dialogs, groups):
         mod.setup(sub, common)
 
     resolve.setup_alias(sub, common)

telegram_userbot_cli-0.3.0/src/tgcli/groups.py

@@ -0,0 +1,534 @@
+"""Group administration: create, members, bans, admins, slow mode, topics, admin log."""
+
+import random
+import re
+from datetime import datetime, timedelta, timezone
+
+from telethon import functions, types
+
+from .client import run_with_client
+from .output import TgError, json_pp
+from .resolve import resolve_chat
+
+# rights granted by `promote`: full admin minus the dangerous ones
+_PROMOTE_RIGHTS = dict(
+    change_info=True,
+    post_messages=True,
+    edit_messages=True,
+    delete_messages=True,
+    ban_users=True,
+    invite_users=True,
+    pin_messages=True,
+    manage_call=True,
+    manage_topics=True,
+    other=True,
+)
+
+# granular flags accepted by `admin-rights` (arg name == ChatAdminRights field)
+_RIGHT_FLAGS = [
+    "change_info",
+    "post_messages",
+    "edit_messages",
+    "delete_messages",
+    "ban_users",
+    "invite_users",
+    "pin_messages",
+    "add_admins",
+    "anonymous",
+    "manage_call",
+    "other",
+    "manage_topics",
+    "post_stories",
+    "edit_stories",
+    "delete_stories",
+]
+
+
+async def _peer(client, chat):
+    return await client.get_input_entity(await resolve_chat(client, chat))
+
+
+def _require_group(peer):
+    """Return 'channel' (supergroup/channel) or 'basic', or raise for non-groups."""
+    if isinstance(peer, types.InputPeerChannel):
+        return "channel"
+    if isinstance(peer, types.InputPeerChat):
+        return "basic"
+    raise TgError("this command only works for groups and channels")
+
+
+def _users_by_id(res) -> dict:
+    return {u.id: u for u in getattr(res, "users", []) or []}
+
+
+def _display(users: dict, uid) -> str:
+    u = users.get(uid)
+    if u is None:
+        return str(uid)
+    name = " ".join(x for x in (u.first_name, u.last_name) if x)
+    return name or getattr(u, "username", None) and f"@{u.username}" or str(uid)
+
+
+def _action_text(action) -> str:
+    name = type(action).__name__.removeprefix("AdminLogEventAction")
+    return re.sub(r"([a-z])([A-Z])", r"\1 \2", name).lower()
+
+
+async def cmd_new_group(args) -> None:
+    if not args.users:
+        raise TgError("a group needs at least one member", "e.g. tg new-group Friends @alice")
+    async with run_with_client(args) as client:
+        res = await client(functions.messages.CreateChatRequest(users=args.users, title=args.title))
+        upd = getattr(res, "updates", res)
+        chat = next(iter(getattr(upd, "chats", []) or []), None)
+        print(f"Group created: {args.title} (id: {getattr(chat, 'id', '?')})")
+
+
+async def cmd_new_channel(args) -> None:
+    async with run_with_client(args) as client:
+        res = await client(
+            functions.channels.CreateChannelRequest(
+                title=args.title,
+                about=args.about or "",
+                broadcast=not args.group,
+                megagroup=args.group,
+            )
+        )
+        ch = next(iter(getattr(res, "chats", []) or []), None)
+        kind = "supergroup" if args.group else "channel"
+        if ch is not None and getattr(ch, "id", None):
+            print(f"{kind.capitalize()} created: {args.title} (id: -100{ch.id})")
+        else:
+            print(f"{kind.capitalize()} created: {args.title}")
+
+
+async def cmd_invite(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        kind = _require_group(peer)
+        n = 0
+        if kind == "channel":
+            res = await client(functions.channels.InviteToChannelRequest(peer, args.users))
+            missing = getattr(res, "missing_invitees", []) or []
+            n = len(args.users) - len(missing)
+            if missing:
+                print(f"warning: {len(missing)} user(s) could not be invited (privacy settings)")
+        else:
+            for u in args.users:
+                await client(
+                    functions.messages.AddChatUserRequest(
+                        chat_id=peer.chat_id, user_id=u, fwd_limit=0
+                    )
+                )
+                n += 1
+        print(f"Invited {n} user(s)")
+
+
+async def cmd_kick(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        kind = _require_group(peer)
+        for u in args.users:
+            if kind == "channel":
+                # no dedicated kick call: "remove" == view-messages ban, as official clients do
+                await client(
+                    functions.channels.EditBannedRequest(
+                        peer,
+                        u,
+                        types.ChatBannedRights(until_date=None, view_messages=True),
+                    )
+                )
+            else:
+                await client(
+                    functions.messages.DeleteChatUserRequest(chat_id=peer.chat_id, user_id=u)
+                )
+        print(f"Kicked {len(args.users)} user(s)")
+
+
+async def cmd_leave(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        kind = _require_group(peer)
+        if kind == "channel":
+            await client(functions.channels.LeaveChannelRequest(peer))
+        else:
+            await client(
+                functions.messages.DeleteChatUserRequest(
+                    chat_id=peer.chat_id, user_id=types.InputUserSelf()
+                )
+            )
+        print("Left the group")
+
+
+async def _require_channel(peer):
+    if _require_group(peer) != "channel":
+        raise TgError(
+            "this command is only supported in supergroups and channels",
+            "basic groups have no ban list / slow mode / topics",
+        )
+    return peer
+
+
+async def cmd_ban(args) -> None:
+    until = None
+    if args.days:
+        until = datetime.now(timezone.utc) + timedelta(days=args.days)
+    async with run_with_client(args) as client:
+        peer = await _require_channel(await _peer(client, args.chat))
+        await client(
+            functions.channels.EditBannedRequest(
+                peer,
+                args.user,
+                types.ChatBannedRights(until_date=until, view_messages=True),
+            )
+        )
+        print(f"Banned {args.user}" + (f" for {args.days}d" if args.days else " permanently"))
+
+
+async def cmd_unban(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _require_channel(await _peer(client, args.chat))
+        await client(
+            functions.channels.EditBannedRequest(
+                peer, args.user, types.ChatBannedRights(until_date=None)
+            )
+        )
+        print(f"Unbanned {args.user}")
+
+
+async def cmd_banned(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _require_channel(await _peer(client, args.chat))
+        res = await client(
+            functions.channels.GetParticipantsRequest(
+                # despite the name, Kicked (not Banned) is the filter that
+                # actually returns banned users on the current TL layer
+                peer,
+                types.ChannelParticipantsKicked(q=""),
+                offset=0,
+                limit=100,
+                hash=0,
+            )
+        )
+        rows = [p for p in res.participants if isinstance(p, types.ChannelParticipantBanned)]
+        users = _users_by_id(res)
+        if args.json:
+            print(json_pp([p.to_dict() for p in rows]))
+            return
+        if not rows:
+            print("(no banned users)")
+            return
+        for p in rows:
+            uid = p.peer.user_id
+            until = getattr(p.banned_rights, "until_date", None)
+            dur = f"until {until:%Y-%m-%d}" if until and until.year > 1971 else "permanent"
+            print(f"{uid:>14}  {_display(users, uid)}  {dur}  by {p.kicked_by}")
+
+
+async def cmd_admins(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        kind = _require_group(peer)
+        if kind == "channel":
+            res = await client(
+                functions.channels.GetParticipantsRequest(
+                    peer,
+                    types.ChannelParticipantsAdmins(),
+                    offset=0,
+                    limit=50,
+                    hash=0,
+                )
+            )
+            rows = []
+            for p in res.participants:
+                if isinstance(p, types.ChannelParticipantCreator):
+                    rows.append((p.user_id, p.rank or "creator"))
+                else:
+                    rows.append((p.user_id, getattr(p, "rank", "") or "admin"))
+            users = _users_by_id(res)
+        else:
+            res = await client(functions.messages.GetFullChatRequest(chat_id=peer.chat_id))
+            users = _users_by_id(res)
+            rows = []
+            for p in res.full_chat.participants.participants:
+                if isinstance(p, types.ChatParticipantCreator):
+                    rows.append((p.user_id, "creator"))
+                elif isinstance(p, types.ChatParticipantAdmin):
+                    rows.append((p.user_id, "admin"))
+        if args.json:
+            print(
+                json_pp(
+                    [{"id": uid, "rank": rank, "user": _display(users, uid)} for uid, rank in rows]
+                )
+            )
+            return
+        if not rows:
+            print("(no admins)")
+            return
+        for uid, rank in rows:
+            print(f"{uid:>14}  {rank:<8} {_display(users, uid)}")
+
+
+async def cmd_promote(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        if _require_group(peer) == "channel":
+            rank = args.title or "admin"
+            await client(
+                functions.channels.EditAdminRequest(
+                    peer,
+                    args.user,
+                    types.ChatAdminRights(**_PROMOTE_RIGHTS),
+                    rank=rank,
+                )
+            )
+            print(f"Promoted {args.user} (rank: {rank})")
+        else:
+            if args.title:
+                raise TgError("basic groups have no admin titles")
+            await client(
+                functions.messages.EditChatAdminRequest(
+                    chat_id=peer.chat_id, user_id=args.user, is_admin=True
+                )
+            )
+            print(f"Promoted {args.user}")
+
+
+async def cmd_demote(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.EditAdminRequest(
+                    peer, args.user, types.ChatAdminRights(), rank=""
+                )
+            )
+        else:
+            await client(
+                functions.messages.EditChatAdminRequest(
+                    chat_id=peer.chat_id, user_id=args.user, is_admin=False
+                )
+            )
+        print(f"Demoted {args.user}")
+
+
+async def cmd_admin_rights(args) -> None:
+    granted = {f: True for f in _RIGHT_FLAGS if getattr(args, f, False)}
+    if not granted and not args.rank:
+        raise TgError(
+            "no rights requested",
+            "pass flags like --pin-messages --delete-messages,"
+            " or use `tg promote` for the standard set",
+        )
+    async with run_with_client(args) as client:
+        peer = await _require_channel(await _peer(client, args.chat))
+        await client(
+            functions.channels.EditAdminRequest(
+                peer, args.user, types.ChatAdminRights(**granted), rank=args.rank or ""
+            )
+        )
+        names = ", ".join(granted) or "(none)"
+        print(
+            f"Rights set for {args.user}: {names}" + (f" (rank: {args.rank})" if args.rank else "")
+        )
+
+
+async def cmd_slow_mode(args) -> None:
+    seconds = args.seconds or 0
+    async with run_with_client(args) as client:
+        peer = await _require_channel(await _peer(client, args.chat))
+        await client(functions.channels.ToggleSlowModeRequest(peer, seconds))
+        print(f"Slow mode {'disabled' if seconds == 0 else f'set to {seconds}s'}")
+
+
+async def _forum_check(client, peer):
+    ent = await client.get_entity(peer)
+    if not getattr(ent, "forum", False):
+        raise TgError("this group has forum mode disabled", "topics only exist in forum groups")
+    return ent
+
+
+async def cmd_topics(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        await _require_channel(peer)
+        await _forum_check(client, peer)
+        res = await client(
+            functions.messages.GetForumTopicsRequest(
+                peer=peer,
+                offset_date=None,
+                offset_id=0,
+                offset_topic=0,
+                limit=args.n,
+            )
+        )
+        topics = getattr(res, "topics", []) or []
+        if args.json:
+            print(json_pp([t.to_dict() for t in topics]))
+            return
+        if not topics:
+            print("(no topics)")
+            return
+        for t in topics:
+            unread = f"  ({t.unread_count} unread)" if t.unread_count else ""
+            print(f"[{t.id}] {t.title}{unread}")
+
+
+async def cmd_topic_create(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _peer(client, args.chat)
+        await _require_channel(peer)
+        await _forum_check(client, peer)
+        res = await client(
+            functions.messages.CreateForumTopicRequest(
+                peer=peer, title=args.title, random_id=random.randint(1, 2**31)
+            )
+        )
+        topic_id = None
+        for u in getattr(res, "updates", []) or []:
+            msg = getattr(u, "message", None)
+            if msg is not None:
+                topic_id = msg.id
+                break
+        if topic_id is None:  # fallback: find the fresh topic by title
+            lst = await client(
+                functions.messages.GetForumTopicsRequest(
+                    peer=peer, offset_date=None, offset_id=0, offset_topic=0, limit=20
+                )
+            )
+            topic_id = next((t.id for t in lst.topics if t.title == args.title), None)
+        if args.text and topic_id is not None:
+            await client.send_message(peer, " ".join(args.text), reply_to=topic_id)
+        print(f"Topic created: [{topic_id}] {args.title}")
+
+
+async def cmd_admin_log(args) -> None:
+    async with run_with_client(args) as client:
+        peer = await _require_channel(await _peer(client, args.chat))
+        res = await client(
+            functions.channels.GetAdminLogRequest(
+                peer,
+                q="",
+                max_id=0,
+                min_id=0,
+                limit=args.n,
+            )
+        )
+        events = getattr(res, "events", []) or []
+        users = _users_by_id(res)
+        if args.json:
+            print(json_pp([e.to_dict() for e in events]))
+            return
+        if not events:
+            print("(no admin actions recorded)")
+            return
+        for e in events:
+            date = e.date.astimezone().strftime("%Y-%m-%d %H:%M")
+            print(f"[{e.id}] {date}  {_display(users, e.user_id)}: {_action_text(e.action)}")
+
+
+def setup(subparsers, common=None) -> None:
+    parents = [common] if common else []
+    sp = subparsers.add_parser(
+        "new-group", parents=parents, help="Create a basic group, e.g. tg new-group Friends @alice"
+    )
+    sp.add_argument("title")
+    sp.add_argument("users", nargs="+")
+    sp.set_defaults(func=cmd_new_group)
+
+    sp = subparsers.add_parser(
+        "new-channel", parents=parents, help="Create a channel (--group for a supergroup)"
+    )
+    sp.add_argument("title")
+    sp.add_argument("--about", default="")
+    sp.add_argument("--group", action="store_true", help="create a supergroup instead")
+    sp.set_defaults(func=cmd_new_channel)
+
+    sp = subparsers.add_parser("invite", parents=parents, help="Invite users to a group")
+    sp.add_argument("chat")
+    sp.add_argument("users", nargs="+")
+    sp.set_defaults(func=cmd_invite)
+
+    sp = subparsers.add_parser("kick", parents=parents, help="Remove users from a group")
+    sp.add_argument("chat")
+    sp.add_argument("users", nargs="+")
+    sp.set_defaults(func=cmd_kick)
+
+    sp = subparsers.add_parser("leave", parents=parents, help="Leave a group/channel")
+    sp.add_argument("chat")
+    sp.set_defaults(func=cmd_leave)
+
+    sp = subparsers.add_parser(
+        "ban", parents=parents, help="Ban a user (permanent unless [days] given); supergroups only"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("user")
+    sp.add_argument("days", nargs="?", type=int, default=None)
+    sp.set_defaults(func=cmd_ban)
+
+    sp = subparsers.add_parser("unban", parents=parents, help="Unban a user; supergroups only")
+    sp.add_argument("chat")
+    sp.add_argument("user")
+    sp.set_defaults(func=cmd_unban)
+
+    sp = subparsers.add_parser(
+        "banned", parents=parents, help="List banned users; supergroups only"
+    )
+    sp.add_argument("chat")
+    sp.set_defaults(func=cmd_banned)
+
+    sp = subparsers.add_parser("admins", parents=parents, help="List admins (and their ranks)")
+    sp.add_argument("chat")
+    sp.set_defaults(func=cmd_admins)
+
+    sp = subparsers.add_parser(
+        "promote", parents=parents, help="Promote to admin with the standard right set"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("user")
+    sp.add_argument("--title", default=None, help="admin rank/title")
+    sp.set_defaults(func=cmd_promote)
+
+    sp = subparsers.add_parser("demote", parents=parents, help="Remove admin rights")
+    sp.add_argument("chat")
+    sp.add_argument("user")
+    sp.set_defaults(func=cmd_demote)
+
+    sp = subparsers.add_parser(
+        "admin-rights", parents=parents, help="Set exact admin rights (supergroups only)"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("user")
+    for f in _RIGHT_FLAGS:
+        sp.add_argument(f"--{f.replace('_', '-')}", action="store_true", dest=f)
+    sp.add_argument("--rank", default="", help="admin rank/title")
+    sp.set_defaults(func=cmd_admin_rights)
+
+    sp = subparsers.add_parser(
+        "slow-mode", parents=parents, help="Set slow mode seconds (0 = disable); supergroups only"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("seconds", nargs="?", type=int, default=0)
+    sp.set_defaults(func=cmd_slow_mode)
+
+    sp = subparsers.add_parser("topics", parents=parents, help="List forum topics")
+    sp.add_argument("chat")
+    sp.add_argument("-n", type=int, default=20)
+    sp.set_defaults(func=cmd_topics)
+
+    sp = subparsers.add_parser(
+        "topic-create",
+        parents=parents,
+        help="Create a forum topic, optionally with a first message",
+    )
+    sp.add_argument("chat")
+    sp.add_argument("title")
+    sp.add_argument("text", nargs="*", default=[])
+    sp.set_defaults(func=cmd_topic_create)
+
+    sp = subparsers.add_parser(
+        "admin-log", parents=parents, help="Recent admin actions; supergroups only"
+    )
+    sp.add_argument("chat")
+    sp.add_argument("-n", type=int, default=20)
+    sp.set_defaults(func=cmd_admin_log)