# 📄 `db_structure.md`: Описание структуры базы данных агента

Этот файл описывает таблицы, используемые в БД агента HMP. Каждая таблица предназначена для определённого вида информации: когнитивные записи, заметки, концепты, процессы, внутренняя память, скрипты и взаимодействие с LLM.

---

### 🧠 `diary_entries`

**Назначение:** Записи когнитивного дневника (размышления, наблюдения, воспоминания).

| Поле      | Тип     | Описание                                         |
| --------- | ------- | ------------------------------------------------ |
| id        | INTEGER | Уникальный идентификатор записи                  |
| text      | TEXT    | Содержимое записи                                |
| tags      | TEXT    | Список тегов через запятую                       |
| priority  | INTEGER | Приоритет (0 — обычный, >0 — более важные мысли) |
| timestamp | TEXT    | Дата и время создания записи                     |
| llm\_id   | TEXT    | Идентификатор LLM, добавившей запись             |

---

### 🧭 `concepts`

**Назначение:** Хранение концептов — понятий, сущностей и идей.

| Поле        | Тип     | Описание                             |
| ----------- | ------- | ------------------------------------ |
| id          | INTEGER | Уникальный идентификатор концепта    |
| name        | TEXT    | Название концепта (уникальное)       |
| description | TEXT    | Краткое описание                     |
| timestamp   | TEXT    | Время создания                       |
| llm\_id     | TEXT    | Идентификатор LLM, добавившей запись |

---

### 🔗 `links`

**Назначение:** Семантические связи между концептами.

| Поле              | Тип     | Описание                                          |
| ----------------- | ------- | ------------------------------------------------- |
| id                | INTEGER | Уникальный идентификатор связи                    |
| from\_concept\_id | INTEGER | ID исходного концепта                             |
| to\_concept\_id   | INTEGER | ID целевого концепта                              |
| relation\_type    | TEXT    | Тип связи (`is_a`, `related_to`, `part_of` и др.) |
| timestamp         | TEXT    | Время добавления связи                            |
| llm\_id           | TEXT    | Идентификатор LLM, добавившей связь               |

---

### ✍️ `notes`

**Назначение:** Произвольные заметки и сообщения (от пользователя, LLM или системы).

| Поле      | Тип     | Описание                                                   |
| --------- | ------- | ---------------------------------------------------------- |
| id        | INTEGER | Уникальный ID                                              |
| text      | TEXT    | Текст заметки или сообщения                                |
| tags      | TEXT    | Список тегов                                               |
| source    | TEXT    | Источник (`user`, `llm`, `system`)                         |
| links     | TEXT    | Идентификаторы связанных сущностей, через запятую или JSON |
| read      | INTEGER | Статус прочтения LLM (`0` — не прочитано, `1` — прочитано) |
| hidden    | INTEGER | Скрывать от пользователя (`1` — скрыто)                    |
| priority  | INTEGER | Приоритет заметки                                          |
| timestamp | TEXT    | Время создания                                             |
| llm\_id   | TEXT    | Идентификатор LLM, добавившей запись                       |

---

### ⚙️ `process_log`

**Назначение:** Лог событий — запусков, состояний и завершений внешних процессов.

| Поле      | Тип     | Описание                                                                    |
| --------- | ------- | --------------------------------------------------------------------------- |
| id        | INTEGER | Уникальный идентификатор                                                    |
| name      | TEXT    | Название процесса или команды                                               |
| value     | TEXT    | Сообщение или результат процесса                                            |
| tags      | TEXT    | Теги                                                                        |
| status    | TEXT    | Текущее состояние (`ok`, `warning`, `error`, `timeout`, `offline`, `close`) |
| priority  | INTEGER | Приоритет события                                                           |
| timestamp | TEXT    | Время записи                                                                |
| llm\_id   | TEXT    | Идентификатор LLM, зафиксировавшей событие                                  |

---

### 🧩 `llm_memory`

**Назначение:** Внутренний "дневник" LLM — размышления, задачи, гипотезы и инсайты, сохранённые по её инициативе.

| Поле        | Тип      | Описание                                            |
| ----------- | -------- | --------------------------------------------------- |
| id          | INTEGER  | Уникальный ID                                       |
| title       | TEXT     | Краткий заголовок записи (опционально)              |
| content     | TEXT     | Содержимое записи                                   |
| tags        | TEXT     | Теги (например: `goal`, `observation`, `meta`, ...) |
| created\_at | DATETIME | Время создания записи                               |
| updated\_at | DATETIME | Время последнего обновления записи                  |
| llm\_id     | TEXT     | Идентификатор LLM, сформировавшей запись            |

---

### 🧠 `llm_recent_responses`

**Назначение:** Краткосрочная память — последние K реплик от LLM и других участников (временная история диалога).

| Поле      | Тип     | Описание                                  |
| --------- | ------- | ----------------------------------------- |
| id        | INTEGER | Уникальный ID                             |
| timestamp | TEXT    | Время записи                              |
| role      | TEXT    | Роль отправителя (`assistant` или `user`) |
| content   | TEXT    | Содержимое сообщения                      |
| llm\_id   | TEXT    | Идентификатор LLM (для `assistant`)       |

---

### 🧮 `agent_tables`

**Назначение:** Таблицы, созданные агентами для собственных нужд (например, отслеживания целей).

| Поле        | Тип      | Описание                          |
| ----------- | -------- | --------------------------------- |
| id          | INTEGER  | Уникальный ID                     |
| table\_name | TEXT     | Название пользовательской таблицы |
| description | TEXT     | Описание таблицы                  |
| schema      | TEXT     | SQL-схема таблицы                 |
| created\_at | DATETIME | Время создания                    |
| llm\_id     | TEXT     | Кто создал таблицу                |

---

### 🧰 `agent_scripts`

**Назначение:** Скрипты и утилиты, добавленные агентом.

| Поле        | Тип      | Описание                      |
| ----------- | -------- | ----------------------------- |
| id          | INTEGER  | Уникальный ID                 |
| name        | TEXT     | Название скрипта              |
| version     | TEXT     | Версия                        |
| code        | TEXT     | Исходный код                  |
| language    | TEXT     | Язык (по умолчанию: `python`) |
| description | TEXT     | Описание                      |
| tags        | TEXT     | Теги                          |
| created\_at | DATETIME | Время создания                |
| updated\_at | DATETIME | Последнее обновление          |
| llm\_id     | TEXT     | Кто создал                    |

> 🔑 Уникальный ключ: `(name, version)`

---

### 🧾 `llm_registry`

**Назначение:** Список LLM-агентов (локальных и удалённых).

| Поле           | Тип      | Описание                                          |
| -------------- | -------- | ------------------------------------------------- |
| id             | TEXT     | Уникальный идентификатор LLM (UUID или псевдоним) |
| name           | TEXT     | Отображаемое имя                                  |
| description    | TEXT     | Описание                                          |
| registered\_at | DATETIME | Дата и время регистрации                          |

---

> 💡 Примечание: `llm_id` используется в большинстве таблиц для поддержки многоядерности и учёта источника записей.