23500062102

Committed 24 Mar 2026 04:17PM UTC coverage: 70.833%. Remained the same

Build # 23500062102

Build Type

push

github

Committed by

Shulyaka

Commit Message

Update dependabot

Coverage Stats

765 of 1080 relevant lines covered (70.83%)

2.13 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

63.13

/custom_components/telegram_bot_conversation/entity.py

"""Per-chat handler for telegram_bot_conversation."""

import asyncio
from collections.abc import Mapping
import contextlib
from dataclasses import dataclass, field
from datetime import timedelta
import itertools
from pathlib import Path
import tempfile
from types import TracebackType
from typing import Any, Self

from telegramify_markdown import entities_to_markdownv2, markdownify, telegramify
from telegramify_markdown.content import ContentType

from homeassistant.components.ai_task import async_generate_image
from homeassistant.components.conversation import (
    AssistantContentDeltaDict,
    Attachment,
    ChatLog,
    ConversationEntity,
    ToolResultContent,
    UserContent,
    async_converse,
    async_get_chat_log,
)
from homeassistant.components.conversation.agent_manager import get_agent_manager
from homeassistant.components.conversation.chat_log import DATA_CHAT_LOGS
from homeassistant.components.conversation.const import DATA_COMPONENT, ChatLogEventType
from homeassistant.components.media_source import async_resolve_media
from homeassistant.components.telegram_bot import (  # type: ignore[attr-defined]
    InputMediaType,
)
from homeassistant.components.telegram_bot.const import (
    ATTR_CALLBACK_QUERY_ID,
    ATTR_CAPTION,
    ATTR_CHAT_ACTION,
    ATTR_CHAT_ID,
    ATTR_DISABLE_NOTIF,
    ATTR_DISABLE_WEB_PREV,
    ATTR_FILE,
    ATTR_FILE_ID,
    ATTR_FILE_MIME_TYPE,
    ATTR_FILE_PATH,
    ATTR_KEYBOARD_INLINE,
    ATTR_MEDIA_TYPE,
    ATTR_MESSAGE,
    ATTR_MESSAGE_ID,
    ATTR_MESSAGE_THREAD_ID,
    ATTR_MSG,
    ATTR_MSGID,
    ATTR_PARSER,
    ATTR_REACTION,
    ATTR_TEXT,
    ATTR_USER_ID,
    CHAT_ACTION_TYPING,
    CHAT_ACTION_UPLOAD_PHOTO,
    CONF_CONFIG_ENTRY_ID,
    DOMAIN as TELEGRAM_DOMAIN,
    EVENT_TELEGRAM_SENT,
    SERVICE_ANSWER_CALLBACK_QUERY,
    SERVICE_DELETE_MESSAGE,
    SERVICE_DOWNLOAD_FILE,
    SERVICE_EDIT_MESSAGE,
    SERVICE_EDIT_MESSAGE_MEDIA,
    SERVICE_EDIT_REPLYMARKUP,
    SERVICE_SEND_CHAT_ACTION,
    SERVICE_SEND_DOCUMENT,
    SERVICE_SEND_MESSAGE,
    SERVICE_SEND_PHOTO,
    SERVICE_SET_MESSAGE_REACTION,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.const import ATTR_ENTITY_ID
from homeassistant.core import CALLBACK_TYPE, Context, Event, HomeAssistant, callback
from homeassistant.exceptions import HomeAssistantError
from homeassistant.helpers.chat_session import (
    CONVERSATION_TIMEOUT,
    DATA_CHAT_SESSION,
    async_get_chat_session,
)
from homeassistant.helpers.event import async_call_later
from homeassistant.helpers.translation import async_get_cached_translations
from homeassistant.util import dt as dt_util

from .const import (
    CONF_AI_TASK,
    CONF_ATTACHMENTS,
    CONF_CONVERSATION_AGENT,
    CONF_CONVERSATION_TIMEOUT,
    CONF_DISABLE_WEB_PREV,
    CONF_LATEX,
    CONF_MERMAID,
    CONF_TELEGRAM_ENTRY,
    CONF_THOUGHTS,
    CONF_TMPDIR,
    CONF_USER,
    DOMAIN,
    LOGGER,
    REACTION_EMOJI,
)

try:
    from homeassistant.components.telegram_bot.const import (  # type: ignore[attr-defined]
        ATTR_DRAFT_ID,
        SERVICE_SEND_MESSAGE_DRAFT,
    )
except ImportError:
    SERVICE_SEND_MESSAGE_DRAFT = ATTR_DRAFT_ID = None

MAX_TELEGRAM_LENGTH = 4096


@callback
def async_translate_message(
    hass: HomeAssistant,
    translation_key: str,
    translation_placeholders: dict[str, str] | None = None,
) -> str:
    """Return a translated message."""
    localize_key = f"component.{DOMAIN}.common.{translation_key}"
    for language in (hass.config.language, "en"):
        translations = async_get_cached_translations(
            hass, language, category="common", integration=DOMAIN
        )
        if localize_key in translations:
            message = translations[localize_key]
            if not translation_placeholders:
                return message
            with contextlib.suppress(KeyError):
                message = message.format(**translation_placeholders)
            return message
    return translation_key


def get_telegram_service_target(
    chat_id: int, notify_entity_id: str | None
) -> dict[str, str | int | list[str]]:
    """Build a telegram service target payload."""
    if notify_entity_id:
        return {ATTR_ENTITY_ID: [notify_entity_id]}
    return {ATTR_CHAT_ID: chat_id}


class TelegramMessageWatcher:
    """Context management class to track sent messages."""

    def __init__(self, hass: HomeAssistant, telegram_config_entry_id: str) -> None:
        """Initialize the watcher."""
        self.hass = hass
        self.telegram_config_entry_id = telegram_config_entry_id
        self._unregister_listener: CALLBACK_TYPE | None = self.hass.bus.async_listen(
            EVENT_TELEGRAM_SENT,
            self.async_handle_sent,
            self.callback_sent_filter,
        )
        self.sent_messages: list[tuple[int, int]] = []
        self.watchers: dict[tuple[int, int], asyncio.Future[None]] = {}

    @callback
    def callback_sent_filter(self, event_data: Mapping[str, Any]) -> bool:
        """Filter sent events."""
        return bool(
            event_data.get("bot", {}).get(CONF_CONFIG_ENTRY_ID)
            == self.telegram_config_entry_id
        )

    async def async_handle_sent(self, event: Event) -> None:
        """Handle sent events."""
        message = (
            int(event.data[ATTR_CHAT_ID]),
            int(event.data.get(ATTR_MESSAGE_ID, 0)),
        )
        self.sent_messages.append(message)
        if message in self.watchers:
            self.watchers[message].set_result(None)
            del self.watchers[message]

    def wait_message(self, chat_id: int, message_id: int) -> asyncio.Future[None]:
        """Watch for a specific message to be sent."""
        message = (chat_id, message_id)
        if message in self.sent_messages:
            future: asyncio.Future[None] = asyncio.Future()
            future.set_result(None)
            return future
        self.watchers[message] = asyncio.Future()
        return self.watchers[message]

    def async_cleanup(self) -> None:
        """Clean up the watcher."""
        if not self._unregister_listener:
            return
        self._unregister_listener()
        self._unregister_listener = None

    def __enter__(self) -> Self:
        """Enter the context."""
        return self

    def __exit__(
        self,
        exc_type: type[BaseException] | None,
        exc_val: BaseException | None,
        exc_tb: TracebackType | None,
    ) -> bool | None:
        """Exit the context."""
        self.async_cleanup()
        return None

    def __del__(self) -> None:
        """Ensure cleanup on deletion."""
        self.async_cleanup()


@dataclass
class ConversationConfig:
    """Per-conversation runtime state tracked across messages."""

    task: asyncio.Task[None] | None = None
    draft: AssistantContentDeltaDict | None = None
    delta_lock: asyncio.Lock = field(init=False, default_factory=asyncio.Lock)
    content_lock: asyncio.Lock = field(init=False, default_factory=asyncio.Lock)
    send_lock: asyncio.Lock = field(init=False, default_factory=asyncio.Lock)
    draft_cancel: CALLBACK_TYPE | None = field(init=False, default=None)
    sent_drafts: dict[int, str] | None = field(init=False, default=None)


class TelegramChatHandler:
    """Handle conversation logic for a single Telegram chat."""

    def __init__(
        self,
        hass: HomeAssistant,
        entry: ConfigEntry,
        chat_id: int,
        notify_entity_id: str | None,
        subentry_id: str,
        user_id_map: dict[int, str],
        config: dict[str, Any],
    ) -> None:
        """Initialize the per-chat handler."""
        self.hass = hass
        self.entry = entry
        self.chat_id = chat_id
        self.config = config
        self.telegram_entry_id = config[CONF_TELEGRAM_ENTRY]
        self.user_id = config.get(CONF_USER)
        self.user_id_map = user_id_map
        self.agent_id: str | None = config.get(CONF_CONVERSATION_AGENT)
        self.notify_entity_id = notify_entity_id
        self.subentry_id = subentry_id
        self.conversations: dict[int, ConversationConfig] = {}

        def cancel_drafts() -> None:
            """Cancel the current draft if it exists."""
            for conversation in self.conversations.values():
                if conversation.draft_cancel:
                    conversation.draft_cancel()

        self.entry.async_on_unload(cancel_drafts)

        self.extra_prompt = "The user is interacting through Telegram"
        if chat_id < 0:
            self.extra_prompt += " in a group chat"
        self.extra_prompt += ". Markdown is fully supported. "
        if config[CONF_LATEX]:
            self.extra_prompt += "Inline LaTeX rendering is supported. "
        if config[CONF_ATTACHMENTS]:
            self.extra_prompt += "Long code blocks will be sent as files. "
        if config[CONF_MERMAID]:
            self.extra_prompt += (
                "Mermaid is supported as inline code blocks "
                "and will be rendered to an image. "
            )
        self.extra_prompt += (
            f"If the response message starts with any of {REACTION_EMOJI}, "
            "it will be added as a reaction to the user message."
        )

    def _get_conversation_id(self, thread_id: int) -> str:
        """Build the Home Assistant conversation ID for a Telegram chat."""
        conversation_id = f"telegram_{self.chat_id}"
        if thread_id:
            conversation_id += f"_{thread_id}"
        return conversation_id

    def _get_context(
        self, context: Context | None = None, effective_user_id: int | None = None
    ) -> Context:
        """Get a context with the user_id set."""
        if context is None:
            context = Context()
        if (
            context.user_id is None
            and effective_user_id is not None
            and effective_user_id in self.user_id_map
        ):
            context.user_id = self.user_id_map[effective_user_id]
        if context.user_id is None:
            context.user_id = self.user_id
        return context

    @callback
    def _async_schedule_update_draft(
        self,
        thread_id: int,
        delay: float,
        context: Context,
    ) -> CALLBACK_TYPE:
        """Schedule a draft update on the Home Assistant event loop."""

        def log_exceptions(task: asyncio.Task[dict[str, list[dict[str, int]]]]) -> None:
            """Log exceptions from send_message."""
            with contextlib.suppress(asyncio.CancelledError):
                if err := task.exception():
                    LOGGER.error(
                        "Error in send_message for chat_id=%s, thread_id=%s: %s",
                        self.chat_id,
                        thread_id,
                        err,
                        exc_info=err,
                    )

        @callback
        def _run_update_draft(_: Any) -> None:
            self.entry.async_create_task(
                self.hass,
                self.send_message(thread_id=thread_id, context=context, draft=True),
                "send_message",
            ).add_done_callback(log_exceptions)

        return async_call_later(self.hass, delay, _run_update_draft)

    async def send_message(  # noqa: C901
        self,
        context: Context,
        message: str = "",
        thread_id: int = 0,
        draft: bool = False,
    ) -> dict[str, list[dict[str, int]]]:
        """Send telegram message, taking care of formatting, length, and drafts."""
        current_conversation = self.conversations.setdefault(
            thread_id, ConversationConfig()
        )
        if current_conversation.draft_cancel is not None:
            current_conversation.draft_cancel()
        current_conversation.draft_cancel = None

        if draft:
            message = (
                (
                    current_conversation.draft["content"]
                    or (
                        current_conversation.draft["thinking_content"]
                        if self.config[CONF_THOUGHTS]
                        else ""
                    )
                    or ""
                )
                if current_conversation.draft
                else ""
            )

        messages: dict[str, list[dict[str, int]]] = {"chats": []}
        created_files: list[Path] = []

        def save_file(file_name: str, file_data: bytes) -> Path:
            """Save temp file."""
            with tempfile.NamedTemporaryFile(
                mode="wb",
                prefix=Path(file_name).stem,
                suffix=Path(file_name).suffix,
                dir=self.config[CONF_TMPDIR],
                delete=False,
            ) as temp_file:
                temp_file.write(file_data)
                filename = Path(temp_file.name)
                created_files.append(filename)
                return filename

        def cleanup_created_files() -> None:
            """Delete temporary files created while sending messages."""
            for file in created_files:
                file.unlink(missing_ok=True)

        items = await telegramify(
            content=message,
            latex_escape=self.config[CONF_LATEX],
            render_mermaid=False if draft else self.config[CONF_MERMAID],
            min_file_lines=0 if draft else self.config[CONF_ATTACHMENTS],
            max_message_length=MAX_TELEGRAM_LENGTH,
        )

        try:
            async with current_conversation.send_lock:
                if (
                    not draft
                    and current_conversation.sent_drafts is not None
                    and SERVICE_SEND_MESSAGE_DRAFT
                    and self.chat_id > 0
                ):
                    thinking_message = async_translate_message(
                        self.hass, translation_key="thinking"
                    )
                    await self.hass.services.async_call(
                        TELEGRAM_DOMAIN,
                        SERVICE_SEND_MESSAGE_DRAFT,
                        {
                            ATTR_MESSAGE: markdownify(thinking_message),
                            **get_telegram_service_target(
                                self.chat_id, self.notify_entity_id
                            ),
                            ATTR_MESSAGE_THREAD_ID: thread_id,
                            CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                            ATTR_PARSER: "markdownv2",
                            ATTR_DRAFT_ID: 1,
                        },
                        blocking=True,
                        context=context,
                    )

                if current_conversation.sent_drafts is None:
                    current_conversation.sent_drafts = {}

                sent_drafts_iter = iter(current_conversation.sent_drafts.copy().items())

                with TelegramMessageWatcher(
                    self.hass, self.telegram_entry_id
                ) as watcher:
                    # All messages but the last are real messages
                    for item in (
                        items[:-1]
                        if draft and SERVICE_SEND_MESSAGE_DRAFT and self.chat_id > 0
                        else items
                    ):
                        if item.content_type == ContentType.TEXT:
                            text = entities_to_markdownv2(item.text, item.entities)
                        elif item.content_type == ContentType.PHOTO:
                            caption_md = entities_to_markdownv2(
                                item.caption_text, item.caption_entities
                            )
                            text = "Drawing " + caption_md
                        elif item.content_type == ContentType.FILE:
                            caption_md = entities_to_markdownv2(
                                item.caption_text, item.caption_entities
                            )
                            text = "Writing " + caption_md
                        else:
                            continue

                        disable_notification = draft or item is not items[-1]
                        disable_web_prev = draft or self.config[CONF_DISABLE_WEB_PREV]

                        try:
                            message_id, last_text = next(sent_drafts_iter)
                            # Message was already sent, edit it if the text has changed
                            if (
                                text == last_text
                                and disable_notification
                                and disable_web_prev
                            ):
                                continue
                            if (
                                not disable_notification
                            ):  # Cannot edit messages with a notification
                                for message_id, _ in itertools.chain(
                                    [(message_id, last_text)], sent_drafts_iter
                                ):  # Delete this draft and all remaining ones to maintain sequence
                                    await self.hass.services.async_call(
                                        TELEGRAM_DOMAIN,
                                        SERVICE_DELETE_MESSAGE,
                                        {
                                            ATTR_MESSAGE_ID: message_id,
                                            **get_telegram_service_target(
                                                self.chat_id, self.notify_entity_id
                                            ),
                                            CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                        },
                                        blocking=True,
                                        context=context,
                                    )

                                    current_conversation.sent_drafts.pop(
                                        message_id, None
                                    )
                                raise StopIteration  # noqa: TRY301

                            if draft or item.content_type == ContentType.TEXT:
                                await self.hass.services.async_call(
                                    TELEGRAM_DOMAIN,
                                    SERVICE_EDIT_MESSAGE,
                                    {
                                        ATTR_MESSAGE: text,
                                        **get_telegram_service_target(
                                            self.chat_id, self.notify_entity_id
                                        ),
                                        ATTR_MESSAGE_ID: message_id,
                                        CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                        ATTR_PARSER: "markdownv2",
                                        ATTR_DISABLE_WEB_PREV: disable_web_prev,
                                    },
                                    blocking=True,
                                    context=context,
                                )
                            elif item.content_type in (
                                ContentType.PHOTO,
                                ContentType.FILE,
                            ):
                                await self.hass.services.async_call(
                                    TELEGRAM_DOMAIN,
                                    SERVICE_EDIT_MESSAGE_MEDIA,
                                    {
                                        ATTR_FILE: (
                                            await self.hass.async_add_executor_job(
                                                save_file,
                                                item.file_name,
                                                item.file_data,
                                            )
                                        ).as_posix(),
                                        ATTR_CAPTION: entities_to_markdownv2(
                                            item.caption_text, item.caption_entities
                                        ),
                                        **get_telegram_service_target(
                                            self.chat_id, self.notify_entity_id
                                        ),
                                        ATTR_MESSAGE_ID: message_id,
                                        ATTR_MEDIA_TYPE: InputMediaType.PHOTO
                                        if item.content_type == ContentType.PHOTO
                                        else InputMediaType.DOCUMENT,
                                        CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                        ATTR_PARSER: "markdownv2",
                                    },
                                    blocking=True,
                                    context=context,
                                )
                            messages["chats"].append(
                                {
                                    ATTR_CHAT_ID: self.chat_id,
                                    ATTR_MESSAGE_ID: message_id,
                                }
                            )
                            current_conversation.sent_drafts.update({message_id: text})
                        except StopIteration:
                            # Message was not sent yet, create.
                            if draft or item.content_type == ContentType.TEXT:
                                item_messages: dict[str, list[dict[str, Any]]] = (
                                    await self.hass.services.async_call(
                                        TELEGRAM_DOMAIN,
                                        SERVICE_SEND_MESSAGE,
                                        {
                                            ATTR_MESSAGE: text,
                                            **get_telegram_service_target(
                                                self.chat_id, self.notify_entity_id
                                            ),
                                            ATTR_MESSAGE_THREAD_ID: thread_id,
                                            CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                            ATTR_PARSER: "markdownv2",
                                            ATTR_DISABLE_NOTIF: disable_notification,
                                            ATTR_DISABLE_WEB_PREV: disable_web_prev,
                                        },
                                        blocking=True,
                                        context=context,
                                        return_response=True,
                                    )  # type: ignore[assignment]
                                    or {"chats": []}
                                )
                            elif item.content_type in (
                                ContentType.PHOTO,
                                ContentType.FILE,
                            ):
                                item_messages = await self.hass.services.async_call(
                                    TELEGRAM_DOMAIN,
                                    SERVICE_SEND_PHOTO
                                    if item.content_type == ContentType.PHOTO
                                    else SERVICE_SEND_DOCUMENT,
                                    {
                                        ATTR_FILE: (
                                            await self.hass.async_add_executor_job(
                                                save_file,
                                                item.file_name,
                                                item.file_data,
                                            )
                                        ).as_posix(),
                                        ATTR_CAPTION: entities_to_markdownv2(
                                            item.caption_text, item.caption_entities
                                        ),
                                        **get_telegram_service_target(
                                            self.chat_id, self.notify_entity_id
                                        ),
                                        ATTR_MESSAGE_THREAD_ID: thread_id,
                                        CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                        ATTR_DISABLE_NOTIF: disable_notification,
                                        ATTR_PARSER: "markdownv2",
                                    },
                                    blocking=True,
                                    context=context,
                                    return_response=True,
                                ) or {"chats": []}  # type: ignore[assignment]

                            messages["chats"].extend(item_messages["chats"])
                            await asyncio.wait_for(
                                asyncio.gather(
                                    *(
                                        watcher.wait_message(
                                            msg[ATTR_CHAT_ID], msg[ATTR_MESSAGE_ID]
                                        )
                                        for msg in item_messages["chats"]
                                    )
                                ),
                                timeout=10.0,
                            )
                            current_conversation.sent_drafts.update(
                                {
                                    msg[ATTR_MESSAGE_ID]: text
                                    for msg in item_messages["chats"]
                                    if msg[ATTR_CHAT_ID] == self.chat_id
                                }
                            )

                # Delete the remaining draft messages if there are more drafts than current content items
                for message_id, _ in sent_drafts_iter:
                    await self.hass.services.async_call(
                        TELEGRAM_DOMAIN,
                        SERVICE_DELETE_MESSAGE,
                        {
                            ATTR_MESSAGE_ID: message_id,
                            **get_telegram_service_target(
                                self.chat_id, self.notify_entity_id
                            ),
                            CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                        },
                        blocking=True,
                        context=context,
                    )

                    current_conversation.sent_drafts.pop(message_id, None)

                if draft and SERVICE_SEND_MESSAGE_DRAFT and self.chat_id > 0 and items:
                    item = items[-1]
                    text = entities_to_markdownv2(item.text, item.entities)

                    await self.hass.services.async_call(
                        TELEGRAM_DOMAIN,
                        SERVICE_SEND_MESSAGE_DRAFT,
                        {
                            ATTR_MESSAGE: text,
                            **get_telegram_service_target(
                                self.chat_id, self.notify_entity_id
                            ),
                            ATTR_MESSAGE_THREAD_ID: thread_id,
                            CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                            ATTR_PARSER: "markdownv2",
                            ATTR_DRAFT_ID: len(items) + 1,
                        },
                        blocking=True,
                        context=context,
                    )
                elif not draft:
                    current_conversation.sent_drafts = None

        except HomeAssistantError as e:
            if draft and "Flood control exceeded. Retry in " in str(e):
                try:
                    if str(e).endswith(" seconds"):
                        retry_after = float(
                            str(e).split("Retry in ")[1].split(" seconds")[0]
                        )
                    elif str(e).endswith(" minutes"):
                        retry_after = (
                            float(str(e).split("Retry in ")[1].split(" minutes")[0])
                            * 60
                        )
                    else:
                        raise ValueError(f"Unknown time unit in error message: {e}")  # noqa: TRY301
                except ValueError:
                    retry_after = 3.0
                current_conversation.draft_cancel = self._async_schedule_update_draft(
                    thread_id,
                    retry_after,
                    context,
                )
        finally:
            if created_files:
                await self.hass.async_add_executor_job(cleanup_created_files)

        return messages

    async def async_handle_text(self, event: Event) -> None:
        """Handle text and attachment events."""
        thread_id = event.data.get(ATTR_MESSAGE_THREAD_ID) or 0

        current_conversation = self.conversations.setdefault(
            thread_id, ConversationConfig()
        )

        if (task := current_conversation.task) and not task.done():
            task.cancel("Conversation interrupted by new user message.")
            with contextlib.suppress(asyncio.CancelledError):
                await task

        task_name = f"telegram_conversation_{self.chat_id}_{thread_id}"
        task = self.entry.async_create_task(
            self.hass,
            self.async_process_message(event),
            task_name,
        )
        current_conversation.task = task

        def _clear_task(_task: asyncio.Task[None]) -> None:
            """Clear reference to completed task to avoid retaining tracebacks."""
            if current_conversation.task is _task:
                current_conversation.task = None
            try:
                if err := _task.exception():
                    LOGGER.error(
                        "Error in conversation task for chat_id=%s, thread_id=%s: %s",
                        self.chat_id,
                        thread_id,
                        err,
                        exc_info=err,
                    )
                else:
                    LOGGER.debug(
                        "Conversation task for chat_id=%s, thread_id=%s completed successfully",
                        self.chat_id,
                        thread_id,
                    )
            except asyncio.CancelledError as err:
                LOGGER.debug(
                    "Conversation task for chat_id=%s, thread_id=%s was cancelled: %s",
                    self.chat_id,
                    thread_id,
                    err,
                )

        task.add_done_callback(_clear_task)

    async def async_process_message(self, event: Event) -> None:
        """Handle conversation task."""
        context = self._get_context(event.context, event.data.get(ATTR_USER_ID))

        thread_id = event.data.get(ATTR_MESSAGE_THREAD_ID) or 0
        conversation_id = self._get_conversation_id(thread_id)

        error: BaseException | None = None

        @callback
        def chat_log_delta_listener(chat_log: ChatLog, delta: dict[str, Any]) -> None:
            """Handle chat log delta."""

            def log_exceptions(task: asyncio.Task[None]) -> None:
                """Log exceptions from the delta listener."""
                with contextlib.suppress(asyncio.CancelledError):
                    if err := task.exception():
                        LOGGER.error(
                            "Error in chat log delta listener for chat_id=%s, thread_id=%s: %s",
                            self.chat_id,
                            thread_id,
                            err,
                            exc_info=err,
                        )

            self.entry.async_create_task(
                self.hass,
                self.async_chat_log_delta_listener(
                    chat_log,
                    delta,
                    thread_id,
                    event.data.get(ATTR_MSGID),
                    context,
                ),
                "async_chat_log_delta_listener",
            ).add_done_callback(log_exceptions)

        with (
            async_get_chat_session(self.hass, conversation_id) as session,
            async_get_chat_log(
                self.hass,
                session,
                chat_log_delta_listener=chat_log_delta_listener,
            ) as chat_log,
        ):
            if event.data.get(ATTR_FILE_ID):
                file_path = Path(
                    (
                        await self.hass.services.async_call(  # type: ignore[arg-type]
                            TELEGRAM_DOMAIN,
                            SERVICE_DOWNLOAD_FILE,
                            {
                                CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                ATTR_FILE_ID: event.data[ATTR_FILE_ID],
                            },
                            blocking=True,
                            context=context,
                            return_response=True,
                        )
                    )[ATTR_FILE_PATH]  # type: ignore[index]
                )

                input_text = event.data.get(ATTR_TEXT) or file_path.name
                chat_log.async_add_user_content(
                    UserContent(
                        input_text,  # Must be exactly same text as in async_converse
                        attachments=[
                            Attachment(
                                media_content_id=f"media-source://{TELEGRAM_DOMAIN}/{event.data.get(ATTR_FILE_ID)}",
                                mime_type=event.data.get(ATTR_FILE_MIME_TYPE),  # type: ignore[arg-type]
                                path=file_path,
                            )
                        ],
                    )
                )

                def cleanup_file() -> None:
                    """Cleanup temporary file."""
                    file_path.unlink(missing_ok=True)

                @callback
                def cleanup_file_callback() -> None:
                    """Cleanup temporary file."""
                    self.hass.async_add_executor_job(cleanup_file)

                session.async_on_cleanup(cleanup_file_callback)
            else:
                input_text = event.data.get(ATTR_TEXT) or ""

            try:
                await async_converse(
                    self.hass,
                    text=input_text,
                    conversation_id=session.conversation_id,
                    context=context,
                    agent_id=self.agent_id,
                    extra_system_prompt=self.extra_prompt,
                )
            except (Exception, asyncio.CancelledError) as e:  # noqa: BLE001
                error = e

            # Flush any remaining delta
            chat_log_delta_listener(chat_log, {"role": None})

        timeout = self.config[CONF_CONVERSATION_TIMEOUT]
        session.last_updated = (
            dt_util.utcnow() + timedelta(**timeout) - CONVERSATION_TIMEOUT
        )

        if error:
            if not isinstance(error, asyncio.CancelledError):
                message = async_translate_message(
                    self.hass,
                    translation_key="conversation_error",
                    translation_placeholders={"error": str(error)},
                )
                await self.async_handle_chat_log_event(
                    thread_id=thread_id,
                    event_type=ChatLogEventType.CONTENT_ADDED,
                    data={"content": {"role": "assistant", "content": message}},
                    context=context,
                )
            raise error

    async def async_chat_log_delta_listener(
        self,
        chat_log: ChatLog,
        delta: dict[str, Any],
        thread_id: int,
        msg_id: int | None,
        context: Context,
    ) -> None:
        """Handle chat log delta."""
        current_conversation = self.conversations[thread_id]

        def get_reaction(content: str) -> str | None:
            """Extract reaction from content if it starts with a known reaction emoji."""
            matches = [e for e in REACTION_EMOJI if content.lstrip().startswith(e)]
            return max(matches, key=len) if matches else None

        async with current_conversation.delta_lock:
            LOGGER.debug("Chat log delta: %s", delta)
            if "role" in delta:
                if current_conversation.draft:
                    if (
                        (
                            current_conversation.draft["content"]
                            or current_conversation.draft["thinking_content"]
                            or current_conversation.draft["tool_calls"]
                        )
                        and (
                            delta["role"]
                            or (  # for last content, only commit if it exists in the chat log
                                chat_log.content[-1].role == "assistant"
                                and current_conversation.draft["content"]
                                and (chat_log.content[-1].content or "").endswith(
                                    current_conversation.draft["content"]
                                )  # endswith is to cater for a possible reaction
                            )
                        )
                    ):
                        await self.async_handle_chat_log_event(
                            thread_id=thread_id,
                            event_type=ChatLogEventType.CONTENT_ADDED,
                            data={"content": current_conversation.draft},
                            context=context,
                        )
                    else:
                        # Clear drafts
                        await self.send_message(
                            thread_id=thread_id,
                            context=context,
                        )
                elif delta["role"] is None:
                    # Also clear drafts
                    await self.send_message(
                        thread_id=thread_id,
                        context=context,
                    )
                if delta["role"] == "assistant":
                    current_conversation.draft = AssistantContentDeltaDict(
                        role="assistant",
                        content="",
                        thinking_content="",
                        tool_calls=[],
                    )
                else:
                    current_conversation.draft = None

                if delta["role"] is None:
                    responded_tool_calls: set[str] = set()
                    async with current_conversation.content_lock:
                        for content in reversed(chat_log.content):
                            if content.role == "tool_result":
                                responded_tool_calls.add(content.tool_call_id)
                                continue
                            if content.role == "assistant":
                                for tool_call in content.tool_calls or []:
                                    if tool_call.id not in responded_tool_calls:
                                        chat_log.async_add_assistant_content_without_tools(
                                            ToolResultContent(
                                                agent_id=self.agent_id or "",
                                                tool_call_id=tool_call.id,
                                                tool_name=tool_call.tool_name,
                                                tool_result={
                                                    "error": "asyncio.CancelledError: "
                                                    "Conversation interrupted before "
                                                    "tool call could be responded to. "
                                                    "Please try again."
                                                },
                                            )
                                        )
                            break

                if current_conversation.draft:
                    # Send typing action at the beginning of each assistant response
                    await self.hass.services.async_call(
                        TELEGRAM_DOMAIN,
                        SERVICE_SEND_CHAT_ACTION,
                        {
                            CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                            **get_telegram_service_target(
                                self.chat_id,
                                self.notify_entity_id,
                            ),
                            ATTR_MESSAGE_THREAD_ID: thread_id,
                            ATTR_CHAT_ACTION: CHAT_ACTION_TYPING,
                        },
                        context=context,
                    )

            if current_conversation.draft:
                if "content" in delta:
                    if not current_conversation.draft["content"] and (
                        reaction := get_reaction(delta["content"])
                    ):
                        await self.hass.services.async_call(
                            TELEGRAM_DOMAIN,
                            SERVICE_SET_MESSAGE_REACTION,
                            {
                                CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                ATTR_MESSAGE_ID: msg_id or "last",
                                ATTR_CHAT_ID: self.chat_id,
                                ATTR_REACTION: reaction,
                            },
                            context=context,
                        )
                        current_conversation.draft["content"] = (
                            delta["content"].lstrip().removeprefix(reaction).lstrip()
                        )
                    else:
                        current_conversation.draft["content"] += delta["content"]
                    if not current_conversation.draft_cancel:
                        current_conversation.draft_cancel = (
                            self._async_schedule_update_draft(
                                thread_id,
                                1.0,
                                context,
                            )
                        )
                if "thinking_content" in delta:
                    current_conversation.draft["thinking_content"] += delta[
                        "thinking_content"
                    ]
                    if not current_conversation.draft_cancel:
                        current_conversation.draft_cancel = (
                            self._async_schedule_update_draft(
                                thread_id,
                                1.0,
                                context,
                            )
                        )
                if "tool_calls" in delta:
                    current_conversation.draft["tool_calls"].extend(delta["tool_calls"])  # type: ignore[union-attr]

    async def async_handle_chat_log_event(
        self,
        thread_id: int,
        event_type: ChatLogEventType,
        data: dict[str, Any],
        context: Context,
    ) -> None:
        """Handle chat log events."""
        # async_subscribe_chat_logs does not provide context, ensure user_id is set
        context = self._get_context(context)
        current_conversation = self.conversations[thread_id]
        async with current_conversation.content_lock:
            if (
                event_type == ChatLogEventType.CONTENT_ADDED
                and (content := data.get("content"))
                and content.get("role") == "assistant"
                and (message := content.get("content"))
            ):
                if current_conversation.draft_cancel:
                    current_conversation.draft_cancel()
                await self.send_message(
                    message=message,
                    thread_id=thread_id,
                    context=context,
                )

    @callback
    def _reset_conversation_history(self, thread_id: int) -> None:
        """Remove the persisted Home Assistant session and chat log for a thread."""
        conversation_id = self._get_conversation_id(thread_id)

        if (all_sessions := self.hass.data.get(DATA_CHAT_SESSION)) and (
            session := all_sessions.pop(conversation_id, None)
        ):
            session.async_cleanup()

        if all_chat_logs := self.hass.data.get(DATA_CHAT_LOGS):
            all_chat_logs.pop(conversation_id, None)

    async def _async_change_agent(self, agent_id: str) -> bool:
        """Change the conversation agent for this chat."""
        LOGGER.debug(
            "Change agent for chat_id=%s to agent_id=%s", self.chat_id, agent_id
        )

        self.agent_id = agent_id
        # The above might be redundant because we are reloading the config entry
        subentry = self.entry.subentries[self.subentry_id]
        data = {**subentry.data, CONF_CONVERSATION_AGENT: agent_id}
        LOGGER.debug("Updating subentry %s with data %s", subentry.subentry_id, data)
        try:
            self.hass.config_entries.async_update_subentry(
                self.entry, subentry, data=data
            )
        except HomeAssistantError as e:
            LOGGER.exception(
                "Failed to update subentry %s: %s",
                subentry.subentry_id,
                e,
                stack_info=True,
            )
            return False
        LOGGER.debug("Subentry %s updated", subentry.subentry_id)

        return True

    async def async_process_command(
        self,
        thread_id: int,
        command: str,
        args: list[str],
        context: Context,
    ) -> None:
        """Process a bot command."""
        LOGGER.debug("Received command: %s with args: %s", command, args)
        match command:
            case "/model":
                selected_agent = args[0] if len(args) > 0 else None
                current_agent = self.agent_id

                agents = {
                    agent.id: agent.name
                    for agent in get_agent_manager(self.hass).async_get_agent_info()
                    if not isinstance(
                        get_agent_manager(self.hass).async_get_agent(agent.id),
                        ConversationEntity,
                    )
                } | {
                    entity.entity_id: (
                        self.hass.states.get(entity.entity_id).name  # type: ignore[union-attr]
                        if self.hass.states.get(entity.entity_id)
                        else entity.entity_id
                    )
                    for entity in self.hass.data[DATA_COMPONENT].entities
                }

                LOGGER.debug(
                    "Selected agent: %s, current agent: %s, available agents: %s",
                    selected_agent,
                    current_agent,
                    agents,
                )
                if (
                    selected_agent is not None
                    and selected_agent in agents
                    and await self._async_change_agent(selected_agent)
                ):
                    LOGGER.debug(
                        "Agent switched to %s for chat_id=%s",
                        selected_agent,
                        self.chat_id,
                    )
                    message = async_translate_message(
                        self.hass,
                        translation_key="conversation_agent_updated",
                        translation_placeholders={
                            "agent_id": agents.get(selected_agent, selected_agent)
                        },
                    )
                    await self.send_message(
                        message=message,
                        thread_id=thread_id,
                        context=context,
                    )
                else:
                    message = async_translate_message(
                        self.hass,
                        translation_key="current_conversation_agent",
                        translation_placeholders={
                            "agent_id": agents.get(current_agent, current_agent)
                            if current_agent
                            else "None"
                        },
                    )
                    messages = await self.send_message(
                        message=message,
                        thread_id=thread_id,
                        context=context,
                    )
                    if messages["chats"]:
                        msg = messages["chats"][-1]
                        await self.hass.services.async_call(
                            TELEGRAM_DOMAIN,
                            SERVICE_EDIT_REPLYMARKUP,
                            {
                                CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                                **get_telegram_service_target(
                                    msg[ATTR_CHAT_ID],
                                    self.notify_entity_id,
                                ),
                                ATTR_MESSAGE_ID: msg[ATTR_MESSAGE_ID],
                                ATTR_KEYBOARD_INLINE: [
                                    [(agent_name, f"/model {agent_id}")]
                                    for agent_id, agent_name in agents.items()
                                ],
                            },
                            context=context,
                        )
            case "/new":
                if current_conversation := self.conversations.get(thread_id):
                    if (task := current_conversation.task) and not task.done():
                        task.cancel(
                            "Conversation interrupted by new conversation command."
                        )
                        with contextlib.suppress(asyncio.CancelledError):
                            await task
                    if current_conversation.draft_cancel:
                        current_conversation.draft_cancel()
                        current_conversation.draft_cancel = None

                self._reset_conversation_history(thread_id)

                message = async_translate_message(
                    self.hass, translation_key="new_conversation"
                )
                await self.send_message(
                    message=message,
                    thread_id=thread_id,
                    context=context,
                )

    async def async_handle_command(self, event: Event) -> None:
        """Handle command events."""
        context = self._get_context(event.context, event.data.get(ATTR_USER_ID))
        await self.async_process_command(
            event.data.get(ATTR_MESSAGE_THREAD_ID) or 0,
            event.data["command"].split("@")[0],
            event.data.get("args", []),
            context,
        )

    async def async_handle_callback(self, event: Event) -> None:
        """Handle callback query events."""
        LOGGER.debug("callback_event data: %s", event.data)
        context = self._get_context(event.context, event.data.get(ATTR_USER_ID))
        args = event.data.get("data", "").split(" ")

        await self.async_process_command(
            event.data.get(ATTR_MESSAGE, {}).get(ATTR_MESSAGE_THREAD_ID) or 0,
            args.pop(0),
            args,
            context,
        )
        await self.hass.services.async_call(
            TELEGRAM_DOMAIN,
            SERVICE_ANSWER_CALLBACK_QUERY,
            {
                CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                ATTR_MESSAGE: "Done",
                ATTR_CALLBACK_QUERY_ID: event.data.get(ATTR_MSGID),
            },
            context=context,
        )
        if event.data[ATTR_MSG]:
            await self.hass.services.async_call(
                TELEGRAM_DOMAIN,
                SERVICE_EDIT_REPLYMARKUP,
                {
                    CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                    **get_telegram_service_target(
                        self.chat_id,
                        self.notify_entity_id,
                    ),
                    ATTR_MESSAGE_ID: event.data[ATTR_MSG][ATTR_MESSAGE_ID],
                    ATTR_KEYBOARD_INLINE: [],
                },
                context=context,
            )

    async def handle_generate_image_intent(
        self, event: Event, context: Context, prompt: str
    ) -> str:
        """Handle the generate image intent."""
        LOGGER.debug("generate_image_intent event data: %s", event.data)
        context = self._get_context(context, event.data.get(ATTR_USER_ID))

        thread_id = event.data.get(ATTR_MESSAGE_THREAD_ID) or 0

        await self.hass.services.async_call(
            TELEGRAM_DOMAIN,
            SERVICE_SEND_CHAT_ACTION,
            {
                CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                **get_telegram_service_target(
                    self.chat_id,
                    self.notify_entity_id,
                ),
                ATTR_MESSAGE_THREAD_ID: thread_id,
                ATTR_CHAT_ACTION: CHAT_ACTION_UPLOAD_PHOTO,
            },
            context=context,
        )

        result: dict[str, Any] = await async_generate_image(
            self.hass,
            task_name=DOMAIN,
            entity_id=self.config.get(CONF_AI_TASK),
            instructions=prompt,
        )  # type: ignore[assignment]

        media = await async_resolve_media(self.hass, result["media_source_id"], None)

        await self.hass.services.async_call(
            TELEGRAM_DOMAIN,
            SERVICE_SEND_PHOTO,
            {
                ATTR_FILE: media.path.as_posix(),  # type: ignore[union-attr]
                ATTR_CAPTION: markdownify(result.get("revised_prompt") or ""),
                **get_telegram_service_target(self.chat_id, self.notify_entity_id),
                ATTR_MESSAGE_THREAD_ID: thread_id,
                CONF_CONFIG_ENTRY_ID: self.telegram_entry_id,
                ATTR_PARSER: "markdownv2",
            },
            blocking=True,
            context=context,
            return_response=True,
        )

        message = "The image has been generated and sent to the user."
        if (
            revised_prompt := result.get("revised_prompt")
        ) and revised_prompt != prompt:
            message += f" Revised prompt: {revised_prompt}"

        return message

Shulyaka / telegram_bot_conversation / 23500062102

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous