Add Windows GUI Host Installer EXE, Chrome Remote Desktop inline setup, and Admin Tools

.github/workflows/build-windows-agent.yml

@@ -1,8 +1,10 @@
-name: Build Windows Agent EXE & Publish GitHub Release
+name: Build Windows Host Installer EXE & Publish GitHub Release
 
 on:
   workflow_dispatch:
   push:
+    branches:
+      - main
     tags:
       - 'v*'
     paths:
@@ -14,7 +16,7 @@ permissions:
   contents: write
 
 jobs:
-  build-win64-agent:
+  build-win64-host:
     runs-on: windows-latest
     steps:
       - name: Checkout repository
@@ -30,36 +32,49 @@ jobs:
           python -m pip install --upgrade pip
           pip install pyinstaller psutil websockets aiortc mss Pillow
 
-      - name: Compile standalone GothwadRemoteAgent-win64.exe
+      - name: Compile GUI Installer EXE (--noconsole --uac-admin)
         run: |
-          pyinstaller --onefile --collect-all av --collect-all aiortc --name GothwadRemoteAgent-win64 agent/gothwad_agent.py
+          pyinstaller --onefile --noconsole --uac-admin --paths agent --collect-all av --collect-all aiortc --name GothwadRemoteHostSetup agent/gothwad_agent.py
 
-      - name: Bundle Setup Zip (Agent EXE + Hyper-V & Installer Scripts)
+      - name: Prepare Release Assets (GUI Setup EXE + Zip Bundle)
         shell: pwsh
         run: |
+          Copy-Item dist/GothwadRemoteHostSetup.exe dist/GothwadRemoteAgent-win64.exe -Force
           New-Item -ItemType Directory -Force -Path release-bundle | Out-Null
-          Copy-Item dist/GothwadRemoteAgent-win64.exe release-bundle/
+          Copy-Item dist/GothwadRemoteHostSetup.exe release-bundle/
           Copy-Item scripts/host-setup-hyperv.ps1 release-bundle/
           Copy-Item scripts/install-gothwad-agent.ps1 release-bundle/
           Compress-Archive -Path release-bundle/* -DestinationPath dist/GothwadRemoteSetup-win64.zip -Force
 
       - name: Upload Build Artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: gothwad-remote-agent-win64
+          name: gothwad-remote-host-win64
           path: |
+            dist/GothwadRemoteHostSetup.exe
             dist/GothwadRemoteAgent-win64.exe
             dist/GothwadRemoteSetup-win64.zip
 
-      - name: Publish to GitHub Releases (on version tag v*)
-        if: startsWith(github.ref, 'refs/tags/v')
+      - name: Publish or Update Latest GitHub Release
+        if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: pwsh
         run: |
-          $tag = "${{ github.ref_name }}"
-          gh release create $tag `
-            dist/GothwadRemoteAgent-win64.exe `
-            dist/GothwadRemoteSetup-win64.zip `
-            --title "Gothwad Remote Desktop Agent $tag" `
-            --generate-notes
+          $tag = if ("${{ github.ref }}".StartsWith("refs/tags/v")) { "${{ github.ref_name }}" } else { "v1.0.0" }
+          $exists = gh release view $tag 2>$null
+          if ($LASTEXITCODE -eq 0) {
+            gh release upload $tag `
+              dist/GothwadRemoteHostSetup.exe `
+              dist/GothwadRemoteAgent-win64.exe `
+              dist/GothwadRemoteSetup-win64.zip `
+              --clobber
+          } else {
+            gh release create $tag `
+              dist/GothwadRemoteHostSetup.exe `
+              dist/GothwadRemoteAgent-win64.exe `
+              dist/GothwadRemoteSetup-win64.zip `
+              --title "Gothwad Remote Desktop Host ($tag)" `
+              --notes "Standalone Windows 11 GUI Installer & Background Host Service (GothwadRemoteHostSetup.exe). Download and double-click on Windows to enable remote access." `
+              --latest
+          }

README.md

@@ -12,9 +12,12 @@ Modeled on Google Chrome Remote Desktop (`remotedesktop.google.com`), `GothwadTe
   - Clean three-section layout: **Remote Access**, **Remote Support**, and **Set up via PowerShell** (desktop left navigation rail + mobile bottom navigation bar).
   - Exact ecosystem theme palette: **`#212121`** in Dark mode and **`#ffffff`** in Light mode with instant theme switching.
   - **Universal Gothwad Account Menu** (`https://accounts.gothwadtech.com/widget/account-menu.js`) with multi-account (`u/0..5`) switching and `+n` avatar badge.
-- **Mobile-Ready Full-Screen Viewer:**
+- **Chrome Remote Desktop Installation Flow + Native GUI `.exe`:**
+  - Click **Turn on** inside `remotedesktop.gothwadtech.com` -> downloads **`GothwadRemoteHostSetup.exe`** -> choose Computer Name & 6-digit PIN -> launches `gothwad-remote://setup` directly into the Windows app.
+  - Or simply double-click **`GothwadRemoteHostSetup.exe`** on Windows (like an Android APK) to configure your Gothwad Account and 6-digit PIN inside the `#212121` native graphical installer with zero PowerShell commands.
+- **Mobile-Ready Full-Screen Viewer + Administrator Tools:**
   - Collapsible floating top toolbar handle so 100% of your phone screen stays unobstructed.
-  - Dedicated mobile **Keyboard** button (triggers Android/iOS virtual keyboard) and **Direct Touch / Trackpad** cursor toggle.
+  - Dedicated mobile **Keyboard** button, **Direct Touch / Trackpad** cursor toggle, and a slide-over **Tools** drawer with **File Transfer (Upload/Download)**, **Administrator PowerShell**, and **Live Task Manager**.
 - **Main Desktop First, Background VM Optional:**
   - Primary click connects straight to your Windows 11 Main Desktop (with a visible Chrome Remote Desktop-style `"Your desktop is shared [Stop Sharing]"` banner on the host).
   - Optional secondary **Hyper-V Background VM** (`Max 4 GB RAM`, `60% CPU`, Wi-Fi `Default Switch` NAT) accessible from the device overflow menu or viewer toggle.

agent/admin_tools.py

@@ -0,0 +1,198 @@
+"""
+Administrator Remote Management Tools (Files, PowerShell, Processes & System Health)
+====================================================================================
+Provides authenticated P2P handlers for browsing files, uploading/downloading files,
+running Administrator PowerShell commands, and managing running Windows processes.
+"""
+
+from __future__ import annotations
+
+import base64
+import os
+import platform
+import string
+import subprocess
+from pathlib import Path
+from typing import Any, Dict, List
+
+try:
+    import psutil
+except ImportError:  # pragma: no cover
+    psutil = None  # type: ignore[assignment]
+
+MAX_TRANSFER_BYTES = 8 * 1024 * 1024  # 8 MB per single P2P file transfer
+
+
+def list_roots() -> List[Dict[str, Any]]:
+    if platform.system() == "Windows":
+        drives: List[Dict[str, Any]] = []
+        for letter in string.ascii_uppercase:
+            root = f"{letter}:\\"
+            if os.path.exists(root):
+                try:
+                    usage = psutil.disk_usage(root)
+                    drives.append(
+                        {
+                            "name": f"{letter}: Drive",
+                            "path": root,
+                            "isDir": True,
+                            "size": usage.total,
+                            "free": usage.free,
+                        }
+                    )
+                except Exception:
+                    drives.append({"name": f"{letter}: Drive", "path": root, "isDir": True, "size": 0})
+        home = str(Path.home())
+        for folder in ("Desktop", "Downloads", "Documents"):
+            p = os.path.join(home, folder)
+            if os.path.isdir(p):
+                drives.insert(0, {"name": folder, "path": p, "isDir": True, "size": 0})
+        return drives
+    return [{"name": "Home", "path": str(Path.home()), "isDir": True, "size": 0}]
+
+
+def handle_fs_list(req_path: str) -> Dict[str, Any]:
+    if not req_path or req_path == "__roots__":
+        return {"type": "ADMIN_RES", "op": "FS_LIST", "path": "", "entries": list_roots()}
+    target = Path(req_path).expanduser().resolve()
+    if not target.exists() or not target.is_dir():
+        return {"type": "ADMIN_RES", "op": "FS_LIST", "error": f"Folder not found: {req_path}"}
+
+    entries: List[Dict[str, Any]] = []
+    try:
+        for item in sorted(target.iterdir(), key=lambda x: (not x.is_dir(), x.name.lower()))[:250]:
+            try:
+                st = item.stat()
+                entries.append(
+                    {
+                        "name": item.name,
+                        "path": str(item),
+                        "isDir": item.is_dir(),
+                        "size": 0 if item.is_dir() else st.st_size,
+                        "mtime": int(st.st_mtime),
+                    }
+                )
+            except Exception:
+                continue
+    except PermissionError:
+        return {"type": "ADMIN_RES", "op": "FS_LIST", "error": f"Access denied: {target}"}
+
+    parent = str(target.parent) if target.parent != target else "__roots__"
+    return {
+        "type": "ADMIN_RES",
+        "op": "FS_LIST",
+        "path": str(target),
+        "parent": parent,
+        "entries": entries,
+    }
+
+
+def handle_fs_read(file_path: str) -> Dict[str, Any]:
+    target = Path(file_path).expanduser().resolve()
+    if not target.is_file():
+        return {"type": "ADMIN_RES", "op": "FS_READ", "error": "File not found"}
+    size = target.stat().st_size
+    if size > MAX_TRANSFER_BYTES:
+        return {"type": "ADMIN_RES", "op": "FS_READ", "error": "File exceeds 8 MB transfer limit"}
+    data_b64 = base64.b64encode(target.read_bytes()).decode("ascii")
+    return {
+        "type": "ADMIN_RES",
+        "op": "FS_READ",
+        "name": target.name,
+        "size": size,
+        "dataBase64": data_b64,
+    }
+
+
+def handle_fs_write(dest_dir: str, filename: str, data_b64: str) -> Dict[str, Any]:
+    safe_name = os.path.basename(filename.strip()) or "uploaded.bin"
+    folder = Path(dest_dir).expanduser().resolve() if dest_dir else (Path.home() / "Downloads")
+    folder.mkdir(parents=True, exist_ok=True)
+    raw = base64.b64decode(data_b64)
+    if len(raw) > MAX_TRANSFER_BYTES:
+        return {"type": "ADMIN_RES", "op": "FS_WRITE", "error": "Upload exceeds 8 MB limit"}
+    out_file = folder / safe_name
+    out_file.write_bytes(raw)
+    return {"type": "ADMIN_RES", "op": "FS_WRITE", "path": str(out_file), "size": len(raw)}
+
+
+def handle_exec_cmd(command: str) -> Dict[str, Any]:
+    if not command.strip():
+        return {"type": "ADMIN_RES", "op": "EXEC_CMD", "output": "", "exitCode": 0}
+    try:
+        if platform.system() == "Windows":
+            proc = subprocess.run(
+                ["powershell", "-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", command],
+                capture_output=True,
+                text=True,
+                timeout=25,
+            )
+        else:
+            proc = subprocess.run(
+                command,
+                shell=True,
+                capture_output=True,
+                text=True,
+                timeout=25,
+            )
+        combined = (proc.stdout or "") + (("\n" + proc.stderr) if proc.stderr else "")
+        return {
+            "type": "ADMIN_RES",
+            "op": "EXEC_CMD",
+            "output": combined.strip()[-12000:],
+            "exitCode": proc.returncode,
+        }
+    except subprocess.TimeoutExpired:
+        return {"type": "ADMIN_RES", "op": "EXEC_CMD", "output": "Command timed out after 25s.", "exitCode": 124}
+    except Exception as exc:
+        return {"type": "ADMIN_RES", "op": "EXEC_CMD", "output": str(exc), "exitCode": 1}
+
+
+def handle_sys_snapshot() -> Dict[str, Any]:
+    if psutil is None:
+        return {
+            "type": "ADMIN_RES",
+            "op": "SYS_SNAPSHOT",
+            "cpuPercent": 0,
+            "ramUsedMb": 0,
+            "ramTotalMb": 16384,
+            "batteryPercent": None,
+            "powerPlugged": None,
+            "processes": [],
+        }
+    mem = psutil.virtual_memory()
+    bat = getattr(psutil, "sensors_battery", lambda: None)()
+    procs: List[Dict[str, Any]] = []
+    for p in psutil.process_iter(["pid", "name", "memory_info", "cpu_percent"]):
+        try:
+            info = p.info
+            rss_mb = round((info["memory_info"].rss if info.get("memory_info") else 0) / (1024 * 1024), 1)
+            procs.append(
+                {
+                    "pid": info["pid"],
+                    "name": info["name"] or "process",
+                    "ramMb": rss_mb,
+                    "cpu": round(float(info.get("cpu_percent") or 0.0), 1),
+                }
+            )
+        except Exception:
+            continue
+    procs.sort(key=lambda x: x["ramMb"], reverse=True)
+    return {
+        "type": "ADMIN_RES",
+        "op": "SYS_SNAPSHOT",
+        "cpuPercent": round(psutil.cpu_percent(interval=None), 1),
+        "ramUsedMb": round(mem.used / (1024 * 1024)),
+        "ramTotalMb": round(mem.total / (1024 * 1024)),
+        "batteryPercent": round(bat.percent) if bat else None,
+        "powerPlugged": bool(bat.power_plugged) if bat else None,
+        "processes": procs[:35],
+    }
+
+
+def handle_proc_kill(pid: int) -> Dict[str, Any]:
+    try:
+        psutil.Process(int(pid)).terminate()
+        return {"type": "ADMIN_RES", "op": "PROC_KILL", "pid": pid, "ok": True}
+    except Exception as exc:
+        return {"type": "ADMIN_RES", "op": "PROC_KILL", "pid": pid, "ok": False, "error": str(exc)}