wip hud - init of hud skill and server

api/interface.py

@@ -1056,12 +1056,38 @@ class DuplicateWingmanResult(BaseModel):
     wingman_file: WingmanConfigFileInfo
 
 
+class HudServerSettings(BaseModel):
+    """HUD Server settings for global configuration."""
+
+    enabled: bool = True
+    """Whether the HUD server should auto-start with Wingman AI Core."""
+
+    host: str = "127.0.0.1"
+    """The interface to listen on. Use '127.0.0.1' for local only, '0.0.0.0' for LAN access."""
+
+    port: int = 7862
+    """The port to listen on."""
+
+    framerate: int = Field(default=60, ge=1)
+    """HUD overlay rendering framerate. Higher = smoother but more CPU. Minimum 1."""
+
+    layout_margin: int = Field(default=20, ge=0, le=200)
+    """Margin from screen edges in pixels for HUD elements. Between 0 and 200."""
+
+    layout_spacing: int = Field(default=15, ge=0, le=100)
+    """Spacing between stacked HUD windows in pixels. Between 0 and 100."""
+
+    screen: int = Field(default=1, ge=1, le=10)
+    """Which screen/monitor to render the HUD on (1 = primary, 2 = secondary, etc.)."""
+
+
 class SettingsConfig(BaseModel):
     audio: Optional[AudioSettings] = None
     voice_activation: VoiceActivationSettings
     wingman_pro: WingmanProSettings
     xvasynth: XVASynthSettings
     pocket_tts: PocketTTSSettings
+    hud_server: Optional[HudServerSettings] = None
     debug_mode: bool
     streamer_mode: bool
     cancel_tts_key: Optional[str] = None