Scaffold Engine application interfaces

Data/Engine/interfaces/ws/__init__.py

@@ -2,11 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Any, Optional
 
 from flask import Flask
 
 from ...config import SocketIOSettings
+from .agents import register as register_agent_events
+from .job_management import register as register_job_events
 
 try:  # pragma: no cover - import guard
     from flask_socketio import SocketIO
@@ -31,4 +33,14 @@ def create_socket_server(app: Flask, settings: SocketIOSettings) -> Optional[Soc
     return socketio
 
 
-__all__ = ["create_socket_server"]
+def register_ws_interfaces(socketio: Any) -> None:
+    """Attach placeholder namespaces for the Engine Socket.IO server."""
+
+    if socketio is None:  # pragma: no cover - guard
+        return
+
+    for registrar in (register_agent_events, register_job_events):
+        registrar(socketio)
+
+
+__all__ = ["create_socket_server", "register_ws_interfaces"]

Data/Engine/interfaces/ws/agents/__init__.py

@@ -0,0 +1,16 @@
+"""Agent WebSocket namespace wiring for the Engine."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from . import events
+
+
+def register(socketio: Any) -> None:
+    """Register agent namespaces on the given Socket.IO *socketio* instance."""
+
+    events.register(socketio)
+
+
+__all__ = ["register"]

Data/Engine/interfaces/ws/agents/events.py

@@ -0,0 +1,20 @@
+"""Agent WebSocket event placeholders for the Engine."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+def register(socketio: Any) -> None:
+    """Register agent-related namespaces on *socketio*.
+
+    The concrete event handlers will be migrated in later phases.
+    """
+
+    if socketio is None:  # pragma: no cover - guard
+        return
+    # Placeholder for namespace registration, e.g. ``socketio.on_namespace(...)``.
+    return
+
+
+__all__ = ["register"]

Data/Engine/interfaces/ws/job_management/__init__.py

@@ -0,0 +1,16 @@
+"""Job management WebSocket namespace wiring for the Engine."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from . import events
+
+
+def register(socketio: Any) -> None:
+    """Register job management namespaces on the given Socket.IO *socketio*."""
+
+    events.register(socketio)
+
+
+__all__ = ["register"]

Data/Engine/interfaces/ws/job_management/events.py

@@ -0,0 +1,19 @@
+"""Job management WebSocket event placeholders for the Engine."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+def register(socketio: Any) -> None:
+    """Register job management namespaces on *socketio*.
+
+    Concrete handlers will be migrated in later phases.
+    """
+
+    if socketio is None:  # pragma: no cover - guard
+        return
+    return
+
+
+__all__ = ["register"]