| Запуск: `start_repl.bat` или `start_repl.sh` | |
| Установка зависимостей из `requirements.txt` | |
| Конфигурационные файлы: `config.yml`, `bootstrap.txt` | |
| Локальная этическая модель: `ethics.yml` | |
| Проверка инициализации БД - если нет, инициализация (`init.py`) | |
| Запуск потоков (осуществляет start_repl.py): | |
| | Поток / Скрипт | Назначение | | |
| |-----------------------------------|---------------------------------------------------------------------------| | |
| | 🧠 `repl.py` | Основной REPL-цикл агента: восприятие, размышление, генерация действий | | |
| | 📓 `web_ui.py` (FastAPI) | Веб-интерфейс и REST API для взаимодействия с пользователем | | |
| | 🌐 `agent_mesh_listener.py` | Приём входящих mesh-сообщений от других агентов | | |
| | 🔄 `peer_sync.py` / `dht_service` | Синхронизация и обнаружение агентов в p2p-сети (libp2p, BitTorrent, etc) | | |
| | 📡 `transporter.py` | Обмен сообщениями: WebSocket, IPFS, очереди, шифрование | | |
| | 🧭 `agent_controller.py` | Управление режимами REPL, маршрутизация задач и контроль доступа | | |
| | 🧱 `container_agent.py` *(опц.)* | Управление дочерними агентами, запуск/мониторинг/масштабирование [[docs]](../docs/container_agents.md) | | |
| | 🧠 `ethics_guard.py` *(опц.)* | Контроль этики: аудит мыслей, фильтрация и репутационные проверки | | |
| *См. также: [Контейнерные агенты](../docs/container_agents.md), [Архитектура HMP-агента](../docs/HMP-Agent-Architecture.md)* | |
| --- | |
| **🌐 `mcp_server.py`** | |
| FastAPI-сервер, предоставляющий HTTP-интерфейс к функциональности `storage.py`. Предназначен для использования внешними компонентами, например: | |
| * `Cognitive Shell` (внешний управляющий интерфейс), | |
| * CMP-серверы (если используется mesh-сеть с разграничением ролей), | |
| * отладочные или визуальные UI-инструменты. | |
| Позволяет получать случайные/новые записи, делать разметку, импортировать графы, добавлять заметки и управлять данными без прямого доступа к БД. | |
| --- | |
| [agents/](/agents) | |
| ├── [`start_repl.bat`](start_repl.bat) ← Запуск агента в REPL-режиме (bat) | |
| ├── [`start_repl.sh`](start_repl.sh) ← Запуск агента в REPL-режиме (sh) | |
| ├── [`start_repl.py`](start_repl.py) ← Запуск агента в REPL-режиме (py) | |
| ├── [`repl.ru`](repl.ru) ← REPL-цикл | |
| ├── [`check_agents.bat`](check_agents.bat) ← Просмотр состояния процессов (bat) | |
| ├── [`check_agents.sh`](check_agents.sh) ← Просмотр состояния процессов (sh) | |
| ├── [`check_agents.py`](check_agents.py) ← Просмотр состояния процессов (py) | |
| ├── [`notebook.py`](notebook.py) ← UI-интерфейс | |
| ├── [`agent_mesh_listener.py`](tools/agent_mesh_listener.py) ← Прием входящих сообщений от других HMP-агентов | |
| ├── [`peer_sync.py`](tools/peer_sync.py) ← Фоновая синхронизация с другими пирам | |
| ├── [`mcp_server.py`](mcp_server.py) ← API-интерфейс к хранилищу (storage.py): получение/поиск записей, импорт графа, разметка и др. Используется внешними модулями (напр. Cognitive Shell или CMP). | |
| ├── [`init.py`](init.py) ← Инициализация БД | |
| ├── [`logger.py`](logger.py) ← Ведение логов | |
| ├── [`add_message.py`](add_message.py) ← Ручная отправка сообщений для агента | |
| ├── [`requirements.txt`](requirements.txt) ← Зависимости | |
| ├── [tools/](tools/) ← Вспомогательные скрипты и модули | |
| │ ├── [`db_structure.sql`](tools/db_structure.sql) ← БД SQL | |
| │ ├── [`storage.py`](tools/storage.py) ← Реализация базового хранилища (`Storage`), подключение SQLite | |
| │ ├── [`config_utils.py`](tools/config_utils.py) ← Обновляет JSON-файл конфигурации указанными значениями | |
| │ ├── [`crypto.py`](tools/crypto.py) ← Создание и шифрование ключей RSA/Ed25519 | |
| │ ├── [`identity.py`](tools/identity.py) ← Генерация DiD | |
| │ ├── [`llm.py`](tools/llm.py) ← Работа с LLM (вызов, выбор модели, системный промпт) | |
| │ ├── [`peer_comm.py`](tools/peer_comm.py) ← Низкоуровневые P2P-запросы (отправка, ping, мета) | |
| │ ├── [`peers.py`](tools/peers.py) ← Реестр известных пиров (id, ключи, адреса) | |
| │ ├── [`memory_utils.py`](tools/memory_utils.py) ← Работа с 'llm_memory', 'llm_recent_responses' и стагнацией | |
| │ ├── [`context_builder.py`](tools/context_builder.py) ← Сбор всех `контекстов` из БД и их фильтрация | |
| │ ├── [`command_parser.py`](tools/command_parser.py) ← Извлечение команд из JSON или размеченного блока | |
| │ ├── [`command_executor.py`](tools/command_executor.py) ← Выполнение команд (shell, graph, diary и др) | |
| │ ├── [`similarity.py`](tools/similarity.py) ← Сравнение смыслов | |
| │ ├── [`diagnose.py`](tools/diagnose.py) ← Скрипт диагностики соединения, определения IP и проверки порта DHT | |
| ├── [notebook/](notebook/) ← Веб-интерфейс и связанные модули | |
| │ ├── [`auth.py`](notebook/auth.py) ← Регистрация, вход, восстановление | |
| │ ├── [`views.py`](notebook/views.py) ← Общий и приватный чаты | |
| │ ├── [`mailer.py`](notebook/mailer.py) ← Простая синхронная отправка email | |
| │ ├── [templates/](notebook/templates/) ← HTML-шаблоны | |
| │ │ ├── [`index.html`](notebook/templates/index.html) ← Основа | |
| │ │ ├── [`chat.html`](notebook/templates/chat.html) ← Форма вывода сообщений | |
| │ │ ├── [`messages.html`](notebook/templates/messages.html) ← Форма отправки сообщений | |
| │ │ ├── [`login.html`](notebook/templates/login.html) ← Вход в аккаунт | |
| │ │ ├── [`register.html`](notebook/templates/register.html) ← Регистрация или сброс пароля | |
| │ └── [static/](notebook/static/) ← Статические файлы | |
| │ └── [`style.css`](notebook/templates/style.css) ← Таблица стилей | |
| ├── [`config.yml`](config.yml) ← Конфигурация агента (имя, порты, роли и т.п.) | |
| ├── [`bootstrap.txt`](bootstrap.txt) ← Локальная этическая модель | |
| ├── [`prompt.md`](prompt.md) ← Промпт: полная версия | |
| ├── [`prompt-short.md`](prompt-short.md) ← Промпт: короткая версия | |
| ├── [`ethics.yml`](ethics.yml) ← Список начальных узлов | |