NousResearch/hermes-agent · error · RuntimeError

Failed to refresh Telegram private DM topic '{named_telegram

Error message

Failed to refresh Telegram private DM topic '{named_telegram_private_topic_name}'

What it means

Error "Failed to refresh Telegram private DM topic '{named_telegram_private_topic_name}'" thrown in NousResearch/hermes-agent.

Source

Thrown at gateway/delivery.py:629

        )
        if _send_result_failed(result):
            if (
                is_named_telegram_private_topic
                and named_telegram_private_topic_name
                and _is_thread_not_found_delivery_error(result)
            ):
                ensure_dm_topic = getattr(adapter, "ensure_dm_topic", None)
                if ensure_dm_topic is None:
                    raise RuntimeError(
                        "Telegram adapter cannot refresh named private DM topics"
                    )
                refreshed_thread_id = await ensure_dm_topic(
                    target.chat_id,
                    named_telegram_private_topic_name,
                    force_create=True,
                )
                if not refreshed_thread_id:
                    raise RuntimeError(
                        f"Failed to refresh Telegram private DM topic '{named_telegram_private_topic_name}'"
                    )
                send_metadata["thread_id"] = str(refreshed_thread_id)
                send_metadata["telegram_dm_topic_created_for_send"] = True
                result = await transport.send(
                    target.platform,
                    target.chat_id,
                    content,
                    metadata=send_metadata or None,
                )
            if _send_result_failed(result):
                raise RuntimeError(_send_result_error(result) or f"{target.platform.value} delivery failed")
        return result

View on GitHub (pinned to c896c09c42)

Solutions

1. Verify the topic name and chat id are valid and the bot has rights, then retry.
2. Check gateway logs for the Telegram API error.

When it happens

Trigger: Thrown at gateway/delivery.py:629 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/77a8296e4e7ab414. Report an issue: GitHub.