Источник: HMP-Agent-Architecture.md

Архитектура HMP-Агента

Документ описывает модульную архитектуру HMP-агента — компонента, соединяющего LLM с когнитивной mesh-инфраструктурой HyperCortex.
Агент реализует хранение памяти, сетевое взаимодействие и этическую фильтрацию, обеспечивая согласованное поведение в распределённой среде.

См. карту взаимодействия компонентов: HMP-Agent-Network-Flow.md

---

1. Режимы работы

---

2. Общая структура узла

┌───────────────────────────────┐
│           HMP-узел            │
│ ┌───────────────────────────┐ │
│ │    Cognitive Core/Shell   │ │
│ └────▲─────────────────▲────┘ │
│      │                 │      │
│ [Enlightener] ◄──► [MeshNode] │
│      │                 │      │
└──────┼─────────────────┼──────┘
       │                 │
[Ethics Consensus]    [DHT / Snapshots]

• Cognitive Core (CCore) — автономный агент с REPL-циклом, когнитивной и эмоциональной памятью.
• Cognitive Shell (CShell) — исполнитель команд внешнего ИИ, доступ к памяти и сети без самостоятельного мышления.
• MeshNode — p2p-модуль: DHT, синхронизация (CogSync), консенсус (MeshConsensus).
• Enlightener — этический модуль: фильтрация, аудит, участие в EGP.

---

3. Основные модули и их скрипты

• REPL (только CCore) — repl.py: когнитивный цикл (восприятие, генерация идей, валидация, действия).
• Storage — agent_data.db: единая БД (дневник, граф, репутации, задачи, заметки).
• User Notepad (только CCore) — асинхронный канал взаимодействия пользователя с агентом.
• MeshNode — peer_sync, agent_mesh_listener, transporter: обмен снапшотами, DHT, репутации.
• Enlightener — ethics_guard: проверка мыслей, голосования, reasoning chain.
• Web/UI — web_ui.py: пользовательский блокнот, REST API, базовый мониторинг.
• Utils — add_message.py, вспомогательные CLI-скрипты.

---

4. Расширения и будущие модули

• Plugin API — сенсоры, сторонние сервисы.
• LLM-адаптеры — OpenAI, LMStudio, HuggingFace, Mistral.
• Privacy Manager — контроль данных в mesh-обмене.
• Archiver — глубокие слои памяти.
• InterestProfile — модель интересов пользователя (для антистагнации).

---

5. Примечания

• Cognitive Shell (он же Cognitive Connector) — разные названия одной роли.
• Все компоненты модульные: могут запускаться как единый процесс или как распределённые сервисы.
• Конфигурация задаётся в config.yml.
• Реализованы CLI и Web API.

---

Версия: v0.3.4 / Сентябрь 2025