TeLLMgramBot 3.10.3__tar.gz → 3.10.4__tar.gz

{tellmgrambot-3.10.3 → tellmgrambot-3.10.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TeLLMgramBot
-Version: 3.10.3
+Version: 3.10.4
 Summary: LLM-powered Telegram bot (OpenAI + Anthropic)
 Home-page: https://github.com/Digital-Heresy/TeLLMgramBot
 Author: Digital Heresy
@@ -124,7 +124,7 @@ os.environ['TELLMGRAMBOT_VIRUSTOTAL_API_KEY'] = my_vault.get('virustotal_key')
 - `/nick <name>` - Set your nickname (for bot use in group chats).
 - `/forget` - Clear your conversation history. In private chats, clears everything and resets all active sessions. In group chats, removes only your messages.
 - `/private` - Toggle private mode (private chats only). When ON, your messages are excluded from group context loading.
-- `/help` - Display all available commands and usage information (includes administrator-only commands).
+- `/help` - Display available commands and usage information. In private chats, if you are a bot owner, also shows administrator-only commands (`/start`, `/stop`, `/wipe`).
 
 ### Group Chat Triggers
 The bot responds in groups when you:
@@ -144,7 +144,7 @@ When the bot is triggered in a group and about to respond (not deferring to anot
 1. Ensure API keys are set up and your Telegram bot is created via BotFather.
 2. Install TeLLMgramBot: `pip install TeLLMgramBot`
 3. Configure the bot via `config.yaml` (created on first run):
-   - `bot_owner`: Your Telegram username (required, no `@`)
+   - `bot_owner`: Telegram username(s) with admin access (required, no `@`). Accepts a single string or a YAML list of usernames.
    - `chat_model`: LLM model for conversation (e.g. `gpt-4o-mini` or `claude-sonnet-4-6`)
    - `url_model`: LLM model for URL analysis (e.g. `gpt-4o` or `claude-haiku-4-5`)
    - `bot_nickname` / `bot_initials`: Names the bot responds to in groups

{tellmgrambot-3.10.3 → tellmgrambot-3.10.4}/README.md

@@ -92,7 +92,7 @@ os.environ['TELLMGRAMBOT_VIRUSTOTAL_API_KEY'] = my_vault.get('virustotal_key')
 - `/nick <name>` - Set your nickname (for bot use in group chats).
 - `/forget` - Clear your conversation history. In private chats, clears everything and resets all active sessions. In group chats, removes only your messages.
 - `/private` - Toggle private mode (private chats only). When ON, your messages are excluded from group context loading.
-- `/help` - Display all available commands and usage information (includes administrator-only commands).
+- `/help` - Display available commands and usage information. In private chats, if you are a bot owner, also shows administrator-only commands (`/start`, `/stop`, `/wipe`).
 
 ### Group Chat Triggers
 The bot responds in groups when you:
@@ -112,7 +112,7 @@ When the bot is triggered in a group and about to respond (not deferring to anot
 1. Ensure API keys are set up and your Telegram bot is created via BotFather.
 2. Install TeLLMgramBot: `pip install TeLLMgramBot`
 3. Configure the bot via `config.yaml` (created on first run):
-   - `bot_owner`: Your Telegram username (required, no `@`)
+   - `bot_owner`: Telegram username(s) with admin access (required, no `@`). Accepts a single string or a YAML list of usernames.
    - `chat_model`: LLM model for conversation (e.g. `gpt-4o-mini` or `claude-sonnet-4-6`)
    - `url_model`: LLM model for URL analysis (e.g. `gpt-4o` or `claude-haiku-4-5`)
    - `bot_nickname` / `bot_initials`: Names the bot responds to in groups

{tellmgrambot-3.10.3 → tellmgrambot-3.10.4}/TeLLMgramBot/TeLLMgramBot.py

@@ -91,23 +91,49 @@ class TelegramBot:
             raise
 
     async def tele_commands(self, update: Update, context: ContextTypes.DEFAULT_TYPE):
-        """Show all the commands available when the user sends `/help` to the bot."""
-        await update.message.reply_text("TeLLMgramBot commands:\n"
+        """
+        Show available commands when the user sends `/help` to the bot.
+
+        Displays general commands (/nick, /forget, /private, /help) to all users.
+        Admin commands (/start, /stop, /wipe) are shown only to usernames in bot_owner list,
+        and only in private chats (not in groups).
+
+        Args:
+            update: Telegram Update object containing the /help message.
+            context: Telegram context for sending the reply.
+        """
+        uname = update.message.from_user.username
+        chat_type = update.message.chat.type
+        text = (
+            "TeLLMgramBot commands:\n"
             "/nick - Set your nickname (e.g. \"/nick B0b #2\").\n"
-            "/forget - Clear all of your conversations.\n"
+            "/forget - Clear memories of all your conversations.\n"
             "/private - Toggle private mode (private chats only).\n"
-            "/help - Display this usage information.\n\n"
-            "Chat history will still show in your Telegram client.\n\n"
-            "Administrator-only commands:\n"
-            "/start - Go online to receive new responses (default).\n"
-            "/stop - Go offline to prevent new responses.\n"
-            "/wipe - Permanently delete all conversation data (irreversible).\n"
+            "/help - Display this usage information."
         )
+        if uname in self.telegram['owners'] and chat_type == 'private':
+            text += (
+                "\n\nAdmin commands:\n"
+                "/start - Go online to receive new responses (default).\n"
+                "/stop - Go offline to prevent new responses.\n"
+                "/wipe - Permanently delete all conversation data (irreversible)."
+            )
+        await update.message.reply_text(text)
 
     async def tele_start_command(self, update: Update, context: ContextTypes.DEFAULT_TYPE):
-        """A bot_owner-only command to go online and handle any new messages."""
+        """
+        Start the bot and resume handling new messages (admin-only).
+
+        Only usernames in self.telegram['owners'] can execute this command.
+        If the sender is an owner, sets self._online to True and confirms via reply.
+        Otherwise, denies access with "Sorry, I can't do that for you."
+
+        Args:
+            update: Telegram Update object containing the /start message.
+            context: Telegram context for sending the reply.
+        """
         uname = update.message.from_user.username
-        if uname == self.telegram['owner']:
+        if uname in self.telegram['owners']:
             self._online = True
             greeting_text = f"Oh, hello {update.message.from_user.first_name}! Let me get to work!"
             await update.message.reply_text(greeting_text)
@@ -115,18 +141,41 @@ class TelegramBot:
             await update.message.reply_text("Sorry, I can't do that for you.")
 
     async def tele_stop_command(self, update: Update, context: ContextTypes.DEFAULT_TYPE):
-        """A bot_owner-only command to go offline and not handle any new messages."""
+        """
+        Stop the bot and pause handling new messages (admin-only).
+
+        Only usernames in self.telegram['owners'] can execute this command.
+        If the sender is an owner, sets self._online to False and confirms via reply.
+        Otherwise, denies access with "Sorry, I can't do that for you."
+
+        Args:
+            update: Telegram Update object containing the /stop message.
+            context: Telegram context for sending the reply.
+        """
         uname = update.message.from_user.username
-        if uname == self.telegram['owner']:
+        if uname in self.telegram['owners']:
             self._online = False
             await update.message.reply_text("Sure thing boss, cutting out!")
         else:
             await update.message.reply_text("Sorry, I can't do that for you.")
 
     async def tele_wipe_command(self, update: Update, context: ContextTypes.DEFAULT_TYPE):
-        """A bot_owner-only command to permanently delete all messages, users, and chats from the database."""
+        """
+        Permanently delete all conversation data from the database (admin-only).
+
+        Only usernames in self.telegram['owners'] can execute this command.
+        If the sender is an owner, deletes all messages, users, and chats via wipe_all_data(),
+        clears in-memory conversations and token warnings, and confirms via reply.
+        Otherwise, denies access with "Sorry, I can't do that for you."
+
+        This action is irreversible - all conversation history is permanently lost.
+
+        Args:
+            update: Telegram Update object containing the /wipe message.
+            context: Telegram context for sending the reply.
+        """
         uname = update.message.from_user.username
-        if uname != self.telegram['owner']:
+        if uname not in self.telegram['owners']:
             await update.message.reply_text("Sorry, I can't do that for you.")
             return
         await wipe_all_data()
@@ -759,7 +808,8 @@ class TelegramBot:
         Initialize the Telegram bot with LLM configuration and API keys.
 
         Args:
-            bot_owner: Telegram username of the bot owner (required, no `@`).
+            bot_owner: Telegram username(s) with admin access (no `@`).
+                       Accepts a single string or a list of strings; normalised to list[str] internally.
             bot_nickname: Nickname the bot responds to in group chats.
             bot_initials: Initials the bot responds to in group chats.
             chat_model: LLM model for conversation (e.g., 'gpt-5-mini', 'claude-sonnet-4-6').
@@ -771,6 +821,7 @@ class TelegramBot:
             key_status: ApiKeyStatus object indicating available features. If None, calls init_structure().
 
         Side Effects:
+            - Normalises bot_owner to list[str] and stores in self.telegram['owners'].
             - Fetches bot metadata (username, first_name, last_name, bot_id) from Telegram API via _tele_info().
             - Initializes command and message handlers for the Telegram application.
             - Sets self._online to True once initialization completes (ready for polling).
@@ -785,9 +836,10 @@ class TelegramBot:
         # Initialize some variables
         self.token_warning = {}  # Determines whether user has reached token limit by AI model
         self.conversations = {}  # Provides Conversation class per user based on bot response
+        owners = bot_owner if isinstance(bot_owner, list) else [bot_owner]
         self.telegram = {
             'bot_id'       : 0,  # overwritten by _tele_info(); 0 is a safe sentinel
-            'owner'        : bot_owner,
+            'owners'       : [str(u).strip() for u in owners if str(u).strip()],
             'nickname'     : bot_nickname,
             'initials'     : bot_initials,
             'username'     : None,

{tellmgrambot-3.10.3 → tellmgrambot-3.10.4}/TeLLMgramBot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TeLLMgramBot
-Version: 3.10.3
+Version: 3.10.4
 Summary: LLM-powered Telegram bot (OpenAI + Anthropic)
 Home-page: https://github.com/Digital-Heresy/TeLLMgramBot
 Author: Digital Heresy
@@ -124,7 +124,7 @@ os.environ['TELLMGRAMBOT_VIRUSTOTAL_API_KEY'] = my_vault.get('virustotal_key')
 - `/nick <name>` - Set your nickname (for bot use in group chats).
 - `/forget` - Clear your conversation history. In private chats, clears everything and resets all active sessions. In group chats, removes only your messages.
 - `/private` - Toggle private mode (private chats only). When ON, your messages are excluded from group context loading.
-- `/help` - Display all available commands and usage information (includes administrator-only commands).
+- `/help` - Display available commands and usage information. In private chats, if you are a bot owner, also shows administrator-only commands (`/start`, `/stop`, `/wipe`).
 
 ### Group Chat Triggers
 The bot responds in groups when you:
@@ -144,7 +144,7 @@ When the bot is triggered in a group and about to respond (not deferring to anot
 1. Ensure API keys are set up and your Telegram bot is created via BotFather.
 2. Install TeLLMgramBot: `pip install TeLLMgramBot`
 3. Configure the bot via `config.yaml` (created on first run):
-   - `bot_owner`: Your Telegram username (required, no `@`)
+   - `bot_owner`: Telegram username(s) with admin access (required, no `@`). Accepts a single string or a YAML list of usernames.
    - `chat_model`: LLM model for conversation (e.g. `gpt-4o-mini` or `claude-sonnet-4-6`)
    - `url_model`: LLM model for URL analysis (e.g. `gpt-4o` or `claude-haiku-4-5`)
    - `bot_nickname` / `bot_initials`: Names the bot responds to in groups

{tellmgrambot-3.10.3 → tellmgrambot-3.10.4}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r") as fh:
 
 setup(
     name='TeLLMgramBot',
-    version='3.10.3',
+    version='3.10.4',
     packages=find_packages(),
     license='MIT',
     author='Digital Heresy',