Files
hermes-agent/tests/gateway/test_send_voice_reply_notify.py
T
kshitijk4poor ab2f4602de refactor: MessageEvent to gateway/platforms/event.py; ElicitationHandler takes a call_context thunk
Breaks the two import cycles that forced Protocol stand-ins in the F821 sweep, so the two
sites now name the real types.

gateway/platforms/event.py (new leaf): MessageType, ProcessingOutcome, MessageEvent moved
out of base.py verbatim. Their only dependency is gateway.session.SessionSource; base.py
imported helpers.py at module level, so helpers could not name MessageEvent. Now
TextBatchAggregator is typed by the real MessageEvent. 249 importers repointed
(`from gateway.platforms.base import` -> `.event`, preserving each import's layout);
gateway.platforms.__init__ re-exports from .event. The three revert-scheduled PLUGIN-COMPAT
pointers that named these symbols (gateway.slash_commands → MessageType, dingtalk → MessageType,
photon → ProcessingOutcome) and their COMPAT_MANIFEST rows now target gateway.platforms.event.
Docs updated: ADDING_A_PLATFORM.md, adding-platform-adapters.md (en + zh-Hans).

tools/mcp_tool_sampling.py: ElicitationHandler no longer holds a back-reference to its
MCPServerTask (mcp_tool imports sampling, so the task type cannot be named there). It only
ever read owner._pending_call_context, so it takes `call_context: Callable[[], Context | None]`
and MCPServerTask passes `lambda: self._pending_call_context`. The consent call is one
`functools.partial`, run directly or inside the captured Context.

ty on the 11 touched production files vs origin/main: 0 new diagnostics, 14 resolved.
(The one `source: SessionSource = None` diagnostic moves with the class; typing it Optional
exposes ~60 unguarded call sites — separate follow-up.)

Tests: tests/gateway + tests/plugins + tests/tools + touched files, 18,235 passed; the 31
failures reproduce identically on origin/main (macOS /private/tmp, systemd socket,
long-path fixtures, live-service tests).
2026-09-07 22:47:33 +05:30

99 lines
3.3 KiB
Python

"""Regression test for issue #27970 Bug 2.
The auto Telegram voice reply (``GatewayRunner._send_voice_reply``) is the
final response of a turn. It must mark its metadata as ``notify=True`` so
adapters that gate push notifications (Telegram's "important" mode) deliver
it as a normal push instead of a silent message — mirroring the existing
final-text path in ``gateway/platforms/base.py``.
"""
import json
import os
import tempfile
from types import SimpleNamespace
from unittest.mock import AsyncMock
import pytest
from gateway.config import Platform
from gateway.platforms.event import MessageEvent, MessageType
from gateway.run import GatewayRunner
from gateway.session import SessionSource
def _make_event(thread_id=None):
source = SessionSource(
platform=Platform.TELEGRAM,
chat_id="208214988",
user_id="208214988",
chat_type="dm",
thread_id=thread_id,
)
return MessageEvent(
text="hi",
message_type=MessageType.TEXT,
source=source,
message_id="m1",
)
def _runner_with_adapter(send_voice_mock):
runner = object.__new__(GatewayRunner)
adapter = SimpleNamespace(
send_voice=send_voice_mock,
is_in_voice_channel=lambda *_a, **_k: False,
)
runner.adapters = {Platform.TELEGRAM: adapter}
return runner
def _fake_tts_call(monkeypatch, audio_bytes=b"\x00" * 32):
"""Patch the TTS tool so it writes a real file at the requested path."""
def _fake_text_to_speech_tool(*, text, output_path, **_kwargs):
os.makedirs(os.path.dirname(output_path), exist_ok=True)
with open(output_path, "wb") as fh:
fh.write(audio_bytes)
return json.dumps({"success": True, "file_path": output_path})
monkeypatch.setattr(
"tools.tts_tool.text_to_speech_tool",
_fake_text_to_speech_tool,
)
monkeypatch.setattr(
"tools.tts_text_normalize._strip_markdown_for_tts",
lambda text: text,
)
@pytest.mark.asyncio
async def test_voice_reply_marks_existing_thread_metadata_without_mutation(monkeypatch, tmp_path):
"""When thread metadata exists (Telegram DM-topic), notify=True is added without mutating the source dict."""
monkeypatch.setattr(tempfile, "gettempdir", lambda: str(tmp_path))
_fake_tts_call(monkeypatch)
send_voice = AsyncMock()
runner = _runner_with_adapter(send_voice)
# Use a DM topic source so _thread_metadata_for_source returns a non-None dict.
event = _make_event(thread_id="17585")
source_meta_snapshot = runner._thread_metadata_for_source(
event.source, runner._reply_anchor_for_event(event)
)
assert source_meta_snapshot is not None
snapshot_copy = dict(source_meta_snapshot)
await runner._send_voice_reply(event, "Hello there.")
send_voice.assert_awaited_once()
kwargs = send_voice.await_args.kwargs
assert kwargs["metadata"].get("notify") is True
# All pre-existing thread keys are preserved.
for k, v in snapshot_copy.items():
assert kwargs["metadata"].get(k) == v
# The freshly-computed source-side metadata must NOT have been mutated
# (would otherwise leak notify=True into the typing-indicator state).
fresh = runner._thread_metadata_for_source(
event.source, runner._reply_anchor_for_event(event)
)
assert "notify" not in fresh