# Структура (STRUCTURE.md)

- `core/`: 
  - `protocol.py` — Унифицированные структуры данных (сообщения, файлы, UI).
- `adapter/matrix/`:
  - `bot.py` — Главный event-loop Matrix.
  - `converter.py` — Конвертация событий Matrix-nio ⇄ `core/protocol.py`.
  - `agent_registry.py` — Парсинг `matrix-agents.yaml`.
  - `files.py` — Работа с вложениями и shared volume.
  - `store.py` — SQLite база для маппинга чатов Matrix и `platform_chat_id`.
  - `routed_platform.py` — Динамический роутинг вызовов к нужным агентам на лету.
- `sdk/`:
  - `interface.py` — Интерфейс PlatformClient.
  - `real.py` — Имплементация WebSocket клиента (`AgentApi`).
  - `mock.py` — Мок-клиент для E2E тестов без платформы.
- `config/`: Конфиги маршрутизации (YAML).
- `docs/`: Актуальная документация по развертыванию и архитектуре.
- `docker-compose*.yml`: Продакшн и локальные манифесты для сборки.