`gj ,dZddlZddlZddlZddlmZddlmZddlm Z m Z de fdZ de fdZ de fd Zd ed efd Zd efd Zd ed dfdZddZd ed efdZd ed efdZdd dd efdZded efdZdddd dded dfdZy)uK Hermes Desktop (Chat GUI) uninstaller. The desktop GUI ships in two shapes and this module knows how to find and remove the artifacts of both, on Linux, macOS, and Windows, WITHOUT touching the Python agent or the user's config/data: 1. Source-built GUI (``hermes desktop`` / ``hermes gui``) Built inside the agent checkout under ``$HERMES_HOME/hermes-agent/``: - ``apps/desktop/dist`` (compiled renderer) - ``apps/desktop/release`` (electron-builder unpacked app + installers) - ``apps/desktop/node_modules`` and the workspace-root ``node_modules`` (Electron itself, ~200MB) — only removed on a GUI uninstall because the agent does not need them. - ``$HERMES_HOME/desktop-build-stamp.json`` (the build freshness stamp) 2. Packaged distributable (DMG / NSIS / AppImage / deb / rpm) Installed by the OS to a standard application location and carrying its own bundled Electron + a per-user Electron ``userData`` directory: - macOS: ``/Applications/Hermes.app`` or ``~/Applications/Hermes.app`` - Windows: ``%LOCALAPPDATA%\Programs\Hermes`` (NSIS per-user) - Linux: ``~/.local/share/applications`` .desktop entry + AppImage In both shapes the Electron runtime keeps a ``userData`` directory keyed on the app name ("Hermes"), separate from ``$HERMES_HOME``: - macOS: ``~/Library/Application Support/Hermes`` - Windows: ``%APPDATA%\Hermes`` - Linux: ``$XDG_CONFIG_HOME/Hermes`` (default ``~/.config/Hermes``) This holds the desktop's own ``connection.json`` / ``updates.json`` and Chromium cache — pure GUI state, safe to remove on a GUI uninstall. The functions here are deliberately import-light and side-effect-free at import time so the Electron main process can shell out to ``hermes uninstall --gui`` (and friends) without paying for the full CLI. N)Path)get_hermes_home)ColorscolormsgcTttdtjd|y)Nu→ )printrrCYANrs K/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/gui_uninstall.pylog_infor0s! U5&++ & 'q ./cTttdtjd|y)Nu✓r )r rrGREENr s r log_successr4s! U5&,, ' (# /0rcTttdtjd|y)Nu⚠r )r rrYELLOWr s r log_warnr8s! U5&-- ( )3% 01r hermes_homereturnc |dz S)uEThe agent checkout root — same layout install.sh / install.ps1 use.z hermes-agent)rs r _agent_rootrAs  ''rcjtj}tjdk(r |dz dz dz Stjdk(r9tj j d}|r t|n|dz dz }|dz Stj j d }|r t|n|d z }|dz S) aReturn the Electron ``userData`` directory for the desktop app. Mirrors Electron's ``app.getPath('userData')`` for an app named "Hermes" on each platform. This is GUI-only state (connection.json, updates.json, Chromium cache) and never holds agent config or sessions. darwinLibraryzApplication SupportHermeswin32APPDATAAppDataRoamingXDG_CONFIG_HOMEz.config)rhomesysplatformosenvironget)r$appdatabasexdgs r desktop_userdata_dirr-Fs 99;D ||xi"77(BB ||w**..+ 'tG}dY.>.Jh **..* +C49$"2D (?r list[Path]cTt|}|dz dz }|dz |dz |dz |dz |dz gS)aGUI build artifacts produced by ``hermes desktop`` inside the checkout. These are removable on a GUI uninstall without harming the agent: the Python agent runs from ``hermes-agent/`` source + ``venv/`` and never needs the Electron build output or node_modules. appsdesktopdistrelease node_moduleszdesktop-build-stamp.json)r)r agent_root desktop_dirs r source_built_gui_artifactsr7ZsR[)Jv% 1Kfin$ ^#00  rcDtj}g}tjdk(r|td|dz dz gz }|Stjdk(rtj j d}|r t|n|dz dz }||d z d z |d z gz }tj j d }|r|jt|d z |Stj j d }|r t|n|dz dz }||dz dz |dz dz gz }|S)uStandard install locations of the packaged desktop distributable. Returns every candidate for the current OS; the caller filters to those that actually exist. We never glob system-wide — only the well-known electron-builder output locations for the "Hermes" product. rz/Applications/Hermes.app Applicationsz Hermes.appr LOCALAPPDATAr!LocalProgramsrzhermes-desktop ProgramFiles XDG_DATA_HOMEz.localshare applicationszhermes.desktopzHermes.desktop)rr$r%r&r'r(r)append)r$pathslocal local_base program_filesdata data_bases r packaged_gui_app_pathsrHos8 99;DE ||x + , > !L 0  < L5   ~.$)T%[y0@70J   #h . ) )     ~6  LLm,x7 8 L zz~~o."&DJTH_w-F   &)9 9  &)9 9   Lrct|}|dz jry|dz js|dz jryy)aReturn True when a usable Python agent install exists under HERMES_HOME. Used by the desktop UI to decide which uninstall options to offer: if the agent isn't present (a future "lite" GUI-only client), the "remove agent" options are hidden. hermes_cliTvenvz.venvF)ris_dir)rr5s r agent_is_installedrMsK[)J \!))+V##%*w*>)F)F)H rct|D]}|jsytD]}|jsytjryy)zEReturn True when any desktop GUI artifact exists (built or packaged).TF)r7existsrHr-)rps r gui_is_installedrQsY ' 4 88:$ % 88:$$& rz Path | Nonec ||n t}t|Dcgc]}|js|}}tDcgc]}|js|}}t }t |t |t||Dcgc] }t |c}|Dcgc] }t |c}t ||jtjdScc}wcc}wcc}wcc}w)aStructured snapshot of what's installed, for the desktop UI to render. Returns JSON-serializable primitives so the Electron main process can forward it to the renderer via IPC (paths as strings, booleans for the high-level questions the UI gates options on). )ragent_installed gui_installedsource_built_artifactspackaged_app_paths userdata_diruserdata_existsr&) rr7rOrHr-strrMrQr%r&)rr$rPsource_artifactspackageduserdatas r gui_install_summaryr]s!, 7_=ND#=d#CRaqxxzRR13BaqxxzBHB#%H4y-d3)$/3C"Da3q6"D/78!s1v8H #??,LL   SB#E8s"C#C#C(C( C- $C2 pathc |js|jr|jy|jrt j |y y#t $r}td|d|Yd}~yd}~wwxYw)zIRemove a file or directory tree. Returns True when something was removed.TzCould not remove z: NF) is_symlinkis_fileunlinkrLshutilrmtree Exceptionr)r^es r _remove_pathrgsu2 ??   KKM ;;= MM$    2$TF"QC011 2s0A%A A?$A::A?T)remove_userdatarhc||n t}g}tdt|D]>}|jst |s t d||j |@tdd}tD]@}|jsd}t |s"t d||j |B|s td|rOt}|jr5tdt |rt d||j ||s tdtjjd r td |S) a>Remove the desktop GUI's artifacts, leaving the agent + user data intact. Removes: - source-built GUI artifacts (dist/release/node_modules/build-stamp) - the packaged app bundle / install dir (best-effort; deb/rpm need the system package manager and are reported, not force-removed) - the Electron ``userData`` directory (unless ``remove_userdata=False``) Never touches ``hermes-agent/hermes_cli`` (agent source), ``venv/``, or any config / sessions / .env under ``$HERMES_HOME``. Returns the list of paths actually removed. zARemoving built GUI artifacts (renderer, release, node_modules)...zRemoved z!Removing installed desktop app...FTz3No packaged desktop app found in standard locationsz0Removing desktop app data (Electron userData)...z(No desktop GUI artifacts found to removelinuxzIf you installed the desktop via a .deb / .rpm package, remove it with your package manager (e.g. 'sudo apt remove hermes' or 'sudo dnf remove hermes'). AppImage builds are a single file you can delete from wherever you saved it.) rrr7rOrgrrArHr-r%r& startswith)rrhr$removedr^found_packagedr\s r uninstall_guirns6!, 7_=NDG PQ*40! ;;=\$/ (4&) * NN4 !  01N&(% ;;=!ND!htf-.t$ % FG') ??  G HH%hxj12x( ;<  ||w' 5  Nr)rr.)N)__doc__r'rcr%pathlibrhermes_constantsrhermes_cli.colorsrrrYrrrrr-r7rHboolrMrQdictr]rgrnrrr rus#J ,+0#01S12#2(T(d( d(D\*(VDT" $ 4 ]d< t  9PT9}99Ye9r