feat(04-01): finalize AgentApi migration

tests/adapter/matrix/test_dispatcher.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import importlib
 from types import SimpleNamespace
 from unittest.mock import AsyncMock
 
@@ -10,6 +11,7 @@ from adapter.matrix.bot import MatrixBot, build_runtime, prepare_live_sync
 from adapter.matrix.handlers.auth import handle_invite
 from adapter.matrix.store import get_room_meta, get_user_meta, set_user_meta
 from core.protocol import IncomingCallback, IncomingCommand, OutgoingMessage
+from sdk.interface import PlatformError
 from sdk.mock import MockPlatformClient
 from sdk.real import RealPlatformClient
 
@@ -199,6 +201,31 @@ async def test_bot_ignores_its_own_messages():
     bot._send_all.assert_not_awaited()
 
 
+async def test_bot_degrades_platform_errors_to_user_reply():
+    runtime = build_runtime(platform=MockPlatformClient())
+    client = SimpleNamespace(
+        user_id="@bot:example.org",
+        room_send=AsyncMock(),
+    )
+    bot = MatrixBot(client, runtime)
+    runtime.dispatcher.dispatch = AsyncMock(
+        side_effect=PlatformError("Missing Authentication header", code="401")
+    )
+    room = SimpleNamespace(room_id="!dm:example.org")
+    event = SimpleNamespace(sender="@alice:example.org", body="hello")
+
+    await bot.on_room_message(room, event)
+
+    client.room_send.assert_awaited_once_with(
+        "!dm:example.org",
+        "m.room.message",
+        {
+            "msgtype": "m.text",
+            "body": "Сервис временно недоступен. Попробуйте ещё раз позже.",
+        },
+    )
+
+
 async def test_mat11_settings_returns_dashboard():
     runtime = build_runtime(platform=MockPlatformClient())
     current_chat_id = "C9"
@@ -260,9 +287,18 @@ async def test_prepare_live_sync_returns_next_batch_from_bootstrap_sync():
 
 
 async def test_build_runtime_uses_real_platform_when_matrix_backend_is_real(monkeypatch):
+    bot_module = importlib.import_module("adapter.matrix.bot")
+
+    class FakeAgentApiWrapper:
+        def __init__(self, agent_id: str, url: str) -> None:
+            self.agent_id = agent_id
+            self.url = url
+
+    monkeypatch.setattr(bot_module, "AgentApiWrapper", FakeAgentApiWrapper)
     monkeypatch.setenv("MATRIX_PLATFORM_BACKEND", "real")
     monkeypatch.setenv("AGENT_WS_URL", "ws://agent.example/agent_ws/")
 
     runtime = build_runtime()
 
     assert isinstance(runtime.platform, RealPlatformClient)
+    assert runtime.platform.agent_api.url == "ws://agent.example/agent_ws/"