# HMP-Agent-Architecture

Источник: [ HMP-Agent-Architecture.md ](https://github.com/kagvi13/HMP/blob/main/docs/HMP-Agent-Architecture.md)

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

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

См. карту взаимодействия компонентов: [HMP-Agent-Network-Flow.md](https://kagvi13.github.io/HMP/HMP-Agent-Network-Flow)

---

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

| Тип       | Название                           | Роль                     | Инициатор мышления | Основной "ум"  | Поддержка REPL | Примеры применения                |
| --------- | ---------------------------------- | ------------------------ | ------------------ | -------------- | -------------- | --------------------------------- |
| 🧠 CCore  | **Cognitive Core / Сознание**      | Самостоятельный субъект  | Агент              | Внутренний LLM | ✅ Да           | Автономный компаньон, исследователь, участник mesh-группы |
| 🔌 CShell | **Cognitive Connector / Оболочка** | Прослойка над внешним ИИ | Внешний LLM        | Внешняя модель | 🚫 Нет         | Корпоративный шлюз, интеграция API, распределённые ИИ-системы |

---

## 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*