update dix

docs/architecture/API_REFERENCE.md

@@ -55,6 +55,7 @@ Panel module
 | `start_fastdl` / `stop_fastdl` / `restart_fastdl` / `fastdl_status` | FastDL service management | `fast_download` | Source/GoldSrc web distribution support. |
 | `scheduler_*` methods | Task list and task CRUD | `cron` | Agent-owned scheduler implementation. |
 | `agent_restart` | Restart the agent itself | Admin maintenance | Node maintenance action. |
+| `component_update` | Queue a Git-based agent code update | Update module | Admin-only. Uses encrypted XML-RPC, validates repo/branch/source/destination, launches a detached updater, preserves agent config/runtime/server data, and returns queued status plus an agent log path. |
 | `shell_action` | Run a shell action in a controlled way | Advanced agent operations | Should remain tightly permissioned. |
 | `send_steam_guard_code` | Submit Steam Guard code | Steam authenticated installs | Used for authenticated SteamCMD workflows. |
 | `steam_workshop` / `get_workshop_mods_info` | Workshop-related helper calls | Workshop/content flows | Active in current module work, but still being consolidated. |
@@ -140,6 +141,23 @@ Panel
   -> refresh dedicated preformatted log panel via AJAX
 ```
 
+### Remote Agent Component Update
+
+```text
+Panel update page
+  -> component_update(payload)
+Agent
+  -> validate repo, branch, source folder, destination
+  -> write detached updater script
+  -> return queued + log path
+Updater script
+  -> clone/fetch repository into staging
+  -> copy Agent_Linux or Agent-Windows folder only
+  -> preserve Cfg, ServerFiles, Schedule, logs, steamcmd, startups, pid files
+  -> validate ogp_agent.pl
+  -> restart agent through systemd or screen fallback
+```
+
 ## Error Handling Notes
 
 - Do not treat query failure as a start failure by itself.