#!/usr/bin/env bash
# hermes-display-run <N>
#
# ExecStart of hermes-display@<N>.service. Runs as the bot's Unix user (User= in the unit).
# Brings up ONE private bot desktop:
#   Xtigervnc :N  (RFB on a 0600 unix socket only, no TCP; VncAuth with a per-display password;
#                  X11 TCP listening disabled; clients may NOT resize the framebuffer)
#   a private D-Bus session bus  (unix:path=$RUN/bus)  -> no clash with :1 / other displays
#   AT-SPI accessibility bus     (at-spi-bus-launcher --a11y=1 on that private bus)
#   a desktop session            (xfce-lite by default: xfwm4 + xfsettingsd + xfce4-panel)
# and writes $RUN/env: the exact environment a cua-driver / Hermes child needs to drive this display.
#
# Exits non-zero if Xvnc or the bus dies, so systemd restarts the whole display.
set -uo pipefail

N="${1:?usage: hermes-display-run <display-number>}"
if ! [[ "$N" =~ ^[0-9]+$ ]] || (( N < 10 || N > 99 )); then
  echo "hermes-display: display number must be 10..99 (:1-:9 are reserved for humans/legacy)" >&2
  exit 78   # EX_CONFIG: RestartPreventExitStatus in the unit
fi

HERE="$(cd "$(dirname "$(readlink -f "$0")")" && pwd)"
SKEL="$HERE/../skel"

# ---- tunables (override per display in ~/.config/hermes-studio/displays/<N>.env) ----
GEOMETRY="${HERMES_DISPLAY_GEOMETRY:-1280x800}"
DEPTH="${HERMES_DISPLAY_DEPTH:-24}"
SESSION="${HERMES_DISPLAY_SESSION:-xfce-lite}"       # xfce-lite | xfce | wm-only
BROWSER_AUTOSTART="${HERMES_DISPLAY_BROWSER_AUTOSTART:-0}"
BROWSER_URL="${HERMES_DISPLAY_BROWSER_URL:-about:blank}"

STATE="${HERMES_DISPLAY_STATE:-$HOME/.local/share/hermes-displays/$N}"
RUN="${RUNTIME_DIRECTORY:-/run/hermes-display/$N}"   # systemd RuntimeDirectory (0700, owned by us)
mkdir -p "$RUN" && chmod 700 "$RUN"
umask 077
mkdir -p "$STATE"/{config,cache,chrome,data}

log() { echo "hermes-display[:$N] $*"; }

# ---- seed per-display XDG config (isolated from the human's :1 XFCE config) ----
PANEL_XML="$STATE/config/xfce4/xfconf/xfce-perchannel-xml/xfce4-panel.xml"
if [[ ! -s "$PANEL_XML" ]]; then
  mkdir -p "$(dirname "$PANEL_XML")"
  cp "$SKEL/xfce4-panel.xml" "$PANEL_XML"
fi
# Never let a screensaver/locker or desktop-wide autostarts run on a bot display:
# a locked screen freezes renderers and hides the AT-SPI tree from the agent.
mkdir -p "$STATE/config/autostart"
for f in xscreensaver light-locker xfce4-screensaver xfce4-power-manager pulseaudio \
         snap-userd-autostart polkit-gnome-authentication-agent-1 xiccd update-notifier nm-applet; do
  printf '[Desktop Entry]\nType=Application\nName=%s\nHidden=true\n' "$f" > "$STATE/config/autostart/$f.desktop"
done

# ---- per-display VNC password (VncAuth). Stored only in vncpasswd's obfuscated form, mode 0600. ----
PASSWD="$STATE/vnc.passwd"
if [[ ! -s "$PASSWD" ]]; then
  python3 -c 'import secrets,string; print("".join(secrets.choice(string.ascii_letters+string.digits) for _ in range(8)))' \
    | vncpasswd -f > "$PASSWD"
  chmod 600 "$PASSWD"
  log "generated per-display VNC password file $PASSWD"
fi

# ---- X authority: fresh MIT cookie per start, merged into ~/.Xauthority like tigervncserver does ----
COOKIE="$(mcookie)"
xauth -q -f "$STATE/Xauthority" add ":$N" . "$COOKIE"
xauth -q add ":$N" . "$COOKIE"

# ---- stale lock cleanup (e.g. after a crash) ----
LOCK="/tmp/.X$N-lock"
if [[ -e "$LOCK" ]]; then
  pid="$(tr -dc 0-9 < "$LOCK" 2>/dev/null || true)"
  if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
    log "display :$N is already in use by pid $pid"; exit 1
  fi
  log "removing stale $LOCK"; rm -f "$LOCK" "/tmp/.X11-unix/X$N"
fi

VNC_SOCK="$RUN/vnc.sock"
rm -f "$VNC_SOCK" "$RUN/bus" "$RUN/env"

cleanup() {
  trap - EXIT TERM INT
  kill $(jobs -p) 2>/dev/null
  xauth -q remove ":$N" 2>/dev/null
  rm -f "$RUN/env"
}
trap cleanup EXIT
trap 'exit 0' TERM INT

# rfbport -1 = no TCP listener at all; rfbunixpath/rfbunixmode = RFB on a 0600 unix socket.
# AcceptSetDesktopSize=0: viewers cannot resize the framebuffer (agent coordinates assume fixed geometry).
/usr/bin/Xtigervnc ":$N" \
  -desktop "hermes-bot:$N" \
  -geometry "$GEOMETRY" -depth "$DEPTH" -dpi 96 \
  -rfbport -1 -rfbunixpath "$VNC_SOCK" -rfbunixmode 0600 \
  -SecurityTypes VncAuth -PasswordFile "$PASSWD" \
  -AlwaysShared -AcceptSetDesktopSize=0 \
  -nolisten tcp -auth "$STATE/Xauthority" \
  -FrameRate 30 &
XPID=$!

for _ in $(seq 1 100); do
  [[ -S "/tmp/.X11-unix/X$N" ]] && DISPLAY=":$N" xdpyinfo >/dev/null 2>&1 && break
  kill -0 "$XPID" 2>/dev/null || { log "Xtigervnc exited during startup"; exit 1; }
  sleep 0.1
done
DISPLAY=":$N" xdpyinfo >/dev/null 2>&1 || { log "X server :$N not reachable"; exit 1; }
log "Xtigervnc up (pid $XPID) rfb=unix:$VNC_SOCK"

# ---- private session bus ----
/usr/bin/dbus-daemon --session --address="unix:path=$RUN/bus" --nofork --nopidfile --syslog-only &
DBUSPID=$!
for _ in $(seq 1 50); do [[ -S "$RUN/bus" ]] && break; sleep 0.1; done
[[ -S "$RUN/bus" ]] || { log "dbus-daemon failed"; exit 1; }

# ---- the environment contract (also written to $RUN/env for Hermes / cua-driver / screen hub) ----
export DISPLAY=":$N"
export DBUS_SESSION_BUS_ADDRESS="unix:path=$RUN/bus"
export XDG_CONFIG_HOME="$STATE/config"
export XDG_CACHE_HOME="$STATE/cache"
export XDG_RUNTIME_DIR="$RUN/xdg"; mkdir -p "$XDG_RUNTIME_DIR"   # private: at-spi/gvfs/dconf sockets per display
export XDG_CURRENT_DESKTOP=XFCE XDG_SESSION_DESKTOP=xfce XDG_SESSION_TYPE=x11 DESKTOP_SESSION=xfce
export CHROME_CONFIG_HOME="$STATE/chrome"             # per-bot Chrome profile (Chrome honours this env var)
export ACCESSIBILITY_ENABLED=1 GNOME_ACCESSIBILITY=1 QT_ACCESSIBILITY=1 QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1
export NO_AT_BRIDGE=0
unset WAYLAND_DISPLAY SESSION_MANAGER

{
  echo "# written by hermes-display-run for :$N; sourced/parsed by Hermes computer_use + screen hub"
  for k in DISPLAY DBUS_SESSION_BUS_ADDRESS XDG_CONFIG_HOME XDG_CACHE_HOME XDG_RUNTIME_DIR CHROME_CONFIG_HOME ACCESSIBILITY_ENABLED GNOME_ACCESSIBILITY \
           QT_ACCESSIBILITY QT_LINUX_ACCESSIBILITY_ALWAYS_ON XDG_SESSION_TYPE XDG_CURRENT_DESKTOP; do
    printf '%s=%s\n' "$k" "${!k}"
  done
  printf 'HERMES_DISPLAY_VNC_SOCKET=%s\n' "$VNC_SOCK"
  printf 'HERMES_DISPLAY_CUA_SOCKET=%s\n' "$RUN/cua.sock"
  printf 'HERMES_DISPLAY_VNC_PASSWD_FILE=%s\n' "$PASSWD"
  printf 'HERMES_DISPLAY_GEOMETRY=%s\n' "$GEOMETRY"
} > "$RUN/env.tmp" && chmod 600 "$RUN/env.tmp" && mv "$RUN/env.tmp" "$RUN/env"

"$HERE/hermes-display-session" "$SESSION" "$BROWSER_AUTOSTART" "$BROWSER_URL" &
SESSPID=$!
log "session '$SESSION' started (pid $SESSPID)"

# Xvnc or the bus dying is fatal -> systemd restarts the unit. The session supervises its own children.
wait -n "$XPID" "$DBUSPID"
rc=$?
log "core process exited (rc=$rc); tearing down"
exit 1
