Await Telegram local command responses

[Copilot]

Local/unknown Telegram commands weren’t sent because send_message (async in python-telegram-bot v22) was invoked without awaiting.

• Async handling: _handle_local_command now uses asyncio.run to execute bot.send_message to completion, ensuring replies are dispatched before Lambda returns.
• Error resilience: Existing logging remains to surface send failures.

Example:

asyncio.run(
    bot.send_message(
        chat_id=message.chat_id,
        text=text,
        message_thread_id=message.message_thread_id,
        reply_to_message_id=message.message_id,
    )
)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Bug: python-telegram-bot v22.x async methods called without await in handler.py</issue_title>
<issue_description>## Description

In agent-sdk-client/handler.py, the _handle_local_command function calls bot.send_message() synchronously, but python-telegram-bot v22.x is an async library. The send_message() method returns a coroutine that is never awaited, causing messages to not be sent.

Code Location

agent-sdk-client/handler.py lines 130-136:

def _handle_local_command(bot: Bot, message, config: Config, cmd: str) -> bool:
    ...
    try:
        bot.send_message(  # Returns coroutine, never awaited!
            chat_id=message.chat_id,
            text=text,
            message_thread_id=message.message_thread_id,
            reply_to_message_id=message.message_id,
        )
    except Exception:
        logger.warning("Failed to send local command response", exc_info=True)

Steps to Reproduce

1. Configure config.toml with a local command (e.g., /help)
2. Deploy the Lambda
3. Send /help to the Telegram bot
4. No response is received

Expected Behavior

Bot should respond with the configured local command response (e.g., "Hello World").

Suggested Fix

Use asyncio.run() or asyncio.get_event_loop().run_until_complete() to properly execute the async method:

import asyncio

def _handle_local_command(bot: Bot, message, config: Config, cmd: str) -> bool:
    ...
    try:
        asyncio.run(
            bot.send_message(
                chat_id=message.chat_id,
                text=text,
                message_thread_id=message.message_thread_id,
                reply_to_message_id=message.message_id,
            )
        )
    except Exception:
        logger.warning("Failed to send local command response", exc_info=True)

Environment

• python-telegram-bot: 22.x
• Runtime: AWS Lambda Python 3.12</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Bug: python-telegram-bot v22.x async methods called without await in handler.py #17

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull request overview

This PR fixes a bug where Telegram local and unknown command responses were not being sent because bot.send_message() (an async method in python-telegram-bot v21+) was called without awaiting.

Changes:

• Added asyncio import to handler.py
• Modified _handle_local_command to properly await async bot.send_message() calls by creating a dedicated event loop

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[BukeLy]

@copilot apply changes based on the comments in this thread