Add id command

app/commands/builtins.py

@@ -73,6 +73,117 @@ def _display_command(command: str) -> str:
     return f"..{command}"
 
 
+def _value_or_none(value: Any) -> str:
+    if value is None or value == "":
+        return "none"
+    return str(value)
+
+
+def _message_text_preview(message: Any, *, limit: int = 180) -> str | None:
+    text = getattr(message, "text", None) or getattr(message, "caption", None)
+    if not text:
+        return None
+    text = str(text).replace("\n", " ").strip()
+    if len(text) <= limit:
+        return text
+    return text[: limit - 1].rstrip() + "..."
+
+
+def _topic_id(message: Any) -> Any | None:
+    topic = getattr(message, "topic", None)
+    topic_id = getattr(topic, "id", None)
+    if topic_id is not None:
+        return topic_id
+    for field in (
+        "message_thread_id",
+        "direct_messages_topic_id",
+        "reply_to_top_message_id",
+    ):
+        value = getattr(message, field, None)
+        if value is not None:
+            return value
+    created_topic = getattr(message, "forum_topic_created", None)
+    return getattr(created_topic, "id", None)
+
+
+def _topic_title(message: Any) -> str | None:
+    topic = getattr(message, "topic", None)
+    title = getattr(topic, "title", None)
+    if title:
+        return str(title)
+    created_topic = getattr(message, "forum_topic_created", None)
+    title = getattr(created_topic, "title", None)
+    return str(title) if title else None
+
+
+def _append_chat_lines(lines: list[str], chat: Any, *, prefix: str = "chat") -> None:
+    lines.append(f"{prefix}_id: {_value_or_none(getattr(chat, 'id', None))}")
+    chat_type = getattr(chat, "type", None)
+    if chat_type is not None:
+        value = getattr(chat_type, "value", chat_type)
+        lines.append(f"{prefix}_type: {_value_or_none(value)}")
+    title = getattr(chat, "title", None)
+    if title:
+        lines.append(f"{prefix}_title: {title}")
+    username = getattr(chat, "username", None)
+    if username:
+        lines.append(f"{prefix}_username: @{username}")
+
+
+def _append_user_lines(lines: list[str], user: Any | None, *, prefix: str = "user") -> None:
+    lines.append(f"{prefix}_id: {_value_or_none(getattr(user, 'id', None))}")
+    if user is None:
+        return
+    username = getattr(user, "username", None)
+    if username:
+        lines.append(f"{prefix}_username: @{username}")
+    lines.append(f"{prefix}_name: {_user_label(user)}")
+
+
+def _append_sender_chat_lines(lines: list[str], chat: Any | None, *, prefix: str = "sender_chat") -> None:
+    if chat is None:
+        return
+    lines.append(f"{prefix}_id: {_value_or_none(getattr(chat, 'id', None))}")
+    title = getattr(chat, "title", None)
+    if title:
+        lines.append(f"{prefix}_title: {title}")
+    username = getattr(chat, "username", None)
+    if username:
+        lines.append(f"{prefix}_username: @{username}")
+
+
+def _format_id_report(ctx: "CommandContext") -> str:
+    message = ctx.message
+    lines: list[str] = ["Current message:"]
+    _append_chat_lines(lines, getattr(message, "chat", None))
+    lines.append(f"message_id: {_value_or_none(getattr(message, 'id', None))}")
+    lines.append(f"thread_id: {_value_or_none(_topic_id(message))}")
+    topic_title = _topic_title(message)
+    if topic_title:
+        lines.append(f"thread_title: {topic_title}")
+    _append_user_lines(lines, getattr(message, "from_user", None), prefix="user")
+    _append_sender_chat_lines(lines, getattr(message, "sender_chat", None))
+
+    reply = getattr(message, "reply_to_message", None)
+    if reply is not None:
+        lines.extend(["", "Replied message:"])
+        lines.append(f"reply_message_id: {_value_or_none(getattr(reply, 'id', None))}")
+        lines.append(f"reply_thread_id: {_value_or_none(_topic_id(reply))}")
+        reply_topic_title = _topic_title(reply)
+        if reply_topic_title:
+            lines.append(f"reply_thread_title: {reply_topic_title}")
+        _append_user_lines(lines, getattr(reply, "from_user", None), prefix="reply_user")
+        _append_sender_chat_lines(lines, getattr(reply, "sender_chat", None), prefix="reply_sender_chat")
+        media = getattr(reply, "media", None)
+        if media is not None:
+            lines.append(f"reply_media: {_value_or_none(getattr(media, 'value', media))}")
+        preview = _message_text_preview(reply)
+        if preview:
+            lines.append(f"reply_text: {preview}")
+
+    return "\n".join(lines)
+
+
 def _chunk_text(text: str, limit: int = 3900) -> list[str]:
     if len(text) <= limit:
         return [text]
@@ -265,6 +376,16 @@ async def status(ctx: "CommandContext") -> None:
     await ctx.reply("\n".join(lines))
 
 
+@command_registry.command(
+    "id",
+    "Show chat, thread, user, and replied message IDs",
+    usage=".id",
+    category="system",
+)
+async def id_command(ctx: "CommandContext") -> None:
+    await ctx.reply(_format_id_report(ctx))
+
+
 @command_registry.command(
     "help",
     "Show command catalog",