Migrate agent control reads and writes to REST

backend/services/gateway_admin_handlers.py

@@ -1,5 +1,12 @@
 # -*- coding: utf-8 -*-
-"""Runtime/workspace/skills handlers extracted from the main Gateway module."""
+"""Runtime/workspace/skills handlers extracted from the main Gateway module.
+
+Deprecated note:
+    Agent/workspace/skill read-write operations are being migrated to
+    agent_service REST endpoints. These websocket handlers remain as a
+    compatibility fallback and should not be considered the primary control
+    plane path for frontend reads/writes.
+"""
 
 from __future__ import annotations