mirror of
https://github.com/nesquena/hermes-webui.git
synced 2026-07-04 14:41:05 +00:00
AJV20
78 lines
3.4 KiB
Python
78 lines
3.4 KiB
Python
"""Shared path helpers for Hermes WebUI.
|
|
|
|
Keep low-level filesystem defaults here instead of in ``api.config`` so modules
|
|
that need the default Hermes home can import them without triggering config's
|
|
larger startup side effects.
|
|
"""
|
|
|
|
import os
|
|
from pathlib import Path
|
|
|
|
HOME = Path.home()
|
|
|
|
|
|
def _hermes_home_has_webui_state(base: Path) -> bool:
|
|
"""Return True when *base* holds real WebUI state under its ``webui/`` dir.
|
|
|
|
Used only on Windows to detect a pre-v0.51.134 install at the legacy
|
|
``%USERPROFILE%\\.hermes`` location so we don't strand the user's existing
|
|
sessions/pins/settings when the default moved to ``%LOCALAPPDATA%\\hermes``
|
|
(#2905).
|
|
|
|
We intentionally check ONLY WebUI-owned artifacts (the ``webui/`` subtree),
|
|
NOT agent-owned files like ``config.yaml`` / ``auth.json``. The agent has
|
|
defaulted to ``%LOCALAPPDATA%\\hermes`` on Windows since before #2897, so a
|
|
long-time agent user who never ran WebUI at the legacy location would have a
|
|
stray ``auth.json`` there — keying on that would wrongly divert a *fresh*
|
|
WebUI install to the legacy dir. Only ``webui/`` state is what actually
|
|
gets stranded by the move, so it is the correct and narrow signal.
|
|
Cheap stat-only checks; never raises.
|
|
"""
|
|
try:
|
|
if not base.is_dir():
|
|
return False
|
|
markers = (
|
|
base / "webui" / "sessions", # WebUI session store
|
|
base / "webui" / "settings.json", # WebUI UI settings + pins
|
|
base / "webui", # WebUI state dir at all
|
|
)
|
|
return any(m.exists() for m in markers)
|
|
except OSError:
|
|
return False
|
|
|
|
|
|
def _platform_default_hermes_home() -> Path:
|
|
"""Return the platform-aware default Hermes home when HERMES_HOME is unset.
|
|
|
|
Native Windows Hermes Agent installs default to %LOCALAPPDATA%\\hermes,
|
|
while POSIX installs use ~/.hermes.
|
|
|
|
Windows migration safety (#2905): v0.51.134 moved the Windows default from
|
|
``%USERPROFILE%\\.hermes`` to ``%LOCALAPPDATA%\\hermes`` to match the agent.
|
|
Upgrading users whose WebUI state still lives at the old location saw an
|
|
empty app (sessions/pins/settings "lost" — actually just at an address the
|
|
new build no longer reads). To avoid stranding that data, prefer the
|
|
legacy ``%USERPROFILE%\\.hermes`` ONLY when it is populated AND the new
|
|
``%LOCALAPPDATA%\\hermes`` location is not yet established. This is a
|
|
non-destructive, self-healing fallback: no files are moved, and once the
|
|
new location has state (fresh installs, or users who set HERMES_HOME) the
|
|
legacy path is never preferred. Explicit HERMES_HOME / HERMES_WEBUI_STATE_DIR
|
|
overrides take precedence upstream and are unaffected.
|
|
"""
|
|
if os.name == "nt":
|
|
local_app_data = os.getenv("LOCALAPPDATA", "").strip()
|
|
if local_app_data:
|
|
new_home = Path(local_app_data) / "hermes"
|
|
legacy_home = HOME / ".hermes"
|
|
# Only fall back to the legacy home if it actually holds state and
|
|
# the new location has not been established yet — the exact
|
|
# post-upgrade fingerprint from #2905.
|
|
if (
|
|
legacy_home != new_home
|
|
and not _hermes_home_has_webui_state(new_home)
|
|
and _hermes_home_has_webui_state(legacy_home)
|
|
):
|
|
return legacy_home
|
|
return new_home
|
|
return HOME / ".hermes"
|