Initial commit: VoIdeaAI - voice-first AI idea assistant

app/agents/wake_word.py

@@ -0,0 +1,43 @@
+"""Wake word detection utilities for VoIdeaAI.
+
+Server-side wake word configuration and validation.
+Actual detection is performed client-side via Web Speech API.
+"""
+
+WAKE_WORD_DEFAULTS = {
+    "enabled": True,
+    "word": "ВоИдея",
+    "timeout_minutes": 5,
+    "sensitivity": 0.7,
+}
+
+
+def validate_wake_word_params(params: dict | None = None) -> dict:
+    """Validate and return wake word parameters with defaults."""
+    if not params:
+        return dict(WAKE_WORD_DEFAULTS)
+    result = dict(WAKE_WORD_DEFAULTS)
+    if isinstance(params.get("enabled"), bool):
+        result["enabled"] = params["enabled"]
+    if isinstance(params.get("word"), str) and params["word"].strip():
+        result["word"] = params["word"].strip()
+    if isinstance(params.get("timeout_minutes"), (int, float)):
+        result["timeout_minutes"] = max(1, int(params["timeout_minutes"]))
+    if isinstance(params.get("sensitivity"), (int, float)):
+        result["sensitivity"] = max(0.0, min(1.0, float(params["sensitivity"])))
+    return result
+
+
+def strip_wake_word(text: str, wake_word: str = "ВоИдея") -> str:
+    """Remove wake word prefix from text if present."""
+    cleaned = text.strip()
+    for prefix in [wake_word, wake_word.lower(), wake_word.upper()]:
+        if cleaned.startswith(prefix):
+            cleaned = cleaned[len(prefix):].strip()
+            break
+    return cleaned
+
+
+def has_wake_word(text: str, wake_word: str = "ВоИдея") -> bool:
+    """Check if text contains the wake word (case-insensitive)."""
+    return wake_word.lower() in text.lower()