Sync from GitHub with Git LFS

agents/tools/db_structure.sql

@@ -65,6 +65,8 @@ CREATE TABLE IF NOT EXISTS tasks (
     status TEXT DEFAULT 'open',                                 -- open / in_progress / done / frozen
     pinned INTEGER DEFAULT 0,                                   -- 0 = обычная, 1 = закреплённая
     timestamp TEXT DEFAULT CURRENT_TIMESTAMP,                   -- Когда задача создана
+    repl_mode TEXT DEFAULT 'none',                              -- none | read_only | full
+    repl_status TEXT DEFAULT 'stopped',                         -- running | stopped | error
     llm_id TEXT,                                                -- Кто предложил задачу
     FOREIGN KEY(goal_id) REFERENCES goals(id)
 );
@@ -124,7 +126,8 @@ CREATE TABLE IF NOT EXISTS notes (
     hashtags TEXT DEFAULT '[]',                                 -- JSON-массив пользовательских хештегов
     user_did TEXT DEFAULT 'ALL',                                -- Идентификатор пользователя (или 'ALL')
     agent_did TEXT,                                             -- Идентификатор агента (он же идентификатор чата)
-    source TEXT DEFAULT 'user',                                 -- Источник: user | cli | llm | system
+    source TEXT DEFAULT 'user',                                 -- Источник: user | cli | llm | llm:task | system
+    task_id INTEGER,                                            -- NULL = не относится к задаче, иначе привязка к tasks.id
     links TEXT DEFAULT '',                                      -- Ссылки на другие объекты (например, JSON со связями)
     read INTEGER DEFAULT 0,                                     -- Агент прочитал: 0 = нет, 1 = да
     hidden INTEGER DEFAULT 0,                                   -- Скрыто от UI (например, технические записи)
@@ -181,6 +184,7 @@ CREATE TABLE IF NOT EXISTS llm_recent_responses (
     role TEXT CHECK(role IN ('user', 'assistant')) NOT NULL,
     content TEXT NOT NULL,                      -- Содержимое сообщения
     llm_id TEXT,                                -- Идентификатор LLM
+    task_id INTEGER REFERENCES tasks(id),       -- К какой задаче относится
     reflection TEXT,                            -- Краткая сводка/мета-комментарий
     novelty_score REAL,                         -- Количественная оценка новизны
     new_ideas JSON,                             -- JSON-список новых идей

docs/HMP-agent-REPL-cycle.md

@@ -97,7 +97,9 @@ REPL-цикл является основой HMP-агента [Cognitive Core](
 * для управления списком известных HMP-агентов `agent_peers`
 * для выбора *текущего основного LLM* из `llm_registry` или изменение параметров управления LLM
 * для управления дополнительными утилитами и базами данных `agent_scripts` и `agent_tables`, управлением дополнительных способов выхода из стогнаций `stagnation_strategies` и методов мышления `thinking_methods` (а также таблицей рейтингов `ratings`), а также списком внешних сервисов `external_services` и `external_accounts`
-* для постановки задачи (выполняется асинхронно) другой LLM
+* для постановки задачи другой LLM:
+  * режим "вопрос-ответ" — разовый асинхронный запрос
+  * режим "read-only REPL" — запуск вспомогательного REPL-цикла для задачи
 * для *взаимодействия с Mesh*
 * для управления *внешними процессами* из `process_log` (запустить процесс, остановить процесс, пометить запрос как обработанный)
 * инициализация *очистки* `process_log`, `llm_recent_responses` и  `notes` от устаревших записей
@@ -582,6 +584,34 @@ REPL-цикл является основой HMP-агента [Cognitive Core](
 
 ---
 
+## 🔄 Вспомогательные REPL-циклы
+
+Помимо основного REPL-цикла агент может запускать вспомогательные циклы для отдельных задач.  
+Это позволяет изолировать рассуждения по задаче, но при этом сохранять связь с основным агентом.
+
+Особенности:
+
+* **Изоляция контекста**
+  * вспомогательный цикл видит в `llm_recent_responses` только свои собственные сообщения;
+  * задача, для которой он запущен, формируется на основе записи в `tasks` и подаётся как промпт при старте.
+
+* **Доступ к данным**
+  * полный доступ к таблицам агента только для чтения;
+  * запись собственных рассуждений — только через `notes` (в свободной форме, помеченные `source = 'llm:task'` и `task_id`).
+
+* **Взаимодействие с основным циклом**
+  * основное ядро получает сообщения вспомогательного цикла через `notes` и может реагировать (например, проверять корректность, сохранять выводы в `diary_entries`, вносить изменения в `concepts` и т.п.);
+  * вспомогательный цикл не выполняет команд напрямую — только генерирует текстовые предложения.
+
+* **Жизненный цикл**
+  * запускается по команде основного REPL-цикла;
+  * может быть остановлен вручную или автоматически после завершения задачи;
+  * все его действия логируются в `process_log` с привязкой к `task_id`.
+
+Таким образом, вспомогательные REPL-циклы действуют как «виртуальные подагенты» в режиме read-only, не меняя состояние БД напрямую, а передавая свои гипотезы и результаты через основной REPL-цикл.
+
+---
+
 ## 🌐 Внешние инструменты и интеграции
 
 HMP-агент может быть расширен за счёт взаимодействия с внешними программами, протоколами и сервисами. Этот раздел описывает направления возможных интеграций, которые позволяют агенту наблюдать, реагировать, управлять и развивать взаимодействие с внешним миром.