15.08.2026 13:20 добился очистки эфемерных сообщений с помощью анализа ведения диалога с помощью ИИ и по нажатию кнопки "Завершить"

docs/development_roadmap.md

@@ -39,3 +39,12 @@ main (100% стабильный релиз)
   * Фиксация промежуточных комментариев и статусов выполнения по каждому пункту.
   * Синхронизация задач плана с SQLite-таблицей `tasks`.
   * Экспорт планов в Markdown/Excel и отображение на дашборде.
+
+
+### 3. Изолированная среда выполнения и песочница кода (Code Execution Sandbox Engine)
+* **Концепция:** Безопасный изолированный Docker-контейнер (или gVisor / Pyodide / nsjail окружение) для динамического выполнения кода, генерируемого моделью в процессе рассуждений и анализа данных.
+* **Ключевые возможности:**
+  * Запуск сложных вычислений, агрегаций и статистического анализа данных СКУД на лету (Pandas / NumPy).
+  * Выполнение тестовых сценариев и валидация скриптов перед их сохранением/применением на проде.
+  * Полная изоляция от хост-системы: read-only доступ к копиям данных, ограничение памяти/CPU (cgroups), отсутствие доступа к чувствительным сетевым интерфейсам.
+  * Возврат результатов вычислений (stdout, stderr, артефакты, сгенерированные таблицы/графики) обратно в контекст модели.

modules/web_api/llm/agent.py

@@ -6,7 +6,7 @@ MODULE: web_api / llm (Core Agent & Function Calling Dispatcher)
 ROLE: Главный оркестратор взаимодействия с Ollama LLM (Qwen 2.5), разбор вызовов 
       инструментов (Function Calling), интеграция с декларативным реестром 
       действий SQLite (tool_action_registry), детерминированный Fast-Path
-      для подтверждений, динамические кнопки и автоочистка эфемерных сообщений.
+      для подтверждений, отслеживание Topic Drift и Context Guard с кнопками.
 ===============================================================================
 """
 
@@ -20,7 +20,8 @@ import logging
 import re
 from typing import List, Dict, Any, Tuple, Optional
 
-# Импорт фасада базы данных
+# Импорт фасада базы данных и прямого подключения
+from .db.connection import get_db_connection
 from .db_tools import (
     db_get_active_system_prompt,
     db_add_system_prompt,
@@ -32,9 +33,10 @@ from .db_tools import (
     db_get_rules,
     db_set_session_state,
     db_get_session_state,
+    db_clear_session_state,
+    db_increment_session_idle,
     db_get_snapshots,
     db_delete_snapshots,
-    db_clear_session_state,
     db_get_current_server_time,
     db_save_chat_message,
     db_get_chat_history,
@@ -78,9 +80,10 @@ def process_chat_message(
     Главный конвейер обработки входящего сообщения:
     1. Fast-Path перехват подтверждений/отмен при активном session_state.
     2. Перехват завершения работы ('нет, закончить настройку') с автоочисткой эфемерных сообщений.
-    3. Формирование системного контекста и вызов Ollama.
+    3. Формирование системного контекста с учетом активного действия (черновика).
     4. Выполнение вызванного Tool и опрос Data-Driven реестра действий.
-    5. Возврат кортежа: (reply_text, chat_history, action_metadata).
+    5. Проверка счетчика отвлечений (idle_turns), Context Guard на 3-м шаге и автоочистка при N > 3.
+    6. Возврат кортежа: (reply_text, chat_history, action_metadata).
     """
     logger.info(f"Получено сообщение от user_id={user_id}, session_id={session_id}: {user_message}")
     
@@ -96,7 +99,7 @@ def process_chat_message(
     if user_msg_clean in ["нет, спасибо", "нет, закончить настройку", "закончить настройку", "завершить", "нет"]:
         db_clear_session_state(session_id)
         deleted_count = db_purge_ephemeral_messages(session_id)
-        logger.info(f"🧹 Завершена работа с инструментом. Удалено эфемерных сообщений: {deleted_count}")
+        logger.info(f"Завершена работа с инструментом. Удалено эфемерных сообщений: {deleted_count}")
         
         reply_text = "Хорошо. Настройка завершена, контекст диалога чист. Чем я могу помочь дальше?"
         db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=0)
@@ -104,32 +107,46 @@ def process_chat_message(
 
     # --- [FAST-PATH 2: ПЕРЕХВАТ ПОДТВЕРЖДЕНИЯ / ОТМЕНЫ ПРЕВЬЮ ПРОМПТА] ---
     if session_state and session_state.get("state_type") == "PROMPT_PREVIEW":
+        draft_text = ""
+        if session_state.get("data_json") and isinstance(session_state["data_json"], dict):
+            draft_text = session_state["data_json"].get("draft_text", "")
+        else:
+            draft_text = session_state.get("pending_data", "")
+
         if user_msg_clean in ["подтверждаю", "подтвердить", "да", "сохранить", "применить", "ок", "хорошо"]:
-            db_add_system_prompt("main_agent", session_state.get("pending_data", ""))
-            db_clear_session_state(session_id)
+            db_add_system_prompt("main_agent", draft_text)
+            
+            # Переводим сессию в режим follow-up диалога
+            db_set_session_state(session_id, "PROMPT_FOLLOWUP", {"idle_turns": 0})
             
             action_cfg = db_get_tool_action("db_confirm_prompt_preview")
-            reply_text = action_cfg["success_template"] if action_cfg else "✅ Системный промпт успешно сохранен и применен в базе данных."
+            reply_text = action_cfg["success_template"] if action_cfg else "Системный промпт успешно сохранен и применен в базе данных."
             if action_cfg and action_cfg.get("follow_up_question"):
                 reply_text += f"\n\n{action_cfg['follow_up_question']}"
             
+            reply_text = reply_text.replace("✅", "").replace("❌", "").replace("**", "").replace("*", "").strip()
+
+            is_eph = action_cfg.get("is_ephemeral", 1) if action_cfg else 1
             db_save_chat_message(session_id, "user", full_user_content, is_ephemeral=1)
-            db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=1)
+            db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=is_eph)
             return reply_text, db_get_chat_history(session_id), {
                 "type": action_cfg.get("action_type") if action_cfg else "FOLLOW_UP_ACTION",
                 "buttons": action_cfg.get("buttons", []) if action_cfg else []
             }
 
         elif user_msg_clean in ["отмена", "отменить", "отклонить", "назад", "стоп"]:
-            db_clear_session_state(session_id)
+            db_set_session_state(session_id, "PROMPT_FOLLOWUP", {"idle_turns": 0})
             
             action_cfg = db_get_tool_action("db_cancel_prompt_preview")
-            reply_text = action_cfg["success_template"] if action_cfg else "❌ Изменения системного промпта отменены."
+            reply_text = action_cfg["success_template"] if action_cfg else "Изменения системного промпта отменены."
             if action_cfg and action_cfg.get("follow_up_question"):
                 reply_text += f"\n\n{action_cfg['follow_up_question']}"
             
+            reply_text = reply_text.replace("✅", "").replace("❌", "").replace("**", "").replace("*", "").strip()
+
+            is_eph = action_cfg.get("is_ephemeral", 1) if action_cfg else 1
             db_save_chat_message(session_id, "user", full_user_content, is_ephemeral=1)
-            db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=1)
+            db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=is_eph)
             return reply_text, db_get_chat_history(session_id), {
                 "type": action_cfg.get("action_type") if action_cfg else "FOLLOW_UP_ACTION",
                 "buttons": action_cfg.get("buttons", []) if action_cfg else []
@@ -146,12 +163,23 @@ def process_chat_message(
     calendar_context = get_dynamic_calendar_context()
     user_info = f"Пользователь ID={user_id}" if user_id != 0 else "Гость"
 
+    # Информируем модель о наличии незавершенного действия в сессии
+    active_state_context = ""
+    if session_state and session_state.get("state_type") in ["PROMPT_PREVIEW", "PROMPT_FOLLOWUP"]:
+        active_state_context = (
+            "\n[АКТИВНОЕ ДЕЙСТВИЕ В СЕССИИ]\n"
+            "В данный момент оператор находится в процессе настройки системного промпта.\n"
+            "- Если оператор просит продолжить правки или уточняет детали — продолжай работу с ним.\n"
+            "- Если оператор переключился на другую тему или вызвал другой инструмент — выполни его команду штатно.\n"
+        )
+
     system_prompt_content = (
         f"Ты — интеллектуальный ассистент SCUD Orion AI. "
         f"Ты управляешь задачами, аналитикой СКУД и системными настройками с помощью инструментов (tools).\n\n"
         f"[ОКРУЖЕНИЕ]\n"
         f"- Пользователь: {user_info}\n"
-        f"- {calendar_context}\n\n"
+        f"- {calendar_context}\n"
+        f"{active_state_context}\n"
         f"[ПРАВИЛА ИСПОЛЬЗОВАНИЯ ИНСТРУМЕНТОВ]\n"
         f"1. Для любых изменений системного промпта (добавить, удалить, изменить пункт) ВСЕГДА вызывай функцию db_preview_prompt_merge(prompt_text=...).\n"
         f"2. Для просмотра системного промпта ВСЕГДА вызывай db_get_system_prompt().\n"
@@ -213,21 +241,28 @@ def process_chat_message(
                 for tool in tool_calls:
                     fn_name = tool["function"]["name"]
                     fn_args = tool["function"].get("arguments", {})
-                    logger.info(f"🚀 Вызов функции (Tool): {fn_name} с аргументами: {fn_args}")
+                    logger.info(f"Вызов функции (Tool): {fn_name} с аргументами: {fn_args}")
                     tool_result_content = ""
 
                     action_cfg = db_get_tool_action(fn_name)
                     
                     if fn_name == "db_confirm_prompt_preview":
                         if session_state and session_state.get("state_type") == "PROMPT_PREVIEW":
-                            db_add_system_prompt("main_agent", session_state.get("pending_data", ""))
-                            db_clear_session_state(session_id)
+                            draft_text = ""
+                            if session_state.get("data_json") and isinstance(session_state["data_json"], dict):
+                                draft_text = session_state["data_json"].get("draft_text", "")
+                            else:
+                                draft_text = session_state.get("pending_data", "")
+
+                            db_add_system_prompt("main_agent", draft_text)
+                            db_set_session_state(session_id, "PROMPT_FOLLOWUP", {"idle_turns": 0})
                             
                             if action_cfg and action_cfg.get("bypass_llm"):
                                 reply_text = action_cfg["success_template"]
                                 if action_cfg.get("follow_up_question"):
                                     reply_text += f"\n\n{action_cfg['follow_up_question']}"
                                 
+                                reply_text = reply_text.replace("✅", "").replace("❌", "").replace("**", "").replace("*", "").strip()
                                 is_eph = action_cfg.get("is_ephemeral", 1)
                                 db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=is_eph)
                                 return reply_text, db_get_chat_history(session_id), {
@@ -236,17 +271,18 @@ def process_chat_message(
                                 }
                             tool_result_content = json.dumps({"status": "success"}, ensure_ascii=False)
                         else:
-                            err_reply = "⚠️ Нет активного превью для подтверждения."
+                            err_reply = "Нет активного превью для подтверждения."
                             db_save_chat_message(session_id, "assistant", err_reply, is_ephemeral=1)
                             return err_reply, db_get_chat_history(session_id), None
 
                     elif fn_name == "db_cancel_prompt_preview":
-                        db_clear_session_state(session_id)
+                        db_set_session_state(session_id, "PROMPT_FOLLOWUP", {"idle_turns": 0})
                         if action_cfg and action_cfg.get("bypass_llm"):
                             reply_text = action_cfg["success_template"]
                             if action_cfg.get("follow_up_question"):
                                 reply_text += f"\n\n{action_cfg['follow_up_question']}"
                             
+                            reply_text = reply_text.replace("✅", "").replace("❌", "").replace("**", "").replace("*", "").strip()
                             is_eph = action_cfg.get("is_ephemeral", 1)
                             db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=is_eph)
                             return reply_text, db_get_chat_history(session_id), {
@@ -283,6 +319,7 @@ def process_chat_message(
                             reply_text = action_cfg["success_template"]
                             if action_cfg.get("follow_up_question"):
                                 reply_text += f"\n\n{action_cfg['follow_up_question']}"
+                            reply_text = reply_text.replace("✅", "").replace("❌", "").replace("**", "").replace("*", "").strip()
                             is_eph = action_cfg.get("is_ephemeral", 1)
                             db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=is_eph)
                             return reply_text, db_get_chat_history(session_id), {
@@ -303,7 +340,7 @@ def process_chat_message(
                         current_prompt = db_get_active_system_prompt()
                         user_msg_lower = user_message.lower()
 
-                        # 1. ОБРАБОТКА УДАЛЕНИЯ ПУНКТА
+                        # 1. Обработка удаления пункта
                         if any(w in user_msg_lower for w in ["удали", "стереть", "убрать", "вырежи", "удалить"]):
                             target_num_match = re.search(r'\d+(\.\d+)*', user_message)
                             target_num = target_num_match.group(0) if target_num_match else ""
@@ -315,7 +352,7 @@ def process_chat_message(
                                 new_lines = lines
                             proposed_text = "\n".join(new_lines)
 
-                        # 2. ОБРАБОТКА ДОБАВЛЕНИЯ / ИЗМЕНЕНИЯ ПУНКТА
+                        # 2. Обработка добавления / изменения пункта
                         elif proposed_text:
                             if len(proposed_text) < 500:
                                 clean_item = proposed_text.strip()
@@ -336,7 +373,23 @@ def process_chat_message(
                                     new_lines.append(f"   {clean_item}")
                                 proposed_text = "\n".join(new_lines)
 
-                        db_set_session_state(session_id, "PROMPT_PREVIEW", proposed_text)
+                        # Сохраняем черновик в структурированном виде с idle_turns = 0
+                        state_payload = {
+                            "draft_text": proposed_text,
+                            "idle_turns": 0
+                        }
+                        db_set_session_state(session_id, "PROMPT_PREVIEW", state_payload)
+
+                        # Помечаем последнее сообщение пользователя как эфемерное
+                        with get_db_connection() as conn_fix:
+                            cursor_fix = conn_fix.cursor()
+                            cursor_fix.execute("""
+                                UPDATE chat_messages 
+                                SET is_ephemeral = 1 
+                                WHERE id = (SELECT MAX(id) FROM chat_messages WHERE session_id = ? AND role = 'user')
+                            """, (session_id,))
+                            conn_fix.commit()
+                        
                         preview_reply = (
                             f"Ваше изменение успешно предпросмотрено. Полный обновленный системный промпт теперь выглядит так:\n\n"
                             f"{proposed_text}\n\n"
@@ -368,6 +421,7 @@ def process_chat_message(
                             reply_text = action_cfg["success_template"]
                             if action_cfg.get("follow_up_question"):
                                 reply_text += f"\n\n{action_cfg['follow_up_question']}"
+                            reply_text = reply_text.replace("✅", "").replace("❌", "").replace("**", "").replace("*", "").strip()
                             is_eph = action_cfg.get("is_ephemeral", 1)
                             db_save_chat_message(session_id, "assistant", reply_text, is_ephemeral=is_eph)
                             return reply_text, db_get_chat_history(session_id), {
@@ -378,20 +432,67 @@ def process_chat_message(
 
                     messages.append({"role": "tool", "content": tool_result_content})
 
-                # --- [SECTION 7: SECONDARY LLM PASS] --- # ANCHOR[SECONDARY_PASS]
+                # --- [SECTION 7: SECONDARY LLM PASS & CONTEXT GUARD] --- # ANCHOR[SECONDARY_PASS]
                 second_payload = {"model": TEXT_MODEL, "messages": messages, "stream": False, "options": llm_options}
                 sec_req = urllib.request.Request(OLLAMA_URL, data=json.dumps(second_payload).encode("utf-8"), headers={"Content-Type": "application/json"})
                 with urllib.request.urlopen(sec_req) as sec_response:
                     sec_res_data = json.loads(sec_response.read().decode("utf-8"))
-                    raw_content = sec_res_data.get("message", {}).get("content", "").strip().replace("**", "")
+                    raw_content = sec_res_data.get("message", {}).get("content", "").strip().replace("**", "").replace("*", "")
                     final_content = clean_raw_tool_tags(clean_output(raw_content))
-                    db_save_chat_message(session_id, "assistant", final_content, is_ephemeral=0)
+
+                    # Определяем, был ли вызов служебного инструмента просмотра промпта
+                    tool_names_called = [t["function"]["name"] for t in tool_calls]
+                    is_output_ephemeral = 1 if any(name in ["db_get_system_prompt", "db_get_system_prompts", "db_preview_prompt_merge"] for name in tool_names_called) else 0
+
+                    # Отслеживание отвлечений при активном процессе настройки
+                    if session_state and session_state.get("state_type") in ["PROMPT_PREVIEW", "PROMPT_FOLLOWUP"]:
+                        idle_count = db_increment_session_idle(session_id)
+                        logger.info(f"Смена темы ({session_state.get('state_type')}). Текущий idle_turns: {idle_count}")
+                        
+                        if idle_count == 3:
+                            guard_note = "\n\nНапоминание: Завершить настройку системного промпта и очистить сессию?"
+                            final_content += guard_note
+                            db_save_chat_message(session_id, "assistant", final_content, is_ephemeral=is_output_ephemeral)
+                            return final_content, db_get_chat_history(session_id), {
+                                "type": "FOLLOW_UP_ACTION",
+                                "buttons": [
+                                    {"label": "Да, закончить", "value": "нет, закончить настройку", "style": "primary"},
+                                    {"label": "Показать промпт", "value": "покажи системный промпт", "style": "secondary"}
+                                ]
+                            }
+                        elif idle_count > 3:
+                            logger.info(f"Автоочистка сессии: оператор переключился на другую тему (idle_turns={idle_count}).")
+                            db_clear_session_state(session_id)
+                            db_purge_ephemeral_messages(session_id)
+
+                    db_save_chat_message(session_id, "assistant", final_content, is_ephemeral=is_output_ephemeral)
                     return final_content, db_get_chat_history(session_id), None
 
-            # Если вызовов функций не было
-            raw_str = msg.get("content", "").strip().replace("**", "")
+            # Если вызовов инструментов не было (обычный текстовый диалог)
+            raw_str = msg.get("content", "").strip().replace("**", "").replace("*", "")
             content_str = clean_raw_tool_tags(clean_output(raw_str))
             final_reply = content_str or "Запрос обработан."
+
+            if session_state and session_state.get("state_type") in ["PROMPT_PREVIEW", "PROMPT_FOLLOWUP"]:
+                idle_count = db_increment_session_idle(session_id)
+                logger.info(f"Текстовый диалог вне настройки ({session_state.get('state_type')}). Текущий idle_turns: {idle_count}")
+                
+                if idle_count == 3:
+                    guard_note = "\n\nНапоминание: Завершить настройку системного промпта и очистить сессию?"
+                    final_reply += guard_note
+                    db_save_chat_message(session_id, "assistant", final_reply, is_ephemeral=0)
+                    return final_reply, db_get_chat_history(session_id), {
+                        "type": "FOLLOW_UP_ACTION",
+                        "buttons": [
+                            {"label": "Да, закончить", "value": "нет, закончить настройку", "style": "primary"},
+                            {"label": "Показать промпт", "value": "покажи системный промпт", "style": "secondary"}
+                        ]
+                    }
+                elif idle_count > 3:
+                    logger.info(f"Автоочистка сессии: оператор переключился на другую тему (idle_turns={idle_count}).")
+                    db_clear_session_state(session_id)
+                    db_purge_ephemeral_messages(session_id)
+
             db_save_chat_message(session_id, "assistant", final_reply, is_ephemeral=0)
             return final_reply, db_get_chat_history(session_id), None
 

modules/web_api/llm/db/db_prompts.py

@@ -1,5 +1,10 @@
 """
 FILE: modules/web_api/llm/db/db_prompts.py
+PROJECT: SCUD Orion AI
+MODULE: web_api / llm / db
+ROLE: Управление системными промптами, правилами базы знаний, 
+      декларативным реестром действий инструментов (tool_action_registry)
+      и расширенным сессионным состоянием (session_states + idle_turns).
 """
 import json
 import logging
@@ -8,7 +13,9 @@ from .connection import get_db_connection
 
 logger = logging.getLogger("DB_PROMPTS")
 
+
 def db_get_active_system_prompt() -> str:
+    """Извлекает актуальный активный системный промпт из SQLite."""
     conn = get_db_connection()
     cursor = conn.cursor()
     cursor.execute("SELECT prompt_text FROM system_prompts WHERE is_active = 1 ORDER BY id DESC LIMIT 1")
@@ -16,6 +23,7 @@ def db_get_active_system_prompt() -> str:
     conn.close()
     return row["prompt_text"] if row else "Ты — ИИ-ассистент SCUD Orion AI."
 
+
 def db_get_tool_action(tool_name: str) -> Optional[Dict[str, Any]]:
     """Получение шаблона, кнопок и настроек эфемерности инструмента из SQLite."""
     conn = get_db_connection()
@@ -35,7 +43,9 @@ def db_get_tool_action(tool_name: str) -> Optional[Dict[str, Any]]:
         return res
     return None
 
+
 def db_add_system_prompt(name: str, prompt_text: str) -> Dict[str, Any]:
+    """Сохраняет новую версию системного промпта и активирует её."""
     try:
         with get_db_connection() as conn:
             cursor = conn.cursor()
@@ -58,7 +68,9 @@ def db_add_system_prompt(name: str, prompt_text: str) -> Dict[str, Any]:
         logger.error(f"Ошибка при сохранении промпта в БД: {e}")
         return {"status": "error", "error": str(e)}
 
+
 def db_get_rules() -> List[Dict[str, Any]]:
+    """Извлекает список глобальных правил компании из ai_knowledge_base."""
     conn = get_db_connection()
     cursor = conn.cursor()
     cursor.execute("SELECT id, rule_text FROM ai_knowledge_base ORDER BY id ASC")
@@ -66,9 +78,24 @@ def db_get_rules() -> List[Dict[str, Any]]:
     conn.close()
     return [dict(r) for r in rows]
 
-def db_set_session_state(session_id: str, state_type: str, data: str):
+
+# =============================================================================
+# РАБОТА С СЕССИОННЫМИ СОСТОЯНИЯМИ, ЧЕРНОВИКАМИ И СЧЕТЧИКОМ ОТВЛЕЧЕНИЙ (IDLE_TURNS)
+# =============================================================================
+
+def db_set_session_state(session_id: str, state_type: str, data: Any) -> None:
+    """
+    Сохраняет состояние сессии в SQLite.
+    Если передан dict/list — автоматически сериализует его в JSON-строку.
+    """
     conn = get_db_connection()
     cursor = conn.cursor()
+    
+    if isinstance(data, (dict, list)):
+        payload_str = json.dumps(data, ensure_ascii=False)
+    else:
+        payload_str = str(data) if data is not None else ""
+
     cursor.execute("""
         INSERT INTO session_states (session_id, state_type, pending_data, updated_at)
         VALUES (?, ?, ?, CURRENT_TIMESTAMP)
@@ -76,26 +103,78 @@ def db_set_session_state(session_id: str, state_type: str, data: str):
             state_type = excluded.state_type,
             pending_data = excluded.pending_data,
             updated_at = CURRENT_TIMESTAMP
-    """, (session_id, state_type, data))
+    """, (session_id, state_type, payload_str))
     conn.commit()
     conn.close()
 
+
 def db_get_session_state(session_id: str) -> Optional[Dict[str, Any]]:
+    """
+    Извлекает состояние сессии из SQLite.
+    Если в pending_data лежит валидный JSON-объект — парсит его в data_json.
+    """
     conn = get_db_connection()
     cursor = conn.cursor()
-    cursor.execute("SELECT state_type, pending_data FROM session_states WHERE session_id = ?", (session_id,))
+    cursor.execute(
+        "SELECT session_id, state_type, pending_data, updated_at FROM session_states WHERE session_id = ?",
+        (session_id,)
+    )
     row = cursor.fetchone()
     conn.close()
-    return dict(row) if row else None
     
-def db_clear_session_state(session_id: str):
+    if not row:
+        return None
+
+    res = dict(row)
+    raw_data = res.get("pending_data") or ""
+    
+    try:
+        if raw_data.strip().startswith("{") or raw_data.strip().startswith("["):
+            res["data_json"] = json.loads(raw_data)
+        else:
+            res["data_json"] = None
+    except Exception:
+        res["data_json"] = None
+        
+    return res
+
+
+def db_increment_session_idle(session_id: str) -> int:
+    """
+    Инкрементирует счетчик idle_turns для активного черновика сессии.
+    Возвращает обновленное значение счетчика отвлечений.
+    """
+    state = db_get_session_state(session_id)
+    if not state:
+        return 0
+
+    data_meta = state.get("data_json")
+    if isinstance(data_meta, dict):
+        current_turns = data_meta.get("idle_turns", 0) + 1
+        data_meta["idle_turns"] = current_turns
+        db_set_session_state(session_id, state["state_type"], data_meta)
+        return current_turns
+    else:
+        # Если ранее данные были сохранены обычной строкой
+        new_meta = {
+            "draft_text": state.get("pending_data", ""),
+            "idle_turns": 1
+        }
+        db_set_session_state(session_id, state["state_type"], new_meta)
+        return 1
+
+
+def db_clear_session_state(session_id: str) -> None:
+    """Сбрасывает и удаляет активное состояние сессии."""
     conn = get_db_connection()
     cursor = conn.cursor()
     cursor.execute("DELETE FROM session_states WHERE session_id = ?", (session_id,))
     conn.commit()
     conn.close()
 
+
 def db_get_session_states() -> Dict[str, Any]:
+    """Возвращает реестр всех активных сессий."""
     conn = get_db_connection()
     cursor = conn.cursor()
     cursor.execute("SELECT session_id, state_type, updated_at FROM session_states")
@@ -103,10 +182,19 @@ def db_get_session_states() -> Dict[str, Any]:
     conn.close()
     return {"status": "success", "active_sessions": [dict(r) for r in rows]}
 
+
+# =============================================================================
+# СЛУЖЕБНАЯ ДИАГНОСТИКА И СТАТИСТИКА
+# =============================================================================
+
 def db_get_stats() -> Dict[str, Any]:
+    """Возвращает статистику по количеству записей в таблицах."""
     conn = get_db_connection()
     cursor = conn.cursor()
-    tables = ['scud_logs', 'zup_staff', 'zup_absences', 'anomalies_history', 'ai_knowledge_base', 'system_prompts', 'session_states', 'tasks']
+    tables = [
+        'scud_logs', 'zup_staff', 'zup_absences', 'anomalies_history', 
+        'ai_knowledge_base', 'system_prompts', 'session_states', 'tasks'
+    ]
     stats = {}
     for t in tables:
         try:
@@ -117,7 +205,9 @@ def db_get_stats() -> Dict[str, Any]:
     conn.close()
     return {"status": "success", "tables_stats": stats}
 
+
 def db_get_anomalies(limit: int = 100, date_str: Optional[str] = None) -> Dict[str, Any]:
+    """Извлекает журнал зафиксированных аномалий."""
     conn = get_db_connection()
     cursor = conn.cursor()
     query = "SELECT anomaly_date, fio, anomaly_type, details FROM anomalies_history"
@@ -132,7 +222,9 @@ def db_get_anomalies(limit: int = 100, date_str: Optional[str] = None) -> Dict[s
     conn.close()
     return {"status": "success", "count": len(rows), "anomalies": [dict(r) for r in rows]}
 
+
 def db_get_reference(category: Optional[str] = None) -> Dict[str, Any]:
+    """Извлекает справочные команды и примеры подсказок."""
     conn = get_db_connection()
     cursor = conn.cursor()
     query = "SELECT category, title, example_prompt, description FROM system_reference"

modules/web_api/llm/db_tools.py

@@ -14,11 +14,11 @@ from .db.db_prompts import (
     db_set_session_state,
     db_get_session_state,
     db_clear_session_state,
+    db_increment_session_idle,
     db_get_session_states,
     db_get_stats,
     db_get_anomalies,
-    db_get_reference,
-    db_get_tool_action
+    db_get_reference
 )
 
 def db_get_current_server_time():

scripts/diagnostics/inspect_ephemeral.py

@@ -0,0 +1,58 @@
+import os
+import sqlite3
+
+DB_PATH = os.path.join(os.path.dirname(__file__), "../../data/scud_orion_ai.db")
+if not os.path.exists(DB_PATH):
+    DB_PATH = "data/scud_orion_ai.db"
+
+conn = sqlite3.connect(DB_PATH)
+cursor = conn.cursor()
+
+print("=" * 90)
+print(f"🔍 ИНСПЕКЦИЯ СООБЩЕНИЙ В БАЗЕ: {DB_PATH}")
+print("=" * 90)
+
+# 1. Проверяем наличие колонки is_ephemeral
+cursor.execute("PRAGMA table_info(chat_messages);")
+cols = [c[1] for c in cursor.fetchall()]
+
+if "is_ephemeral" not in cols:
+    print("❌ Колонка is_ephemeral отсутствует в таблице chat_messages!")
+    conn.close()
+    exit(1)
+
+# 2. Считаем общее количество и распределение
+cursor.execute("SELECT COUNT(*) FROM chat_messages")
+total_count = cursor.fetchone()[0]
+
+cursor.execute("SELECT COUNT(*) FROM chat_messages WHERE is_ephemeral = 1")
+ephemeral_count = cursor.fetchone()[0]
+
+cursor.execute("SELECT COUNT(*) FROM chat_messages WHERE is_ephemeral = 0")
+permanent_count = cursor.fetchone()[0]
+
+print(f"Всего записей в истории: {total_count}")
+print(f"  • Постоянные (is_ephemeral = 0): {permanent_count}")
+print(f"  • Фантомные / Эфемерные (is_ephemeral = 1): {ephemeral_count}")
+print("-" * 90)
+
+# 3. Выводим все фантомные записи
+if ephemeral_count == 0:
+    print("В базе нет фантомных записей (is_ephemeral = 1 пуст).")
+else:
+    print(f"📋 СПИСОК ВСЕХ ФАНТОМНЫХ СООБЩЕНИЙ ({ephemeral_count} шт.):")
+    cursor.execute("""
+        SELECT id, session_id, role, created_at, content 
+        FROM chat_messages 
+        WHERE is_ephemeral = 1 
+        ORDER BY id ASC
+    """)
+    for row in cursor.fetchall():
+        msg_id, session_id, role, created_at, content = row
+        print(f"\n[ID: {msg_id}] | Сессия: {session_id} | Роль: {role} | Время: {created_at}")
+        print("Содержимое:")
+        print(content.strip())
+        print("-" * 70)
+
+conn.close()
+print("=" * 90)