#`.
# Strip the state suffix if present (we already have the verifier server-side).
@@ -1512,14 +1747,16 @@ def _submit_anthropic_pkce(session_id: str, code_input: str) -> Dict[str, Any]:
return {"ok": False, "status": "error", "message": "No code provided"}
state_from_callback = parts[1] if len(parts) > 1 else ""
- exchange_data = json.dumps({
- "grant_type": "authorization_code",
- "client_id": _ANTHROPIC_OAUTH_CLIENT_ID,
- "code": code,
- "state": state_from_callback or sess["state"],
- "redirect_uri": _ANTHROPIC_OAUTH_REDIRECT_URI,
- "code_verifier": sess["verifier"],
- }).encode()
+ exchange_data = json.dumps(
+ {
+ "grant_type": "authorization_code",
+ "client_id": _ANTHROPIC_OAUTH_CLIENT_ID,
+ "code": code,
+ "state": state_from_callback or sess["state"],
+ "redirect_uri": _ANTHROPIC_OAUTH_REDIRECT_URI,
+ "code_verifier": sess["verifier"],
+ }
+ ).encode()
req = urllib.request.Request(
_ANTHROPIC_OAUTH_TOKEN_URL,
data=exchange_data,
@@ -1569,9 +1806,11 @@ async def _start_device_code_flow(provider_id: str) -> Dict[str, Any]:
so the UI can render the verification page link + user code.
"""
from hermes_cli import auth as hauth
+
if provider_id == "nous":
from hermes_cli.auth import _request_device_code, PROVIDER_REGISTRY
import httpx
+
pconfig = PROVIDER_REGISTRY["nous"]
portal_base_url = (
os.getenv("HERMES_PORTAL_BASE_URL")
@@ -1580,15 +1819,21 @@ async def _start_device_code_flow(provider_id: str) -> Dict[str, Any]:
).rstrip("/")
client_id = pconfig.client_id
scope = pconfig.scope
+
def _do_nous_device_request():
- with httpx.Client(timeout=httpx.Timeout(15.0), headers={"Accept": "application/json"}) as client:
+ with httpx.Client(
+ timeout=httpx.Timeout(15.0), headers={"Accept": "application/json"}
+ ) as client:
return _request_device_code(
client=client,
portal_base_url=portal_base_url,
client_id=client_id,
scope=scope,
)
- device_data = await asyncio.get_event_loop().run_in_executor(None, _do_nous_device_request)
+
+ device_data = await asyncio.get_event_loop().run_in_executor(
+ None, _do_nous_device_request
+ )
sid, sess = _new_oauth_session("nous", "device_code")
sess["device_code"] = str(device_data["device_code"])
sess["interval"] = int(device_data["interval"])
@@ -1616,7 +1861,9 @@ async def _start_device_code_flow(provider_id: str) -> Dict[str, Any]:
# verification_url back via the session dict. The helper prints
# to stdout — we capture nothing here, just status.
threading.Thread(
- target=_codex_full_login_worker, args=(sid,), daemon=True,
+ target=_codex_full_login_worker,
+ args=(sid,),
+ daemon=True,
name=f"oauth-codex-{sid[:6]}",
).start()
# Block briefly until the worker has populated the user_code, OR error.
@@ -1630,9 +1877,14 @@ async def _start_device_code_flow(provider_id: str) -> Dict[str, Any]:
with _oauth_sessions_lock:
s = _oauth_sessions.get(sid, {})
if s.get("status") == "error":
- raise HTTPException(status_code=500, detail=s.get("error_message") or "device-auth failed")
+ raise HTTPException(
+ status_code=500, detail=s.get("error_message") or "device-auth failed"
+ )
if not s.get("user_code"):
- raise HTTPException(status_code=504, detail="device-auth timed out before returning a user code")
+ raise HTTPException(
+ status_code=504,
+ detail="device-auth timed out before returning a user code",
+ )
return {
"session_id": sid,
"flow": "device_code",
@@ -1642,7 +1894,10 @@ async def _start_device_code_flow(provider_id: str) -> Dict[str, Any]:
"poll_interval": int(s.get("interval") or 5),
}
- raise HTTPException(status_code=400, detail=f"Provider {provider_id} does not support device-code flow")
+ raise HTTPException(
+ status_code=400,
+ detail=f"Provider {provider_id} does not support device-code flow",
+ )
def _nous_poller(session_id: str) -> None:
@@ -1650,6 +1905,7 @@ def _nous_poller(session_id: str) -> None:
from hermes_cli.auth import _poll_for_token, refresh_nous_oauth_from_state
from datetime import datetime, timezone
import httpx
+
with _oauth_sessions_lock:
sess = _oauth_sessions.get(session_id)
if not sess:
@@ -1660,7 +1916,9 @@ def _nous_poller(session_id: str) -> None:
interval = sess["interval"]
expires_in = max(60, int(sess["expires_at"] - time.time()))
try:
- with httpx.Client(timeout=httpx.Timeout(15.0), headers={"Accept": "application/json"}) as client:
+ with httpx.Client(
+ timeout=httpx.Timeout(15.0), headers={"Accept": "application/json"}
+ ) as client:
token_data = _poll_for_token(
client=client,
portal_base_url=portal_base_url,
@@ -1682,16 +1940,23 @@ def _nous_poller(session_id: str) -> None:
"refresh_token": token_data.get("refresh_token"),
"obtained_at": now.isoformat(),
"expires_at": (
- datetime.fromtimestamp(now.timestamp() + token_ttl, tz=timezone.utc).isoformat()
- if token_ttl else None
+ datetime.fromtimestamp(
+ now.timestamp() + token_ttl, tz=timezone.utc
+ ).isoformat()
+ if token_ttl
+ else None
),
"expires_in": token_ttl,
}
full_state = refresh_nous_oauth_from_state(
- auth_state, min_key_ttl_seconds=300, timeout_seconds=15.0,
- force_refresh=False, force_mint=True,
+ auth_state,
+ min_key_ttl_seconds=300,
+ timeout_seconds=15.0,
+ force_refresh=False,
+ force_mint=True,
)
from hermes_cli.auth import persist_nous_credentials
+
persist_nous_credentials(full_state)
with _oauth_sessions_lock:
sess["status"] = "approved"
@@ -1725,6 +1990,7 @@ def _codex_full_login_worker(session_id: str) -> None:
CODEX_OAUTH_TOKEN_URL,
DEFAULT_CODEX_BASE_URL,
)
+
issuer = "https://auth.openai.com"
# Step 1: request device code
@@ -1741,7 +2007,9 @@ def _codex_full_login_worker(session_id: str) -> None:
device_auth_id = device_data.get("device_auth_id", "")
poll_interval = max(3, int(device_data.get("interval", "5")))
if not user_code or not device_auth_id:
- raise RuntimeError("device-code response missing user_code or device_auth_id")
+ raise RuntimeError(
+ "device-code response missing user_code or device_auth_id"
+ )
verification_url = f"{issuer}/codex/device"
with _oauth_sessions_lock:
sess = _oauth_sessions.get(session_id)
@@ -1782,7 +2050,9 @@ def _codex_full_login_worker(session_id: str) -> None:
authorization_code = code_resp.get("authorization_code", "")
code_verifier = code_resp.get("code_verifier", "")
if not authorization_code or not code_verifier:
- raise RuntimeError("device-auth response missing authorization_code/code_verifier")
+ raise RuntimeError(
+ "device-auth response missing authorization_code/code_verifier"
+ )
with httpx.Client(timeout=httpx.Timeout(15.0)) as client:
token_resp = client.post(
CODEX_OAUTH_TOKEN_URL,
@@ -1811,6 +2081,7 @@ def _codex_full_login_worker(session_id: str) -> None:
SOURCE_MANUAL,
)
import uuid as _uuid
+
pool = load_pool("openai-codex")
base_url = (
os.getenv("HERMES_CODEX_BASE_URL", "").strip().rstrip("/")
@@ -1878,9 +2149,14 @@ async def submit_oauth_code(provider_id: str, body: OAuthSubmitBody, request: Re
_require_token(request)
if provider_id == "anthropic":
return await asyncio.get_event_loop().run_in_executor(
- None, _submit_anthropic_pkce, body.session_id, body.code,
+ None,
+ _submit_anthropic_pkce,
+ body.session_id,
+ body.code,
)
- raise HTTPException(status_code=400, detail=f"submit not supported for {provider_id}")
+ raise HTTPException(
+ status_code=400, detail=f"submit not supported for {provider_id}"
+ )
@app.get("/api/providers/oauth/{provider_id}/poll/{session_id}")
@@ -1919,6 +2195,7 @@ async def cancel_oauth_session(session_id: str, request: Request):
@app.get("/api/sessions/{session_id}")
async def get_session_detail(session_id: str):
from hermes_state import SessionDB
+
db = SessionDB()
try:
sid = db.resolve_session_id(session_id)
@@ -1933,6 +2210,7 @@ async def get_session_detail(session_id: str):
@app.get("/api/sessions/{session_id}/messages")
async def get_session_messages(session_id: str):
from hermes_state import SessionDB
+
db = SessionDB()
try:
sid = db.resolve_session_id(session_id)
@@ -1947,6 +2225,7 @@ async def get_session_messages(session_id: str):
@app.delete("/api/sessions/{session_id}")
async def delete_session_endpoint(session_id: str):
from hermes_state import SessionDB
+
db = SessionDB()
try:
if not db.delete_session(session_id):
@@ -1993,14 +2272,15 @@ async def get_logs(
raise HTTPException(
status_code=400,
detail=f"Unknown component: {component}. "
- f"Available: {', '.join(sorted(COMPONENT_PREFIXES))}",
+ f"Available: {', '.join(sorted(COMPONENT_PREFIXES))}",
)
else:
comp_prefixes = None
has_filters = bool(min_level or comp_prefixes or search)
result = _read_tail(
- log_path, min(lines, 500) if not search else 2000,
+ log_path,
+ min(lines, 500) if not search else 2000,
has_filters=has_filters,
min_level=min_level,
component_prefixes=comp_prefixes,
@@ -2010,7 +2290,7 @@ async def get_logs(
# trim to the requested line count afterward.
if search:
needle = search.lower()
- result = [l for l in result if needle in l.lower()][-min(lines, 500):]
+ result = [l for l in result if needle in l.lower()][-min(lines, 500) :]
return {"file": file, "lines": result}
@@ -2033,12 +2313,14 @@ class CronJobUpdate(BaseModel):
@app.get("/api/cron/jobs")
async def list_cron_jobs():
from cron.jobs import list_jobs
+
return list_jobs(include_disabled=True)
@app.get("/api/cron/jobs/{job_id}")
async def get_cron_job(job_id: str):
from cron.jobs import get_job
+
job = get_job(job_id)
if not job:
raise HTTPException(status_code=404, detail="Job not found")
@@ -2048,9 +2330,14 @@ async def get_cron_job(job_id: str):
@app.post("/api/cron/jobs")
async def create_cron_job(body: CronJobCreate):
from cron.jobs import create_job
+
try:
- job = create_job(prompt=body.prompt, schedule=body.schedule,
- name=body.name, deliver=body.deliver)
+ job = create_job(
+ prompt=body.prompt,
+ schedule=body.schedule,
+ name=body.name,
+ deliver=body.deliver,
+ )
return job
except Exception as e:
_log.exception("POST /api/cron/jobs failed")
@@ -2060,6 +2347,7 @@ async def create_cron_job(body: CronJobCreate):
@app.put("/api/cron/jobs/{job_id}")
async def update_cron_job(job_id: str, body: CronJobUpdate):
from cron.jobs import update_job
+
job = update_job(job_id, body.updates)
if not job:
raise HTTPException(status_code=404, detail="Job not found")
@@ -2069,6 +2357,7 @@ async def update_cron_job(job_id: str, body: CronJobUpdate):
@app.post("/api/cron/jobs/{job_id}/pause")
async def pause_cron_job(job_id: str):
from cron.jobs import pause_job
+
job = pause_job(job_id)
if not job:
raise HTTPException(status_code=404, detail="Job not found")
@@ -2078,6 +2367,7 @@ async def pause_cron_job(job_id: str):
@app.post("/api/cron/jobs/{job_id}/resume")
async def resume_cron_job(job_id: str):
from cron.jobs import resume_job
+
job = resume_job(job_id)
if not job:
raise HTTPException(status_code=404, detail="Job not found")
@@ -2087,6 +2377,7 @@ async def resume_cron_job(job_id: str):
@app.post("/api/cron/jobs/{job_id}/trigger")
async def trigger_cron_job(job_id: str):
from cron.jobs import trigger_job
+
job = trigger_job(job_id)
if not job:
raise HTTPException(status_code=404, detail="Job not found")
@@ -2096,6 +2387,7 @@ async def trigger_cron_job(job_id: str):
@app.delete("/api/cron/jobs/{job_id}")
async def delete_cron_job(job_id: str):
from cron.jobs import remove_job
+
if not remove_job(job_id):
raise HTTPException(status_code=404, detail="Job not found")
return {"ok": True}
@@ -2115,6 +2407,7 @@ class SkillToggle(BaseModel):
async def get_skills():
from tools.skills_tool import _find_all_skills
from hermes_cli.skills_config import get_disabled_skills
+
config = load_config()
disabled = get_disabled_skills(config)
skills = _find_all_skills(skip_disabled=True)
@@ -2126,6 +2419,7 @@ async def get_skills():
@app.put("/api/skills/toggle")
async def toggle_skill(body: SkillToggle):
from hermes_cli.skills_config import get_disabled_skills, save_disabled_skills
+
config = load_config()
disabled = get_disabled_skills(config)
if body.enabled:
@@ -2158,13 +2452,17 @@ async def get_toolsets():
except Exception:
tools = []
is_enabled = name in enabled_toolsets
- result.append({
- "name": name, "label": label, "description": desc,
- "enabled": is_enabled,
- "available": is_enabled,
- "configured": _toolset_has_keys(name, config),
- "tools": tools,
- })
+ result.append(
+ {
+ "name": name,
+ "label": label,
+ "description": desc,
+ "enabled": is_enabled,
+ "available": is_enabled,
+ "configured": _toolset_has_keys(name, config),
+ "tools": tools,
+ }
+ )
return result
@@ -2210,7 +2508,8 @@ async def get_usage_analytics(days: int = 30):
db = SessionDB()
try:
cutoff = time.time() - (days * 86400)
- cur = db._conn.execute("""
+ cur = db._conn.execute(
+ """
SELECT date(started_at, 'unixepoch') as day,
SUM(input_tokens) as input_tokens,
SUM(output_tokens) as output_tokens,
@@ -2222,10 +2521,13 @@ async def get_usage_analytics(days: int = 30):
SUM(COALESCE(api_call_count, 0)) as api_calls
FROM sessions WHERE started_at > ?
GROUP BY day ORDER BY day
- """, (cutoff,))
+ """,
+ (cutoff,),
+ )
daily = [dict(r) for r in cur.fetchall()]
- cur2 = db._conn.execute("""
+ cur2 = db._conn.execute(
+ """
SELECT model,
SUM(input_tokens) as input_tokens,
SUM(output_tokens) as output_tokens,
@@ -2234,10 +2536,13 @@ async def get_usage_analytics(days: int = 30):
SUM(COALESCE(api_call_count, 0)) as api_calls
FROM sessions WHERE started_at > ? AND model IS NOT NULL
GROUP BY model ORDER BY SUM(input_tokens) + SUM(output_tokens) DESC
- """, (cutoff,))
+ """,
+ (cutoff,),
+ )
by_model = [dict(r) for r in cur2.fetchall()]
- cur3 = db._conn.execute("""
+ cur3 = db._conn.execute(
+ """
SELECT SUM(input_tokens) as total_input,
SUM(output_tokens) as total_output,
SUM(cache_read_tokens) as total_cache_read,
@@ -2247,18 +2552,23 @@ async def get_usage_analytics(days: int = 30):
COUNT(*) as total_sessions,
SUM(COALESCE(api_call_count, 0)) as total_api_calls
FROM sessions WHERE started_at > ?
- """, (cutoff,))
+ """,
+ (cutoff,),
+ )
totals = dict(cur3.fetchone())
insights_report = InsightsEngine(db).generate(days=days)
- skills = insights_report.get("skills", {
- "summary": {
- "total_skill_loads": 0,
- "total_skill_edits": 0,
- "total_skill_actions": 0,
- "distinct_skills_used": 0,
+ skills = insights_report.get(
+ "skills",
+ {
+ "summary": {
+ "total_skill_loads": 0,
+ "total_skill_edits": 0,
+ "total_skill_actions": 0,
+ "distinct_skills_used": 0,
+ },
+ "top_skills": [],
},
- "top_skills": [],
- })
+ )
return {
"daily": daily,
@@ -2349,7 +2659,11 @@ def _build_sidecar_url(channel: str) -> Optional[str]:
if not host or not port:
return None
- netloc = f"[{host}]:{port}" if ":" in host and not host.startswith("[") else f"{host}:{port}"
+ netloc = (
+ f"[{host}]:{port}"
+ if ":" in host and not host.startswith("[")
+ else f"{host}:{port}"
+ )
qs = urllib.parse.urlencode({"token": _SESSION_TOKEN, "channel": channel})
return f"ws://{netloc}/api/pub?{qs}"
@@ -2409,7 +2723,6 @@ async def pty_ws(ws: WebSocket) -> None:
await ws.close(code=1011)
return
-
try:
bridge = PtyBridge.spawn(argv, cwd=cwd, env=env)
except PtyUnavailableError as exc:
@@ -2602,12 +2915,14 @@ def mount_spa(application: FastAPI):
separate (unauthenticated) token-dispensing endpoint.
"""
if not WEB_DIST.exists():
+
@application.get("/{full_path:path}")
async def no_frontend(full_path: str):
return JSONResponse(
{"error": "Frontend not built. Run: cd web && npm run build"},
status_code=404,
)
+
return
_index_path = WEB_DIST / "index.html"
@@ -2616,9 +2931,11 @@ def mount_spa(application: FastAPI):
"""Return index.html with the session token injected."""
html = _index_path.read_text()
chat_js = "true" if _DASHBOARD_EMBEDDED_CHAT_ENABLED else "false"
+ gui_js = "true" if _DASHBOARD_GUI_MODE else "false"
token_script = (
f'"
+ f"window.__HERMES_DASHBOARD_EMBEDDED_CHAT__={chat_js};"
+ f"window.__HERMES_DASHBOARD_GUI__={gui_js};"
)
html = html.replace("", f"{token_script}", 1)
return HTMLResponse(
@@ -2626,7 +2943,9 @@ def mount_spa(application: FastAPI):
headers={"Cache-Control": "no-store, no-cache, must-revalidate"},
)
- application.mount("/assets", StaticFiles(directory=WEB_DIST / "assets"), name="assets")
+ application.mount(
+ "/assets", StaticFiles(directory=WEB_DIST / "assets"), name="assets"
+ )
@application.get("/{full_path:path}")
async def serve_spa(full_path: str):
@@ -2649,16 +2968,42 @@ def mount_spa(application: FastAPI):
# Built-in dashboard themes — label + description only. The actual color
# definitions live in the frontend (web/src/themes/presets.ts).
_BUILTIN_DASHBOARD_THEMES = [
- {"name": "default", "label": "Hermes Teal", "description": "Classic dark teal — the canonical Hermes look"},
- {"name": "midnight", "label": "Midnight", "description": "Deep blue-violet with cool accents"},
- {"name": "ember", "label": "Ember", "description": "Warm crimson and bronze — forge vibes"},
- {"name": "mono", "label": "Mono", "description": "Clean grayscale — minimal and focused"},
- {"name": "cyberpunk", "label": "Cyberpunk", "description": "Neon green on black — matrix terminal"},
- {"name": "rose", "label": "Rosé", "description": "Soft pink and warm ivory — easy on the eyes"},
+ {
+ "name": "default",
+ "label": "Hermes Teal",
+ "description": "Classic dark teal — the canonical Hermes look",
+ },
+ {
+ "name": "midnight",
+ "label": "Midnight",
+ "description": "Deep blue-violet with cool accents",
+ },
+ {
+ "name": "ember",
+ "label": "Ember",
+ "description": "Warm crimson and bronze — forge vibes",
+ },
+ {
+ "name": "mono",
+ "label": "Mono",
+ "description": "Clean grayscale — minimal and focused",
+ },
+ {
+ "name": "cyberpunk",
+ "label": "Cyberpunk",
+ "description": "Neon green on black — matrix terminal",
+ },
+ {
+ "name": "rose",
+ "label": "Rosé",
+ "description": "Soft pink and warm ivory — easy on the eyes",
+ },
]
-def _parse_theme_layer(value: Any, default_hex: str, default_alpha: float = 1.0) -> Optional[Dict[str, Any]]:
+def _parse_theme_layer(
+ value: Any, default_hex: str, default_alpha: float = 1.0
+) -> Optional[Dict[str, Any]]:
"""Normalise a theme layer spec from YAML into `{hex, alpha}` form.
Accepts shorthand (a bare hex string) or full dict form. Returns
@@ -2696,11 +3041,25 @@ _THEME_DEFAULT_LAYOUT: Dict[str, str] = {
}
_THEME_OVERRIDE_KEYS = {
- "card", "cardForeground", "popover", "popoverForeground",
- "primary", "primaryForeground", "secondary", "secondaryForeground",
- "muted", "mutedForeground", "accent", "accentForeground",
- "destructive", "destructiveForeground", "success", "warning",
- "border", "input", "ring",
+ "card",
+ "cardForeground",
+ "popover",
+ "popoverForeground",
+ "primary",
+ "primaryForeground",
+ "secondary",
+ "secondaryForeground",
+ "muted",
+ "mutedForeground",
+ "accent",
+ "accentForeground",
+ "destructive",
+ "destructiveForeground",
+ "success",
+ "warning",
+ "border",
+ "input",
+ "ring",
}
# Well-known named asset slots themes can populate. Any other keys under
@@ -2715,8 +3074,15 @@ _THEME_NAMED_ASSET_KEYS = {"bg", "hero", "logo", "crest", "sidebar", "header"}
# can restyle chrome (clip-path, border-image, segmented progress, etc.)
# without shipping their own CSS.
_THEME_COMPONENT_BUCKETS = {
- "card", "header", "footer", "sidebar", "tab",
- "progress", "badge", "backdrop", "page",
+ "card",
+ "header",
+ "footer",
+ "sidebar",
+ "tab",
+ "progress",
+ "badge",
+ "backdrop",
+ "page",
}
_THEME_LAYOUT_VARIANTS = {"standard", "cockpit", "tiled"}
@@ -2741,20 +3107,30 @@ def _normalise_theme_definition(data: Dict[str, Any]) -> Optional[Dict[str, Any]
return None
# Palette
- palette_src = data.get("palette", {}) if isinstance(data.get("palette"), dict) else {}
+ palette_src = (
+ data.get("palette", {}) if isinstance(data.get("palette"), dict) else {}
+ )
# Allow top-level `colors.background` as a shorthand too.
colors_src = data.get("colors", {}) if isinstance(data.get("colors"), dict) else {}
- def _layer(key: str, default_hex: str, default_alpha: float = 1.0) -> Dict[str, Any]:
+ def _layer(
+ key: str, default_hex: str, default_alpha: float = 1.0
+ ) -> Dict[str, Any]:
spec = palette_src.get(key, colors_src.get(key))
parsed = _parse_theme_layer(spec, default_hex, default_alpha)
- return parsed if parsed is not None else {"hex": default_hex, "alpha": default_alpha}
+ return (
+ parsed
+ if parsed is not None
+ else {"hex": default_hex, "alpha": default_alpha}
+ )
palette = {
"background": _layer("background", "#041c1c", 1.0),
"midground": _layer("midground", "#ffe6cb", 1.0),
"foreground": _layer("foreground", "#ffffff", 0.0),
- "warmGlow": palette_src.get("warmGlow") or data.get("warmGlow") or "rgba(255, 189, 56, 0.35)",
+ "warmGlow": palette_src.get("warmGlow")
+ or data.get("warmGlow")
+ or "rgba(255, 189, 56, 0.35)",
"noiseOpacity": 1.0,
}
raw_noise = palette_src.get("noiseOpacity", data.get("noiseOpacity"))
@@ -2764,9 +3140,19 @@ def _normalise_theme_definition(data: Dict[str, Any]) -> Optional[Dict[str, Any]
palette["noiseOpacity"] = 1.0
# Typography
- typo_src = data.get("typography", {}) if isinstance(data.get("typography"), dict) else {}
+ typo_src = (
+ data.get("typography", {}) if isinstance(data.get("typography"), dict) else {}
+ )
typography = dict(_THEME_DEFAULT_TYPOGRAPHY)
- for key in ("fontSans", "fontMono", "fontDisplay", "fontUrl", "baseSize", "lineHeight", "letterSpacing"):
+ for key in (
+ "fontSans",
+ "fontMono",
+ "fontDisplay",
+ "fontUrl",
+ "baseSize",
+ "lineHeight",
+ "letterSpacing",
+ ):
val = typo_src.get(key)
if isinstance(val, str) and val.strip():
typography[key] = val
@@ -2848,7 +3234,8 @@ def _normalise_theme_definition(data: Dict[str, Any]) -> Optional[Dict[str, Any]
layout_variant_src = data.get("layoutVariant")
layout_variant = (
layout_variant_src
- if isinstance(layout_variant_src, str) and layout_variant_src in _THEME_LAYOUT_VARIANTS
+ if isinstance(layout_variant_src, str)
+ and layout_variant_src in _THEME_LAYOUT_VARIANTS
else "standard"
)
@@ -2915,12 +3302,14 @@ async def get_dashboard_themes():
for t in user_themes:
if t["name"] in seen:
continue
- themes.append({
- "name": t["name"],
- "label": t["label"],
- "description": t["description"],
- "definition": t,
- })
+ themes.append(
+ {
+ "name": t["name"],
+ "label": t["label"],
+ "description": t["description"],
+ "definition": t,
+ }
+ )
seen.add(t["name"])
return {"themes": themes, "active": active}
@@ -2944,6 +3333,7 @@ async def set_dashboard_theme(body: ThemeSetBody):
# Dashboard plugin system
# ---------------------------------------------------------------------------
+
def _discover_dashboard_plugins() -> list:
"""Scan plugins/*/dashboard/manifest.json for dashboard extensions.
@@ -2982,7 +3372,9 @@ def _discover_dashboard_plugins() -> list:
# ``override`` to replace a built-in route, and ``hidden`` to
# register the plugin component/slots without adding a tab
# (useful for slot-only plugins like a header-crest injector).
- raw_tab = data.get("tab", {}) if isinstance(data.get("tab"), dict) else {}
+ raw_tab = (
+ data.get("tab", {}) if isinstance(data.get("tab"), dict) else {}
+ )
tab_info = {
"path": raw_tab.get("path", f"/{name}"),
"position": raw_tab.get("position", "end"),
@@ -2999,21 +3391,23 @@ def _discover_dashboard_plugins() -> list:
slots: List[str] = []
if isinstance(slots_src, list):
slots = [s for s in slots_src if isinstance(s, str) and s]
- plugins.append({
- "name": name,
- "label": data.get("label", name),
- "description": data.get("description", ""),
- "icon": data.get("icon", "Puzzle"),
- "version": data.get("version", "0.0.0"),
- "tab": tab_info,
- "slots": slots,
- "entry": data.get("entry", "dist/index.js"),
- "css": data.get("css"),
- "has_api": bool(data.get("api")),
- "source": source,
- "_dir": str(child / "dashboard"),
- "_api_file": data.get("api"),
- })
+ plugins.append(
+ {
+ "name": name,
+ "label": data.get("label", name),
+ "description": data.get("description", ""),
+ "icon": data.get("icon", "Puzzle"),
+ "version": data.get("version", "0.0.0"),
+ "tab": tab_info,
+ "slots": slots,
+ "entry": data.get("entry", "dist/index.js"),
+ "css": data.get("css"),
+ "has_api": bool(data.get("api")),
+ "source": source,
+ "_dir": str(child / "dashboard"),
+ "_api_file": data.get("api"),
+ }
+ )
except Exception as exc:
_log.warning("Bad dashboard plugin manifest %s: %s", manifest_file, exc)
continue
@@ -3036,10 +3430,7 @@ async def get_dashboard_plugins():
"""Return discovered dashboard plugins."""
plugins = _get_dashboard_plugins()
# Strip internal fields before sending to frontend.
- return [
- {k: v for k, v in p.items() if not k.startswith("_")}
- for p in plugins
- ]
+ return [{k: v for k, v in p.items() if not k.startswith("_")} for p in plugins]
@app.get("/api/dashboard/plugins/rescan")
@@ -3100,11 +3491,16 @@ def _mount_plugin_api_routes():
continue
api_path = Path(plugin["_dir"]) / api_file_name
if not api_path.exists():
- _log.warning("Plugin %s declares api=%s but file not found", plugin["name"], api_file_name)
+ _log.warning(
+ "Plugin %s declares api=%s but file not found",
+ plugin["name"],
+ api_file_name,
+ )
continue
try:
spec = importlib.util.spec_from_file_location(
- f"hermes_dashboard_plugin_{plugin['name']}", api_path,
+ f"hermes_dashboard_plugin_{plugin['name']}",
+ api_path,
)
if spec is None or spec.loader is None:
continue
@@ -3112,7 +3508,9 @@ def _mount_plugin_api_routes():
spec.loader.exec_module(mod)
router = getattr(mod, "router", None)
if router is None:
- _log.warning("Plugin %s api file has no 'router' attribute", plugin["name"])
+ _log.warning(
+ "Plugin %s api file has no 'router' attribute", plugin["name"]
+ )
continue
app.include_router(router, prefix=f"/api/plugins/{plugin['name']}")
_log.info("Mounted plugin API routes: /api/plugins/%s/", plugin["name"])
@@ -3133,12 +3531,14 @@ def start_server(
allow_public: bool = False,
*,
embedded_chat: bool = False,
+ gui_mode: bool = False,
):
"""Start the web UI server."""
import uvicorn
- global _DASHBOARD_EMBEDDED_CHAT_ENABLED
+ global _DASHBOARD_EMBEDDED_CHAT_ENABLED, _DASHBOARD_GUI_MODE
_DASHBOARD_EMBEDDED_CHAT_ENABLED = embedded_chat
+ _DASHBOARD_GUI_MODE = gui_mode
_LOCALHOST = ("127.0.0.1", "localhost", "::1")
if host not in _LOCALHOST and not allow_public:
@@ -3150,7 +3550,8 @@ def start_server(
if host not in _LOCALHOST:
_log.warning(
"Binding to %s with --insecure — the dashboard has no robust "
- "authentication. Only use on trusted networks.", host,
+ "authentication. Only use on trusted networks.",
+ host,
)
# Record the bound host so host_header_middleware can validate incoming
@@ -3161,11 +3562,11 @@ def start_server(
app.state.bound_port = port
if open_browser:
- import webbrowser
+ url = f"http://{host}:{port}"
def _open():
time.sleep(1.0)
- webbrowser.open(f"http://{host}:{port}")
+ _open_dashboard_url(url)
threading.Thread(target=_open, daemon=True).start()
diff --git a/tests/hermes_cli/test_web_server.py b/tests/hermes_cli/test_web_server.py
index e7b3b03305..19b9d379c1 100644
--- a/tests/hermes_cli/test_web_server.py
+++ b/tests/hermes_cli/test_web_server.py
@@ -112,7 +112,9 @@ class TestWebServerEndpoints:
from hermes_constants import get_hermes_home
from hermes_cli.web_server import app, _SESSION_HEADER_NAME, _SESSION_TOKEN
- monkeypatch.setattr(hermes_state, "DEFAULT_DB_PATH", get_hermes_home() / "state.db")
+ monkeypatch.setattr(
+ hermes_state, "DEFAULT_DB_PATH", get_hermes_home() / "state.db"
+ )
self.client = TestClient(app)
self.client.headers[_SESSION_HEADER_NAME] = _SESSION_TOKEN
@@ -124,6 +126,63 @@ class TestWebServerEndpoints:
assert "version" in data
assert "hermes_home" in data
assert "active_sessions" in data
+ assert "gui" in data
+ assert "embedded_chat" in data
+
+ def test_get_health(self):
+ resp = self.client.get("/api/health")
+ assert resp.status_code == 200
+ data = resp.json()
+ assert data["status"] == "ok"
+ assert data["mode"] in {"browser", "gui"}
+ assert "version" in data
+ assert "profile" in data
+
+ def test_get_runtime(self):
+ resp = self.client.get("/api/runtime")
+ assert resp.status_code == 200
+ data = resp.json()
+ assert data["status"] == "healthy"
+ assert "gui" in data
+ assert "dashboard" in data
+ assert "gateway" in data
+
+ def test_get_setup_state(self):
+ resp = self.client.get("/api/setup/state")
+ assert resp.status_code == 200
+ data = resp.json()
+ assert "needs_setup" in data
+ assert "checklist" in data
+ assert "provider" in data
+ assert "model" in data
+ assert "terminal" in data
+ assert "recommended_keys" in data["provider"]
+
+ def test_get_setup_state_ready_with_provider_and_model(self, monkeypatch):
+ import hermes_cli.web_server as ws
+
+ monkeypatch.setattr(
+ ws,
+ "load_env",
+ lambda: {"OPENROUTER_API_KEY": "sk-test-value"},
+ )
+ monkeypatch.setattr(
+ ws,
+ "load_config",
+ lambda: {
+ "model": "anthropic/claude-sonnet-4.6",
+ "terminal": {"backend": "local"},
+ },
+ )
+ monkeypatch.setattr("hermes_cli.auth.get_active_provider", lambda: None)
+
+ resp = self.client.get("/api/setup/state")
+ assert resp.status_code == 200
+ data = resp.json()
+ assert data["needs_setup"] is False
+ assert data["checklist"]["provider"] is True
+ assert data["checklist"]["model"] is True
+ assert data["checklist"]["terminal"] is True
def test_get_status_filters_unconfigured_gateway_platforms(self, monkeypatch):
import gateway.config as gateway_config
@@ -145,23 +204,39 @@ class TestWebServerEndpoints:
"gateway_state": "running",
"updated_at": "2026-04-12T00:00:00+00:00",
"platforms": {
- "telegram": {"state": "connected", "updated_at": "2026-04-12T00:00:00+00:00"},
- "whatsapp": {"state": "retrying", "updated_at": "2026-04-12T00:00:00+00:00"},
- "feishu": {"state": "connected", "updated_at": "2026-04-12T00:00:00+00:00"},
+ "telegram": {
+ "state": "connected",
+ "updated_at": "2026-04-12T00:00:00+00:00",
+ },
+ "whatsapp": {
+ "state": "retrying",
+ "updated_at": "2026-04-12T00:00:00+00:00",
+ },
+ "feishu": {
+ "state": "connected",
+ "updated_at": "2026-04-12T00:00:00+00:00",
+ },
},
},
)
monkeypatch.setattr(web_server, "check_config_version", lambda: (1, 1))
- monkeypatch.setattr(gateway_config, "load_gateway_config", lambda: _GatewayConfig())
+ monkeypatch.setattr(
+ gateway_config, "load_gateway_config", lambda: _GatewayConfig()
+ )
resp = self.client.get("/api/status")
assert resp.status_code == 200
assert resp.json()["gateway_platforms"] == {
- "telegram": {"state": "connected", "updated_at": "2026-04-12T00:00:00+00:00"},
+ "telegram": {
+ "state": "connected",
+ "updated_at": "2026-04-12T00:00:00+00:00",
+ },
}
- def test_get_status_hides_stale_platforms_when_gateway_not_running(self, monkeypatch):
+ def test_get_status_hides_stale_platforms_when_gateway_not_running(
+ self, monkeypatch
+ ):
import gateway.config as gateway_config
import hermes_cli.web_server as web_server
@@ -177,13 +252,21 @@ class TestWebServerEndpoints:
"gateway_state": "startup_failed",
"updated_at": "2026-04-12T00:00:00+00:00",
"platforms": {
- "whatsapp": {"state": "retrying", "updated_at": "2026-04-12T00:00:00+00:00"},
- "feishu": {"state": "connected", "updated_at": "2026-04-12T00:00:00+00:00"},
+ "whatsapp": {
+ "state": "retrying",
+ "updated_at": "2026-04-12T00:00:00+00:00",
+ },
+ "feishu": {
+ "state": "connected",
+ "updated_at": "2026-04-12T00:00:00+00:00",
+ },
},
},
)
monkeypatch.setattr(web_server, "check_config_version", lambda: (1, 1))
- monkeypatch.setattr(gateway_config, "load_gateway_config", lambda: _GatewayConfig())
+ monkeypatch.setattr(
+ gateway_config, "load_gateway_config", lambda: _GatewayConfig()
+ )
resp = self.client.get("/api/status")
@@ -222,6 +305,7 @@ class TestWebServerEndpoints:
"""POST /api/env/reveal should return the real unredacted value."""
from hermes_cli.config import save_env_value
from hermes_cli.web_server import _SESSION_HEADER_NAME, _SESSION_TOKEN
+
save_env_value("TEST_REVEAL_KEY", "super-secret-value-12345")
resp = self.client.post(
"/api/env/reveal",
@@ -236,6 +320,7 @@ class TestWebServerEndpoints:
def test_reveal_env_var_not_found(self):
"""POST /api/env/reveal should 404 for unknown keys."""
from hermes_cli.web_server import _SESSION_HEADER_NAME, _SESSION_TOKEN
+
resp = self.client.post(
"/api/env/reveal",
json={"key": "NONEXISTENT_KEY_XYZ"},
@@ -248,6 +333,7 @@ class TestWebServerEndpoints:
from starlette.testclient import TestClient
from hermes_cli.web_server import app
from hermes_cli.config import save_env_value
+
save_env_value("TEST_REVEAL_NOAUTH", "secret-value")
# Use a fresh client WITHOUT the dashboard session header
unauth_client = TestClient(app)
@@ -261,6 +347,7 @@ class TestWebServerEndpoints:
"""POST /api/env/reveal with wrong token should return 401."""
from hermes_cli.config import save_env_value
from hermes_cli.web_server import _SESSION_HEADER_NAME
+
save_env_value("TEST_REVEAL_BADAUTH", "secret-value")
resp = self.client.post(
"/api/env/reveal",
@@ -269,7 +356,9 @@ class TestWebServerEndpoints:
)
assert resp.status_code == 401
- def test_reveal_env_var_custom_session_header_ignores_proxy_authorization(self, tmp_path):
+ def test_reveal_env_var_custom_session_header_ignores_proxy_authorization(
+ self, tmp_path
+ ):
"""A valid dashboard session header should coexist with proxy auth."""
from hermes_cli.config import save_env_value
from hermes_cli.web_server import _SESSION_HEADER_NAME, _SESSION_TOKEN
@@ -318,6 +407,7 @@ class TestWebServerEndpoints:
"""API requests without the session token should be rejected."""
from starlette.testclient import TestClient
from hermes_cli.web_server import app
+
# Create a client WITHOUT the dashboard session header
unauth_client = TestClient(app)
resp = unauth_client.get("/api/env")
@@ -354,17 +444,20 @@ class TestWebServerEndpoints:
class TestBuildSchemaFromConfig:
def test_produces_expected_field_count(self):
from hermes_cli.web_server import CONFIG_SCHEMA
+
# DEFAULT_CONFIG has ~150+ leaf fields
assert len(CONFIG_SCHEMA) > 100
def test_schema_entries_have_required_fields(self):
from hermes_cli.web_server import CONFIG_SCHEMA
+
for key, entry in list(CONFIG_SCHEMA.items())[:10]:
assert "type" in entry, f"Missing type for {key}"
assert "category" in entry, f"Missing category for {key}"
def test_overrides_applied(self):
from hermes_cli.web_server import CONFIG_SCHEMA
+
# terminal.backend should be a select with options
if "terminal.backend" in CONFIG_SCHEMA:
entry = CONFIG_SCHEMA["terminal.backend"]
@@ -374,6 +467,7 @@ class TestBuildSchemaFromConfig:
def test_empty_prefix_produces_correct_keys(self):
from hermes_cli.web_server import _build_schema_from_config
+
test_config = {"model": "test", "nested": {"key": "val"}}
schema = _build_schema_from_config(test_config)
assert "model" in schema
@@ -382,17 +476,20 @@ class TestBuildSchemaFromConfig:
def test_top_level_scalars_get_general_category(self):
"""Top-level scalar fields should be in 'general' category."""
from hermes_cli.web_server import CONFIG_SCHEMA
+
assert CONFIG_SCHEMA["model"]["category"] == "general"
def test_nested_keys_get_parent_category(self):
"""Nested fields should use the top-level parent as their category."""
from hermes_cli.web_server import CONFIG_SCHEMA
+
if "agent.max_turns" in CONFIG_SCHEMA:
assert CONFIG_SCHEMA["agent.max_turns"]["category"] == "agent"
def test_category_merge_applied(self):
"""Small categories should be merged into larger ones."""
from hermes_cli.web_server import CONFIG_SCHEMA
+
categories = {e["category"] for e in CONFIG_SCHEMA.values()}
# These should be merged away
assert "privacy" not in categories # merged into security
@@ -402,9 +499,12 @@ class TestBuildSchemaFromConfig:
"""After merging, no category should have just 1 field."""
from hermes_cli.web_server import CONFIG_SCHEMA
from collections import Counter
+
cats = Counter(e["category"] for e in CONFIG_SCHEMA.values())
for cat, count in cats.items():
- assert count >= 2, f"Category '{cat}' has only {count} field(s) — should be merged"
+ assert (
+ count >= 2
+ ), f"Category '{cat}' has only {count} field(s) — should be merged"
# ---------------------------------------------------------------------------
@@ -422,6 +522,7 @@ class TestConfigRoundTrip:
except ImportError:
pytest.skip("fastapi/starlette not installed")
from hermes_cli.web_server import app, _SESSION_HEADER_NAME, _SESSION_TOKEN
+
self.client = TestClient(app)
self.client.headers[_SESSION_HEADER_NAME] = _SESSION_TOKEN
@@ -434,22 +535,25 @@ class TestConfigRoundTrip:
def test_get_config_model_is_string(self):
"""GET /api/config should normalize model dict to a string."""
config = self.client.get("/api/config").json()
- assert isinstance(config.get("model"), str), \
- f"model should be string, got {type(config.get('model'))}"
+ assert isinstance(
+ config.get("model"), str
+ ), f"model should be string, got {type(config.get('model'))}"
def test_round_trip_preserves_model_subkeys(self):
"""Save and reload should not lose model.provider, model.base_url, etc."""
from hermes_cli.config import load_config, save_config
# Set up a config with model as a dict (the common user config form)
- save_config({
- "model": {
- "default": "anthropic/claude-sonnet-4",
- "provider": "openrouter",
- "base_url": "https://openrouter.ai/api/v1",
- "api_mode": "openai",
+ save_config(
+ {
+ "model": {
+ "default": "anthropic/claude-sonnet-4",
+ "provider": "openrouter",
+ "base_url": "https://openrouter.ai/api/v1",
+ "api_mode": "openai",
+ }
}
- })
+ )
before = load_config()
assert isinstance(before.get("model"), dict)
@@ -457,14 +561,19 @@ class TestConfigRoundTrip:
# GET → PUT unchanged
web_config = self.client.get("/api/config").json()
- assert isinstance(web_config.get("model"), str), "GET should normalize model to string"
+ assert isinstance(
+ web_config.get("model"), str
+ ), "GET should normalize model to string"
self.client.put("/api/config", json={"config": web_config})
after = load_config()
- assert isinstance(after.get("model"), dict), "model should still be a dict after save"
- assert set(after["model"].keys()) >= original_keys, \
- f"Lost model subkeys: {original_keys - set(after['model'].keys())}"
+ assert isinstance(
+ after.get("model"), dict
+ ), "model should still be a dict after save"
+ assert (
+ set(after["model"].keys()) >= original_keys
+ ), f"Lost model subkeys: {original_keys - set(after['model'].keys())}"
def test_edit_model_name_preserved(self):
"""Changing the model string should update model.default on disk."""
@@ -559,7 +668,9 @@ class TestNewEndpoints:
from hermes_constants import get_hermes_home
from hermes_cli.web_server import app, _SESSION_HEADER_NAME, _SESSION_TOKEN
- monkeypatch.setattr(hermes_state, "DEFAULT_DB_PATH", get_hermes_home() / "state.db")
+ monkeypatch.setattr(
+ hermes_state, "DEFAULT_DB_PATH", get_hermes_home() / "state.db"
+ )
self.client = TestClient(app)
self.client.headers[_SESSION_HEADER_NAME] = _SESSION_TOKEN
@@ -602,16 +713,30 @@ class TestNewEndpoints:
def _fake_find_all_skills(*, skip_disabled=False):
if skip_disabled:
return [
- {"name": "active-skill", "description": "active", "category": "demo"},
- {"name": "disabled-skill", "description": "disabled", "category": "demo"},
+ {
+ "name": "active-skill",
+ "description": "active",
+ "category": "demo",
+ },
+ {
+ "name": "disabled-skill",
+ "description": "disabled",
+ "category": "demo",
+ },
]
return [
{"name": "active-skill", "description": "active", "category": "demo"},
]
monkeypatch.setattr(skills_tool, "_find_all_skills", _fake_find_all_skills)
- monkeypatch.setattr(skills_config, "get_disabled_skills", lambda config: {"disabled-skill"})
- monkeypatch.setattr(web_server, "load_config", lambda: {"skills": {"disabled": ["disabled-skill"]}})
+ monkeypatch.setattr(
+ skills_config, "get_disabled_skills", lambda config: {"disabled-skill"}
+ )
+ monkeypatch.setattr(
+ web_server,
+ "load_config",
+ lambda: {"skills": {"disabled": ["disabled-skill"]}},
+ )
resp = self.client.get("/api/skills")
@@ -658,7 +783,10 @@ class TestNewEndpoints:
monkeypatch.setattr(
tools_config,
"_get_platform_tools",
- lambda config, platform, include_default_mcp_servers=False: {"web", "skills"},
+ lambda config, platform, include_default_mcp_servers=False: {
+ "web",
+ "skills",
+ },
)
monkeypatch.setattr(
tools_config,
@@ -674,7 +802,11 @@ class TestNewEndpoints:
"memory": ["memory_read"],
}[name],
)
- monkeypatch.setattr(web_server, "load_config", lambda: {"platform_toolsets": {"cli": ["web", "skills"]}})
+ monkeypatch.setattr(
+ web_server,
+ "load_config",
+ lambda: {"platform_toolsets": {"cli": ["web", "skills"]}},
+ )
resp = self.client.get("/api/tools/toolsets")
@@ -871,14 +1003,21 @@ class TestModelContextLength:
from hermes_cli.config import save_config
# Set up disk config with model as a dict
- save_config({
- "model": {"default": "anthropic/claude-opus-4.6", "provider": "openrouter"}
- })
+ save_config(
+ {
+ "model": {
+ "default": "anthropic/claude-opus-4.6",
+ "provider": "openrouter",
+ }
+ }
+ )
- result = _denormalize_config_from_web({
- "model": "anthropic/claude-opus-4.6",
- "model_context_length": 100000,
- })
+ result = _denormalize_config_from_web(
+ {
+ "model": "anthropic/claude-opus-4.6",
+ "model_context_length": 100000,
+ }
+ )
assert isinstance(result["model"], dict)
assert result["model"]["context_length"] == 100000
assert "model_context_length" not in result # virtual field removed
@@ -888,18 +1027,22 @@ class TestModelContextLength:
from hermes_cli.web_server import _denormalize_config_from_web
from hermes_cli.config import save_config
- save_config({
- "model": {
- "default": "anthropic/claude-opus-4.6",
- "provider": "openrouter",
- "context_length": 50000,
+ save_config(
+ {
+ "model": {
+ "default": "anthropic/claude-opus-4.6",
+ "provider": "openrouter",
+ "context_length": 50000,
+ }
}
- })
+ )
- result = _denormalize_config_from_web({
- "model": "anthropic/claude-opus-4.6",
- "model_context_length": 0,
- })
+ result = _denormalize_config_from_web(
+ {
+ "model": "anthropic/claude-opus-4.6",
+ "model_context_length": 0,
+ }
+ )
assert isinstance(result["model"], dict)
assert "context_length" not in result["model"]
@@ -911,10 +1054,12 @@ class TestModelContextLength:
# Disk has model as bare string
save_config({"model": "anthropic/claude-sonnet-4"})
- result = _denormalize_config_from_web({
- "model": "anthropic/claude-sonnet-4",
- "model_context_length": 65000,
- })
+ result = _denormalize_config_from_web(
+ {
+ "model": "anthropic/claude-sonnet-4",
+ "model_context_length": 65000,
+ }
+ )
assert isinstance(result["model"], dict)
assert result["model"]["default"] == "anthropic/claude-sonnet-4"
assert result["model"]["context_length"] == 65000
@@ -926,10 +1071,12 @@ class TestModelContextLength:
save_config({"model": "anthropic/claude-sonnet-4"})
- result = _denormalize_config_from_web({
- "model": "anthropic/claude-sonnet-4",
- "model_context_length": 0,
- })
+ result = _denormalize_config_from_web(
+ {
+ "model": "anthropic/claude-sonnet-4",
+ "model_context_length": 0,
+ }
+ )
assert result["model"] == "anthropic/claude-sonnet-4"
def test_denormalize_coerces_string_context_length(self):
@@ -937,14 +1084,14 @@ class TestModelContextLength:
from hermes_cli.web_server import _denormalize_config_from_web
from hermes_cli.config import save_config
- save_config({
- "model": {"default": "test/model", "provider": "openrouter"}
- })
+ save_config({"model": {"default": "test/model", "provider": "openrouter"}})
- result = _denormalize_config_from_web({
- "model": "test/model",
- "model_context_length": "32000",
- })
+ result = _denormalize_config_from_web(
+ {
+ "model": "test/model",
+ "model_context_length": "32000",
+ }
+ )
assert isinstance(result["model"], dict)
assert result["model"]["context_length"] == 32000
@@ -954,17 +1101,20 @@ class TestModelContextLengthSchema:
def test_schema_has_model_context_length(self):
from hermes_cli.web_server import CONFIG_SCHEMA
+
assert "model_context_length" in CONFIG_SCHEMA
def test_schema_model_context_length_after_model(self):
"""model_context_length should appear immediately after model in schema."""
from hermes_cli.web_server import CONFIG_SCHEMA
+
keys = list(CONFIG_SCHEMA.keys())
model_idx = keys.index("model")
assert keys[model_idx + 1] == "model_context_length"
def test_schema_model_context_length_is_number(self):
from hermes_cli.web_server import CONFIG_SCHEMA
+
entry = CONFIG_SCHEMA["model_context_length"]
assert entry["type"] == "number"
assert "category" in entry
@@ -980,6 +1130,7 @@ class TestModelInfoEndpoint:
except ImportError:
pytest.skip("fastapi/starlette not installed")
from hermes_cli.web_server import app
+
self.client = TestClient(app)
def test_model_info_returns_200(self):
@@ -996,15 +1147,21 @@ class TestModelInfoEndpoint:
def test_model_info_with_dict_config(self, monkeypatch):
import hermes_cli.web_server as ws
- monkeypatch.setattr(ws, "load_config", lambda: {
- "model": {
- "default": "anthropic/claude-opus-4.6",
- "provider": "openrouter",
- "context_length": 100000,
- }
- })
+ monkeypatch.setattr(
+ ws,
+ "load_config",
+ lambda: {
+ "model": {
+ "default": "anthropic/claude-opus-4.6",
+ "provider": "openrouter",
+ "context_length": 100000,
+ }
+ },
+ )
- with patch("agent.model_metadata.get_model_context_length", return_value=200000):
+ with patch(
+ "agent.model_metadata.get_model_context_length", return_value=200000
+ ):
resp = self.client.get("/api/model/info")
data = resp.json()
@@ -1017,11 +1174,20 @@ class TestModelInfoEndpoint:
def test_model_info_auto_detect_when_no_override(self, monkeypatch):
import hermes_cli.web_server as ws
- monkeypatch.setattr(ws, "load_config", lambda: {
- "model": {"default": "anthropic/claude-opus-4.6", "provider": "openrouter"}
- })
+ monkeypatch.setattr(
+ ws,
+ "load_config",
+ lambda: {
+ "model": {
+ "default": "anthropic/claude-opus-4.6",
+ "provider": "openrouter",
+ }
+ },
+ )
- with patch("agent.model_metadata.get_model_context_length", return_value=200000):
+ with patch(
+ "agent.model_metadata.get_model_context_length", return_value=200000
+ ):
resp = self.client.get("/api/model/info")
data = resp.json()
@@ -1042,11 +1208,13 @@ class TestModelInfoEndpoint:
def test_model_info_bare_string_model(self, monkeypatch):
import hermes_cli.web_server as ws
- monkeypatch.setattr(ws, "load_config", lambda: {
- "model": "anthropic/claude-sonnet-4"
- })
+ monkeypatch.setattr(
+ ws, "load_config", lambda: {"model": "anthropic/claude-sonnet-4"}
+ )
- with patch("agent.model_metadata.get_model_context_length", return_value=200000):
+ with patch(
+ "agent.model_metadata.get_model_context_length", return_value=200000
+ ):
resp = self.client.get("/api/model/info")
data = resp.json()
@@ -1058,9 +1226,16 @@ class TestModelInfoEndpoint:
def test_model_info_capabilities(self, monkeypatch):
import hermes_cli.web_server as ws
- monkeypatch.setattr(ws, "load_config", lambda: {
- "model": {"default": "anthropic/claude-opus-4.6", "provider": "openrouter"}
- })
+ monkeypatch.setattr(
+ ws,
+ "load_config",
+ lambda: {
+ "model": {
+ "default": "anthropic/claude-opus-4.6",
+ "provider": "openrouter",
+ }
+ },
+ )
mock_caps = MagicMock()
mock_caps.supports_tools = True
@@ -1070,8 +1245,10 @@ class TestModelInfoEndpoint:
mock_caps.max_output_tokens = 32000
mock_caps.model_family = "claude-opus"
- with patch("agent.model_metadata.get_model_context_length", return_value=200000), \
- patch("agent.models_dev.get_model_capabilities", return_value=mock_caps):
+ with (
+ patch("agent.model_metadata.get_model_context_length", return_value=200000),
+ patch("agent.models_dev.get_model_capabilities", return_value=mock_caps),
+ ):
resp = self.client.get("/api/model/info")
caps = resp.json()["capabilities"]
@@ -1085,11 +1262,12 @@ class TestModelInfoEndpoint:
"""Endpoint should return zeros on import/resolution errors, not 500."""
import hermes_cli.web_server as ws
- monkeypatch.setattr(ws, "load_config", lambda: {
- "model": "some/obscure-model"
- })
+ monkeypatch.setattr(ws, "load_config", lambda: {"model": "some/obscure-model"})
- with patch("agent.model_metadata.get_model_context_length", side_effect=Exception("boom")):
+ with patch(
+ "agent.model_metadata.get_model_context_length",
+ side_effect=Exception("boom"),
+ ):
resp = self.client.get("/api/model/info")
assert resp.status_code == 200
@@ -1108,6 +1286,7 @@ class TestProbeGatewayHealth:
def test_returns_false_when_no_url_configured(self, monkeypatch):
"""When GATEWAY_HEALTH_URL is unset, the probe returns (False, None)."""
import hermes_cli.web_server as ws
+
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", None)
alive, body = ws._probe_gateway_health()
assert alive is False
@@ -1116,6 +1295,7 @@ class TestProbeGatewayHealth:
def test_normalizes_url_with_health_suffix(self, monkeypatch):
"""If the user sets the URL to include /health, it's stripped to base."""
import hermes_cli.web_server as ws
+
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", "http://gw:8642/health")
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_TIMEOUT", 1)
# Both paths should fail (no server), but we verify they were constructed
@@ -1136,6 +1316,7 @@ class TestProbeGatewayHealth:
def test_normalizes_url_with_health_detailed_suffix(self, monkeypatch):
"""If the user sets the URL to include /health/detailed, it's stripped to base."""
import hermes_cli.web_server as ws
+
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", "http://gw:8642/health/detailed")
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_TIMEOUT", 1)
calls = []
@@ -1152,14 +1333,17 @@ class TestProbeGatewayHealth:
def test_successful_detailed_probe(self, monkeypatch):
"""Successful /health/detailed probe returns (True, body_dict)."""
import hermes_cli.web_server as ws
+
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", "http://gw:8642")
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_TIMEOUT", 1)
- response_body = json.dumps({
- "status": "ok",
- "gateway_state": "running",
- "pid": 42,
- })
+ response_body = json.dumps(
+ {
+ "status": "ok",
+ "gateway_state": "running",
+ "pid": 42,
+ }
+ )
mock_resp = MagicMock()
mock_resp.status = 200
@@ -1176,6 +1360,7 @@ class TestProbeGatewayHealth:
def test_detailed_fails_falls_back_to_simple_health(self, monkeypatch):
"""If /health/detailed fails, falls back to /health."""
import hermes_cli.web_server as ws
+
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", "http://gw:8642")
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_TIMEOUT", 1)
@@ -1210,6 +1395,7 @@ class TestStatusRemoteGateway:
pytest.skip("fastapi/starlette not installed")
from hermes_cli.web_server import app, _SESSION_HEADER_NAME, _SESSION_TOKEN
+
self.client = TestClient(app)
self.client.headers[_SESSION_HEADER_NAME] = _SESSION_TOKEN
@@ -1220,12 +1406,19 @@ class TestStatusRemoteGateway:
monkeypatch.setattr(ws, "get_running_pid", lambda: None)
monkeypatch.setattr(ws, "read_runtime_status", lambda: None)
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", "http://gw:8642")
- monkeypatch.setattr(ws, "_probe_gateway_health", lambda: (True, {
- "status": "ok",
- "gateway_state": "running",
- "platforms": {"telegram": {"state": "connected"}},
- "pid": 999,
- }))
+ monkeypatch.setattr(
+ ws,
+ "_probe_gateway_health",
+ lambda: (
+ True,
+ {
+ "status": "ok",
+ "gateway_state": "running",
+ "platforms": {"telegram": {"state": "connected"}},
+ "pid": 999,
+ },
+ ),
+ )
resp = self.client.get("/api/status")
assert resp.status_code == 200
@@ -1240,10 +1433,14 @@ class TestStatusRemoteGateway:
import hermes_cli.web_server as ws
monkeypatch.setattr(ws, "get_running_pid", lambda: 1234)
- monkeypatch.setattr(ws, "read_runtime_status", lambda: {
- "gateway_state": "running",
- "platforms": {},
- })
+ monkeypatch.setattr(
+ ws,
+ "read_runtime_status",
+ lambda: {
+ "gateway_state": "running",
+ "platforms": {},
+ },
+ )
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", "http://gw:8642")
probe_called = [False]
original = ws._probe_gateway_health
@@ -1279,9 +1476,16 @@ class TestStatusRemoteGateway:
monkeypatch.setattr(ws, "get_running_pid", lambda: None)
monkeypatch.setattr(ws, "read_runtime_status", lambda: None)
monkeypatch.setattr(ws, "_GATEWAY_HEALTH_URL", "http://gw:8642")
- monkeypatch.setattr(ws, "_probe_gateway_health", lambda: (True, {
- "status": "ok",
- }))
+ monkeypatch.setattr(
+ ws,
+ "_probe_gateway_health",
+ lambda: (
+ True,
+ {
+ "status": "ok",
+ },
+ ),
+ )
resp = self.client.get("/api/status")
assert resp.status_code == 200
@@ -1301,12 +1505,14 @@ class TestNormaliseThemeDefinition:
def test_rejects_missing_name(self):
from hermes_cli.web_server import _normalise_theme_definition
+
assert _normalise_theme_definition({}) is None
assert _normalise_theme_definition({"name": ""}) is None
assert _normalise_theme_definition({"name": " "}) is None
def test_rejects_non_dict(self):
from hermes_cli.web_server import _normalise_theme_definition
+
assert _normalise_theme_definition("string") is None
assert _normalise_theme_definition(None) is None
assert _normalise_theme_definition([1, 2, 3]) is None
@@ -1314,10 +1520,13 @@ class TestNormaliseThemeDefinition:
def test_loose_colors_shorthand(self):
"""Bare hex strings under `colors` parse as {hex, alpha=1.0}."""
from hermes_cli.web_server import _normalise_theme_definition
- result = _normalise_theme_definition({
- "name": "loose",
- "colors": {"background": "#000000", "midground": "#ffffff"},
- })
+
+ result = _normalise_theme_definition(
+ {
+ "name": "loose",
+ "colors": {"background": "#000000", "midground": "#ffffff"},
+ }
+ )
assert result is not None
assert result["palette"]["background"] == {"hex": "#000000", "alpha": 1.0}
assert result["palette"]["midground"] == {"hex": "#ffffff", "alpha": 1.0}
@@ -1327,15 +1536,18 @@ class TestNormaliseThemeDefinition:
def test_full_palette_form(self):
from hermes_cli.web_server import _normalise_theme_definition
- result = _normalise_theme_definition({
- "name": "full",
- "palette": {
- "background": {"hex": "#0a1628", "alpha": 1.0},
- "midground": {"hex": "#a8d0ff", "alpha": 0.9},
- "warmGlow": "rgba(255, 0, 0, 0.5)",
- "noiseOpacity": 0.5,
- },
- })
+
+ result = _normalise_theme_definition(
+ {
+ "name": "full",
+ "palette": {
+ "background": {"hex": "#0a1628", "alpha": 1.0},
+ "midground": {"hex": "#a8d0ff", "alpha": 0.9},
+ "warmGlow": "rgba(255, 0, 0, 0.5)",
+ "noiseOpacity": 0.5,
+ },
+ }
+ )
assert result["palette"]["background"]["hex"] == "#0a1628"
assert result["palette"]["midground"]["alpha"] == 0.9
assert result["palette"]["warmGlow"] == "rgba(255, 0, 0, 0.5)"
@@ -1343,6 +1555,7 @@ class TestNormaliseThemeDefinition:
def test_default_typography_applied_when_missing(self):
from hermes_cli.web_server import _normalise_theme_definition
+
result = _normalise_theme_definition({"name": "minimal"})
typo = result["typography"]
assert "fontSans" in typo
@@ -1353,13 +1566,16 @@ class TestNormaliseThemeDefinition:
def test_partial_typography_merges_with_defaults(self):
from hermes_cli.web_server import _normalise_theme_definition
- result = _normalise_theme_definition({
- "name": "partial",
- "typography": {
- "fontSans": "MyFont, sans-serif",
- "baseSize": "12px",
- },
- })
+
+ result = _normalise_theme_definition(
+ {
+ "name": "partial",
+ "typography": {
+ "fontSans": "MyFont, sans-serif",
+ "baseSize": "12px",
+ },
+ }
+ )
assert result["typography"]["fontSans"] == "MyFont, sans-serif"
assert result["typography"]["baseSize"] == "12px"
# fontMono defaulted
@@ -1367,35 +1583,43 @@ class TestNormaliseThemeDefinition:
def test_layout_defaults(self):
from hermes_cli.web_server import _normalise_theme_definition
+
result = _normalise_theme_definition({"name": "minimal"})
assert result["layout"]["radius"] == "0.5rem"
assert result["layout"]["density"] == "comfortable"
def test_invalid_density_falls_back(self):
from hermes_cli.web_server import _normalise_theme_definition
- result = _normalise_theme_definition({
- "name": "bad",
- "layout": {"density": "ultra-spacious"},
- })
+
+ result = _normalise_theme_definition(
+ {
+ "name": "bad",
+ "layout": {"density": "ultra-spacious"},
+ }
+ )
assert result["layout"]["density"] == "comfortable"
def test_valid_densities_accepted(self):
from hermes_cli.web_server import _normalise_theme_definition
+
for d in ("compact", "comfortable", "spacious"):
r = _normalise_theme_definition({"name": "x", "layout": {"density": d}})
assert r["layout"]["density"] == d
def test_color_overrides_filter_unknown_keys(self):
from hermes_cli.web_server import _normalise_theme_definition
- result = _normalise_theme_definition({
- "name": "o",
- "colorOverrides": {
- "card": "#123456",
- "fakeToken": "#abcdef",
- "primary": 42, # non-string rejected
- "destructive": "#ff0000",
- },
- })
+
+ result = _normalise_theme_definition(
+ {
+ "name": "o",
+ "colorOverrides": {
+ "card": "#123456",
+ "fakeToken": "#abcdef",
+ "primary": 42, # non-string rejected
+ "destructive": "#ff0000",
+ },
+ }
+ )
assert result["colorOverrides"] == {
"card": "#123456",
"destructive": "#ff0000",
@@ -1403,28 +1627,37 @@ class TestNormaliseThemeDefinition:
def test_color_overrides_omitted_when_empty(self):
from hermes_cli.web_server import _normalise_theme_definition
+
result = _normalise_theme_definition({"name": "x"})
assert "colorOverrides" not in result
def test_alpha_clamped_to_unit_range(self):
from hermes_cli.web_server import _normalise_theme_definition
- r = _normalise_theme_definition({
- "name": "c",
- "palette": {"background": {"hex": "#000", "alpha": 99.5}},
- })
+
+ r = _normalise_theme_definition(
+ {
+ "name": "c",
+ "palette": {"background": {"hex": "#000", "alpha": 99.5}},
+ }
+ )
assert r["palette"]["background"]["alpha"] == 1.0
- r2 = _normalise_theme_definition({
- "name": "c",
- "palette": {"background": {"hex": "#000", "alpha": -5}},
- })
+ r2 = _normalise_theme_definition(
+ {
+ "name": "c",
+ "palette": {"background": {"hex": "#000", "alpha": -5}},
+ }
+ )
assert r2["palette"]["background"]["alpha"] == 0.0
def test_invalid_alpha_uses_default(self):
from hermes_cli.web_server import _normalise_theme_definition
- r = _normalise_theme_definition({
- "name": "c",
- "palette": {"background": {"hex": "#000", "alpha": "not a number"}},
- })
+
+ r = _normalise_theme_definition(
+ {
+ "name": "c",
+ "palette": {"background": {"hex": "#000", "alpha": "not a number"}},
+ }
+ )
assert r["palette"]["background"]["alpha"] == 1.0
@@ -1434,6 +1667,7 @@ class TestDiscoverUserThemes:
def test_returns_empty_when_dir_missing(self, tmp_path, monkeypatch):
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
from hermes_cli import web_server
+
assert web_server._discover_user_themes() == []
def test_loads_and_normalises_yaml(self, tmp_path, monkeypatch):
@@ -1445,12 +1679,13 @@ class TestDiscoverUserThemes:
"label: Ocean\n"
"palette:\n"
" background:\n"
- " hex: \"#0a1628\"\n"
+ ' hex: "#0a1628"\n'
" alpha: 1.0\n"
"layout:\n"
" density: spacious\n"
)
from hermes_cli import web_server
+
results = web_server._discover_user_themes()
assert len(results) == 1
assert results[0]["name"] == "ocean"
@@ -1468,6 +1703,7 @@ class TestDiscoverUserThemes:
(themes_dir / "nameless.yaml").write_text("label: No Name Here\n")
(themes_dir / "ok.yaml").write_text("name: ok\n")
from hermes_cli import web_server
+
results = web_server._discover_user_themes()
names = [r["name"] for r in results]
assert "ok" in names
@@ -1482,17 +1718,20 @@ class TestNormaliseThemeExtensions:
def test_layout_variant_defaults_to_standard(self):
from hermes_cli.web_server import _normalise_theme_definition
+
result = _normalise_theme_definition({"name": "t"})
assert result["layoutVariant"] == "standard"
def test_layout_variant_accepts_known_values(self):
from hermes_cli.web_server import _normalise_theme_definition
+
for variant in ("standard", "cockpit", "tiled"):
r = _normalise_theme_definition({"name": "t", "layoutVariant": variant})
assert r["layoutVariant"] == variant
def test_layout_variant_rejects_unknown(self):
from hermes_cli.web_server import _normalise_theme_definition
+
r = _normalise_theme_definition({"name": "t", "layoutVariant": "warship"})
assert r["layoutVariant"] == "standard"
r2 = _normalise_theme_definition({"name": "t", "layoutVariant": 12})
@@ -1500,16 +1739,19 @@ class TestNormaliseThemeExtensions:
def test_assets_named_slots_passthrough(self):
from hermes_cli.web_server import _normalise_theme_definition
- r = _normalise_theme_definition({
- "name": "t",
- "assets": {
- "bg": "https://example.com/bg.jpg",
- "hero": "linear-gradient(180deg, red, blue)",
- "crest": "/ds-assets/crest.svg",
- "logo": " ", # whitespace-only — dropped
- "notAKnownKey": "ignored",
- },
- })
+
+ r = _normalise_theme_definition(
+ {
+ "name": "t",
+ "assets": {
+ "bg": "https://example.com/bg.jpg",
+ "hero": "linear-gradient(180deg, red, blue)",
+ "crest": "/ds-assets/crest.svg",
+ "logo": " ", # whitespace-only — dropped
+ "notAKnownKey": "ignored",
+ },
+ }
+ )
assert r["assets"]["bg"] == "https://example.com/bg.jpg"
assert r["assets"]["hero"].startswith("linear-gradient")
assert r["assets"]["crest"] == "/ds-assets/crest.svg"
@@ -1518,17 +1760,20 @@ class TestNormaliseThemeExtensions:
def test_assets_custom_block(self):
from hermes_cli.web_server import _normalise_theme_definition
- r = _normalise_theme_definition({
- "name": "t",
- "assets": {
- "custom": {
- "scan-lines": "/img/scan.png",
- "my_overlay": "/img/ov.png",
- "bad key!": "x", # non-alnum key — rejected
- "empty": "", # empty value — rejected
+
+ r = _normalise_theme_definition(
+ {
+ "name": "t",
+ "assets": {
+ "custom": {
+ "scan-lines": "/img/scan.png",
+ "my_overlay": "/img/ov.png",
+ "bad key!": "x", # non-alnum key — rejected
+ "empty": "", # empty value — rejected
+ },
},
- },
- })
+ }
+ )
assert r["assets"]["custom"] == {
"scan-lines": "/img/scan.png",
"my_overlay": "/img/ov.png",
@@ -1536,16 +1781,20 @@ class TestNormaliseThemeExtensions:
def test_assets_absent_means_no_field(self):
from hermes_cli.web_server import _normalise_theme_definition
+
r = _normalise_theme_definition({"name": "t"})
assert "assets" not in r
def test_custom_css_passthrough_and_capped(self):
from hermes_cli.web_server import _normalise_theme_definition
+
# Small CSS passes through verbatim.
- r = _normalise_theme_definition({
- "name": "t",
- "customCSS": "body { color: red; }",
- })
+ r = _normalise_theme_definition(
+ {
+ "name": "t",
+ "customCSS": "body { color: red; }",
+ }
+ )
assert r["customCSS"] == "body { color: red; }"
# 40 KiB of CSS gets clipped to the 32 KiB cap.
@@ -1555,41 +1804,52 @@ class TestNormaliseThemeExtensions:
def test_custom_css_empty_dropped(self):
from hermes_cli.web_server import _normalise_theme_definition
+
for val in ("", " \n\t", None):
r = _normalise_theme_definition({"name": "t", "customCSS": val})
assert "customCSS" not in r
def test_component_styles_per_bucket(self):
from hermes_cli.web_server import _normalise_theme_definition
- r = _normalise_theme_definition({
- "name": "t",
- "componentStyles": {
- "card": {
- "clipPath": "polygon(0 0, 100% 0, 100% 100%, 0 100%)",
- "boxShadow": "inset 0 0 0 1px red",
- "bad prop!": "ignored", # non-alnum prop rejected
+
+ r = _normalise_theme_definition(
+ {
+ "name": "t",
+ "componentStyles": {
+ "card": {
+ "clipPath": "polygon(0 0, 100% 0, 100% 100%, 0 100%)",
+ "boxShadow": "inset 0 0 0 1px red",
+ "bad prop!": "ignored", # non-alnum prop rejected
+ },
+ "header": {"background": "linear-gradient(red, blue)"},
+ "rogueBucket": {"foo": "bar"}, # not a known bucket — rejected
},
- "header": {"background": "linear-gradient(red, blue)"},
- "rogueBucket": {"foo": "bar"}, # not a known bucket — rejected
- },
- })
+ }
+ )
assert r["componentStyles"]["card"] == {
"clipPath": "polygon(0 0, 100% 0, 100% 100%, 0 100%)",
"boxShadow": "inset 0 0 0 1px red",
}
- assert r["componentStyles"]["header"]["background"].startswith("linear-gradient")
+ assert r["componentStyles"]["header"]["background"].startswith(
+ "linear-gradient"
+ )
assert "rogueBucket" not in r["componentStyles"]
def test_component_styles_empty_buckets_dropped(self):
from hermes_cli.web_server import _normalise_theme_definition
- r = _normalise_theme_definition({
- "name": "t",
- "componentStyles": {
- "card": {}, # empty — dropped entirely
- "header": {"bad prop!": "ignored"}, # all props rejected — bucket dropped
- "footer": {"background": "black"},
- },
- })
+
+ r = _normalise_theme_definition(
+ {
+ "name": "t",
+ "componentStyles": {
+ "card": {}, # empty — dropped entirely
+ "header": {
+ "bad prop!": "ignored"
+ }, # all props rejected — bucket dropped
+ "footer": {"background": "black"},
+ },
+ }
+ )
assert "card" not in r.get("componentStyles", {})
assert "header" not in r.get("componentStyles", {})
assert r["componentStyles"]["footer"]["background"] == "black"
@@ -1597,10 +1857,13 @@ class TestNormaliseThemeExtensions:
def test_component_styles_accepts_numeric_values(self):
"""Numeric values (e.g. opacity: 0.8) are coerced to strings."""
from hermes_cli.web_server import _normalise_theme_definition
- r = _normalise_theme_definition({
- "name": "t",
- "componentStyles": {"card": {"opacity": 0.8, "zIndex": 5}},
- })
+
+ r = _normalise_theme_definition(
+ {
+ "name": "t",
+ "componentStyles": {"card": {"opacity": 0.8, "zIndex": 5}},
+ }
+ )
assert r["componentStyles"]["card"] == {"opacity": "0.8", "zIndex": "5"}
@@ -1610,6 +1873,7 @@ class TestDashboardPluginManifestExtensions:
def _write_plugin(self, tmp_path, name, manifest):
import json
+
plug_dir = tmp_path / "plugins" / name / "dashboard"
plug_dir.mkdir(parents=True)
(plug_dir / "manifest.json").write_text(json.dumps(manifest))
@@ -1617,14 +1881,19 @@ class TestDashboardPluginManifestExtensions:
def test_override_and_hidden_carried_through(self, tmp_path, monkeypatch):
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
- self._write_plugin(tmp_path, "skin-home", {
- "name": "skin-home",
- "label": "Skin Home",
- "tab": {"path": "/skin-home", "override": "/", "hidden": True},
- "slots": ["sidebar", "header-left"],
- "entry": "dist/index.js",
- })
+ self._write_plugin(
+ tmp_path,
+ "skin-home",
+ {
+ "name": "skin-home",
+ "label": "Skin Home",
+ "tab": {"path": "/skin-home", "override": "/", "hidden": True},
+ "slots": ["sidebar", "header-left"],
+ "entry": "dist/index.js",
+ },
+ )
from hermes_cli import web_server
+
# Bust the process-level cache so the test plugin is picked up.
web_server._dashboard_plugins_cache = None
plugins = web_server._get_dashboard_plugins(force_rescan=True)
@@ -1635,13 +1904,18 @@ class TestDashboardPluginManifestExtensions:
def test_override_requires_leading_slash(self, tmp_path, monkeypatch):
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
- self._write_plugin(tmp_path, "bad-override", {
- "name": "bad-override",
- "label": "Bad",
- "tab": {"path": "/bad", "override": "no-leading-slash"},
- "entry": "dist/index.js",
- })
+ self._write_plugin(
+ tmp_path,
+ "bad-override",
+ {
+ "name": "bad-override",
+ "label": "Bad",
+ "tab": {"path": "/bad", "override": "no-leading-slash"},
+ "entry": "dist/index.js",
+ },
+ )
from hermes_cli import web_server
+
web_server._dashboard_plugins_cache = None
plugins = web_server._get_dashboard_plugins(force_rescan=True)
entry = next(p for p in plugins if p["name"] == "bad-override")
@@ -1649,13 +1923,18 @@ class TestDashboardPluginManifestExtensions:
def test_slots_default_empty(self, tmp_path, monkeypatch):
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
- self._write_plugin(tmp_path, "no-slots", {
- "name": "no-slots",
- "label": "No Slots",
- "tab": {"path": "/no-slots"},
- "entry": "dist/index.js",
- })
+ self._write_plugin(
+ tmp_path,
+ "no-slots",
+ {
+ "name": "no-slots",
+ "label": "No Slots",
+ "tab": {"path": "/no-slots"},
+ "entry": "dist/index.js",
+ },
+ )
from hermes_cli import web_server
+
web_server._dashboard_plugins_cache = None
plugins = web_server._get_dashboard_plugins(force_rescan=True)
entry = next(p for p in plugins if p["name"] == "no-slots")
@@ -1665,14 +1944,19 @@ class TestDashboardPluginManifestExtensions:
def test_slots_filters_non_string_entries(self, tmp_path, monkeypatch):
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
- self._write_plugin(tmp_path, "mixed-slots", {
- "name": "mixed-slots",
- "label": "Mixed",
- "tab": {"path": "/mixed-slots"},
- "slots": ["sidebar", "", 42, None, "header-right"],
- "entry": "dist/index.js",
- })
+ self._write_plugin(
+ tmp_path,
+ "mixed-slots",
+ {
+ "name": "mixed-slots",
+ "label": "Mixed",
+ "tab": {"path": "/mixed-slots"},
+ "slots": ["sidebar", "", 42, None, "header-right"],
+ "entry": "dist/index.js",
+ },
+ )
from hermes_cli import web_server
+
web_server._dashboard_plugins_cache = None
plugins = web_server._get_dashboard_plugins(force_rescan=True)
entry = next(p for p in plugins if p["name"] == "mixed-slots")
@@ -1684,24 +1968,29 @@ class TestDashboardPluginManifestExtensions:
frontend ```` placements decide what actually
renders — but the loader must not mangle colons in slot names."""
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
- self._write_plugin(tmp_path, "page-slots", {
- "name": "page-slots",
- "label": "Page Slots",
- "tab": {"path": "/page-slots", "hidden": True},
- "slots": [
- "sessions:top",
- "analytics:bottom",
- "logs:top",
- "skills:bottom",
- "config:top",
- "env:bottom",
- "docs:top",
- "cron:bottom",
- "chat:top",
- ],
- "entry": "dist/index.js",
- })
+ self._write_plugin(
+ tmp_path,
+ "page-slots",
+ {
+ "name": "page-slots",
+ "label": "Page Slots",
+ "tab": {"path": "/page-slots", "hidden": True},
+ "slots": [
+ "sessions:top",
+ "analytics:bottom",
+ "logs:top",
+ "skills:bottom",
+ "config:top",
+ "env:bottom",
+ "docs:top",
+ "cron:bottom",
+ "chat:top",
+ ],
+ "entry": "dist/index.js",
+ },
+ )
from hermes_cli import web_server
+
web_server._dashboard_plugins_cache = None
plugins = web_server._get_dashboard_plugins(force_rescan=True)
entry = next(p for p in plugins if p["name"] == "page-slots")
@@ -1885,12 +2174,18 @@ class TestPtyWebSocket:
# Patch PtyBridge.spawn at the web_server module's binding.
import hermes_cli.web_server as ws_mod
- monkeypatch.setattr(ws_mod.PtyBridge, "spawn", classmethod(lambda cls, *a, **k: _raise(*a, **k)))
+ monkeypatch.setattr(
+ ws_mod.PtyBridge, "spawn", classmethod(lambda cls, *a, **k: _raise(*a, **k))
+ )
with self.client.websocket_connect(self._url()) as conn:
# Expect a final text frame with the error message, then close.
msg = conn.receive_text()
- assert "pty missing" in msg or "unavailable" in msg.lower() or "pty" in msg.lower()
+ assert (
+ "pty missing" in msg
+ or "unavailable" in msg.lower()
+ or "pty" in msg.lower()
+ )
def test_resume_parameter_is_forwarded_to_argv(self, monkeypatch):
captured: dict = {}
@@ -1923,9 +2218,7 @@ class TestPtyWebSocket:
monkeypatch.setattr(
self.ws_module.app.state, "bound_host", "127.0.0.1", raising=False
)
- monkeypatch.setattr(
- self.ws_module.app.state, "bound_port", 9119, raising=False
- )
+ monkeypatch.setattr(self.ws_module.app.state, "bound_port", 9119, raising=False)
with self.client.websocket_connect(self._url(channel="abc-123")) as conn:
try:
@@ -1959,8 +2252,6 @@ class TestPtyWebSocket:
from starlette.websockets import WebSocketDisconnect
with pytest.raises(WebSocketDisconnect) as exc:
- with self.client.websocket_connect(
- f"/api/events?token={self.token}"
- ):
+ with self.client.websocket_connect(f"/api/events?token={self.token}"):
pass
assert exc.value.code == 4400
diff --git a/web/src/App.tsx b/web/src/App.tsx
index f4285a21b4..39e8414325 100644
--- a/web/src/App.tsx
+++ b/web/src/App.tsx
@@ -1,19 +1,34 @@
+import { Backdrop } from "@/components/Backdrop";
+import { DesktopBridge } from "@/components/DesktopBridge";
+import { LanguageSwitcher } from "@/components/LanguageSwitcher";
+import { RuntimeOverlay } from "@/components/RuntimeOverlay";
+import { SidebarFooter } from "@/components/SidebarFooter";
+import { SidebarStatusStrip } from "@/components/SidebarStatusStrip";
+import { ThemeSwitcher } from "@/components/ThemeSwitcher";
+import { PageHeaderProvider } from "@/contexts/PageHeaderProvider";
+import type { SystemAction } from "@/contexts/system-actions-context";
+import { useSystemActions } from "@/contexts/useSystemActions";
+import { useI18n } from "@/i18n";
+import { api, type SetupStateResponse } from "@/lib/api";
import {
- useCallback,
- useEffect,
- useMemo,
- useState,
- type ComponentType,
- type ReactNode,
-} from "react";
-import {
- Routes,
- Route,
- NavLink,
- Navigate,
- useLocation,
- useNavigate,
-} from "react-router-dom";
+ isDashboardEmbeddedChatEnabled,
+ isDashboardGuiEnabled,
+} from "@/lib/dashboard-flags";
+import { cn } from "@/lib/utils";
+import AnalyticsPage from "@/pages/AnalyticsPage";
+import ChatPage from "@/pages/ChatPage";
+import ConfigPage from "@/pages/ConfigPage";
+import CronPage from "@/pages/CronPage";
+import DocsPage from "@/pages/DocsPage";
+import EnvPage from "@/pages/EnvPage";
+import LogsPage from "@/pages/LogsPage";
+import SessionsPage from "@/pages/SessionsPage";
+import SetupPage from "@/pages/SetupPage";
+import SkillsPage from "@/pages/SkillsPage";
+import type { PluginManifest } from "@/plugins";
+import { PluginPage, PluginSlot, usePlugins } from "@/plugins";
+import { useTheme } from "@/themes";
+import { SelectionSwitcher, Typography } from "@nous-research/ui";
import {
Activity,
BarChart3,
@@ -42,30 +57,22 @@ import {
X,
Zap,
} from "lucide-react";
-import { SelectionSwitcher, Typography } from "@nous-research/ui";
-import { cn } from "@/lib/utils";
-import { Backdrop } from "@/components/Backdrop";
-import { SidebarFooter } from "@/components/SidebarFooter";
-import { SidebarStatusStrip } from "@/components/SidebarStatusStrip";
-import { PageHeaderProvider } from "@/contexts/PageHeaderProvider";
-import { useSystemActions } from "@/contexts/useSystemActions";
-import type { SystemAction } from "@/contexts/system-actions-context";
-import ConfigPage from "@/pages/ConfigPage";
-import DocsPage from "@/pages/DocsPage";
-import EnvPage from "@/pages/EnvPage";
-import SessionsPage from "@/pages/SessionsPage";
-import LogsPage from "@/pages/LogsPage";
-import AnalyticsPage from "@/pages/AnalyticsPage";
-import CronPage from "@/pages/CronPage";
-import SkillsPage from "@/pages/SkillsPage";
-import ChatPage from "@/pages/ChatPage";
-import { LanguageSwitcher } from "@/components/LanguageSwitcher";
-import { ThemeSwitcher } from "@/components/ThemeSwitcher";
-import { useI18n } from "@/i18n";
-import { PluginPage, PluginSlot, usePlugins } from "@/plugins";
-import type { PluginManifest } from "@/plugins";
-import { useTheme } from "@/themes";
-import { isDashboardEmbeddedChatEnabled } from "@/lib/dashboard-flags";
+import {
+ useCallback,
+ useEffect,
+ useMemo,
+ useState,
+ type ComponentType,
+ type ReactNode,
+} from "react";
+import {
+ NavLink,
+ Navigate,
+ Route,
+ Routes,
+ useLocation,
+ useNavigate,
+} from "react-router-dom";
function RootRedirect() {
return (null);
const closeMobile = useCallback(() => setMobileOpen(false), []);
const isDocsRoute = pathname === "/docs" || pathname === "/docs/";
const normalizedPath = pathname.replace(/\/$/, "") || "/";
const isChatRoute = normalizedPath === "/chat";
+ const guiMode = isDashboardGuiEnabled();
const embeddedChat = isDashboardEmbeddedChatEnabled();
const builtinRoutes = useMemo(
() => ({
...BUILTIN_ROUTES_CORE,
+ ...(guiMode ? { "/setup": SetupPage } : {}),
...(embeddedChat ? { "/chat": ChatPage } : {}),
}),
- [embeddedChat],
+ [embeddedChat, guiMode],
);
const builtinNav = useMemo(
@@ -284,6 +298,48 @@ export default function App() {
const layoutVariant = theme.layoutVariant ?? "standard";
+ useEffect(() => {
+ if (!guiMode) return;
+ let cancelled = false;
+
+ const refresh = async () => {
+ try {
+ const state = await api.getSetupState();
+ if (!cancelled) {
+ setSetupState(state);
+ }
+ } catch {
+ if (!cancelled) {
+ setSetupState(null);
+ }
+ }
+ };
+
+ const onRefresh = () => {
+ void refresh();
+ };
+
+ void refresh();
+ window.addEventListener("hermes:setup-refresh", onRefresh);
+ const id = window.setInterval(refresh, 2500);
+ return () => {
+ cancelled = true;
+ window.clearInterval(id);
+ window.removeEventListener("hermes:setup-refresh", onRefresh);
+ };
+ }, [guiMode]);
+
+ useEffect(() => {
+ if (!guiMode || !setupState) return;
+ if (setupState.needs_setup && normalizedPath !== "/setup") {
+ navigate("/setup", { replace: true });
+ return;
+ }
+ if (!setupState.needs_setup && normalizedPath === "/setup") {
+ navigate("/sessions", { replace: true });
+ }
+ }, [guiMode, navigate, normalizedPath, setupState]);
+
useEffect(() => {
if (!mobileOpen) return;
const onKey = (e: KeyboardEvent) => {
@@ -507,7 +563,8 @@ export default function App() {
@@ -527,6 +584,8 @@ export default function App() {
;
+ requestPermission: () => Promise<"default" | "denied" | "granted">;
+ sendNotification: (notification: {
+ body?: string;
+ title: string;
+ }) => void;
+ };
+ };
+ }
+}
+
+export function DesktopBridge() {
+ useEffect(() => {
+ if (!isDashboardGuiEnabled()) return;
+
+ const notify = async (title: string, body?: string) => {
+ const api = window.__TAURI__?.notification;
+ if (!api) return;
+
+ let granted = await api.isPermissionGranted();
+ if (!granted) {
+ granted = (await api.requestPermission()) === "granted";
+ }
+ if (granted) api.sendNotification({ body, title });
+ };
+
+ const onNotify = (event: Event) => {
+ const detail = (event as CustomEvent<{ body?: string; title?: string }>)
+ .detail;
+ if (!detail?.title) return;
+ void notify(detail.title, detail.body);
+ };
+
+ window.addEventListener("hermes:desktop-notify", onNotify);
+ return () => window.removeEventListener("hermes:desktop-notify", onNotify);
+ }, []);
+
+ return null;
+}
diff --git a/web/src/components/RuntimeOverlay.tsx b/web/src/components/RuntimeOverlay.tsx
new file mode 100644
index 0000000000..1efefae135
--- /dev/null
+++ b/web/src/components/RuntimeOverlay.tsx
@@ -0,0 +1,117 @@
+import { RotateCw } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+
+import { Button } from "@/components/ui/button";
+import { api } from "@/lib/api";
+import { isDashboardGuiEnabled } from "@/lib/dashboard-flags";
+import { cn } from "@/lib/utils";
+
+type RuntimeState = "checking" | "healthy" | "reconnecting";
+
+const POLL_MS = 2_500;
+
+export function RuntimeOverlay() {
+ const [state, setState] = useState("checking");
+ const [isGui, setIsGui] = useState(() => isDashboardGuiEnabled());
+ const [lastOkAt, setLastOkAt] = useState(null);
+ const [notifiedDown, setNotifiedDown] = useState(false);
+
+ useEffect(() => {
+ let cancelled = false;
+
+ const poll = async () => {
+ try {
+ const runtime = await api.getRuntime();
+ if (cancelled) return;
+ setIsGui(runtime.gui);
+ setLastOkAt(Date.now());
+ if (notifiedDown) {
+ window.dispatchEvent(
+ new CustomEvent("hermes:desktop-notify", {
+ detail: {
+ body: "The dashboard runtime is healthy again.",
+ title: "Hermes Reconnected",
+ },
+ }),
+ );
+ setNotifiedDown(false);
+ }
+ setState("healthy");
+ } catch {
+ if (cancelled) return;
+ setNotifiedDown((already) => {
+ if (!already && isGui) {
+ window.dispatchEvent(
+ new CustomEvent("hermes:desktop-notify", {
+ detail: {
+ body: "Trying to reconnect to the local Hermes runtime.",
+ title: "Hermes Runtime Disconnected",
+ },
+ }),
+ );
+ }
+ return true;
+ });
+ setState((prev) => (prev === "checking" ? "checking" : "reconnecting"));
+ }
+ };
+
+ void poll();
+ const id = setInterval(poll, POLL_MS);
+ return () => {
+ cancelled = true;
+ clearInterval(id);
+ };
+ }, [isGui, notifiedDown]);
+
+ const detail = useMemo(() => {
+ if (state === "checking") return "Checking local Hermes runtime...";
+ if (!lastOkAt) return "Trying to reconnect to the local Hermes runtime.";
+ return `Runtime connection dropped. Last healthy ${Math.max(
+ 1,
+ Math.round((Date.now() - lastOkAt) / 1000),
+ )}s ago.`;
+ }, [lastOkAt, state]);
+
+ if (!isGui || state === "healthy") return null;
+
+ return (
+
+
+
+
+ Hermes GUI Runtime
+
+
+ {detail}
+
+
+
+
+
+
+
+ );
+}
diff --git a/web/src/components/SidebarFooter.tsx b/web/src/components/SidebarFooter.tsx
index e28623d722..18274088d6 100644
--- a/web/src/components/SidebarFooter.tsx
+++ b/web/src/components/SidebarFooter.tsx
@@ -1,7 +1,7 @@
-import { Typography } from "@nous-research/ui";
import { useSidebarStatus } from "@/hooks/useSidebarStatus";
-import { cn } from "@/lib/utils";
import { useI18n } from "@/i18n";
+import { cn } from "@/lib/utils";
+import { Typography } from "@nous-research/ui";
export function SidebarFooter() {
const status = useSidebarStatus();
@@ -19,7 +19,9 @@ export function SidebarFooter() {
mondwest
className="font-mono-ui text-[0.7rem] tabular-nums tracking-[0.1em] text-muted-foreground/70"
>
- {status?.version != null ? `v${status.version}` : "—"}
+ {status?.version != null
+ ? `v${status.version}${status.gui ? " · GUI" : ""}`
+ : "—"}
(url: string, init?: RequestInit): Promise {
+export async function fetchJSON(
+ url: string,
+ init?: RequestInit,
+): Promise {
// Inject the session token into all /api/ requests.
const headers = new Headers(init?.headers);
const token = window.__HERMES_SESSION_TOKEN__;
@@ -40,32 +43,50 @@ async function getSessionToken(): Promise {
_sessionToken = injected;
return _sessionToken;
}
- throw new Error("Session token not available — page must be served by the Hermes dashboard server");
+ throw new Error(
+ "Session token not available — page must be served by the Hermes dashboard server",
+ );
}
export const api = {
+ getHealth: () => fetchJSON("/api/health"),
+ getRuntime: () => fetchJSON("/api/runtime"),
+ getSetupState: () => fetchJSON("/api/setup/state"),
getStatus: () => fetchJSON("/api/status"),
getSessions: (limit = 20, offset = 0) =>
- fetchJSON(`/api/sessions?limit=${limit}&offset=${offset}`),
+ fetchJSON(
+ `/api/sessions?limit=${limit}&offset=${offset}`,
+ ),
getSessionMessages: (id: string) =>
- fetchJSON(`/api/sessions/${encodeURIComponent(id)}/messages`),
+ fetchJSON(
+ `/api/sessions/${encodeURIComponent(id)}/messages`,
+ ),
deleteSession: (id: string) =>
fetchJSON<{ ok: boolean }>(`/api/sessions/${encodeURIComponent(id)}`, {
method: "DELETE",
}),
- getLogs: (params: { file?: string; lines?: number; level?: string; component?: string }) => {
+ getLogs: (params: {
+ file?: string;
+ lines?: number;
+ level?: string;
+ component?: string;
+ }) => {
const qs = new URLSearchParams();
if (params.file) qs.set("file", params.file);
if (params.lines) qs.set("lines", String(params.lines));
if (params.level && params.level !== "ALL") qs.set("level", params.level);
- if (params.component && params.component !== "all") qs.set("component", params.component);
+ if (params.component && params.component !== "all")
+ qs.set("component", params.component);
return fetchJSON(`/api/logs?${qs.toString()}`);
},
getAnalytics: (days: number) =>
fetchJSON(`/api/analytics/usage?days=${days}`),
getConfig: () => fetchJSON>("/api/config"),
getDefaults: () => fetchJSON>("/api/config/defaults"),
- getSchema: () => fetchJSON<{ fields: Record; category_order: string[] }>("/api/config/schema"),
+ getSchema: () =>
+ fetchJSON<{ fields: Record; category_order: string[] }>(
+ "/api/config/schema",
+ ),
getModelInfo: () => fetchJSON("/api/model/info"),
saveConfig: (config: Record) =>
fetchJSON<{ ok: boolean }>("/api/config", {
@@ -107,18 +128,29 @@ export const api = {
// Cron jobs
getCronJobs: () => fetchJSON("/api/cron/jobs"),
- createCronJob: (job: { prompt: string; schedule: string; name?: string; deliver?: string }) =>
+ createCronJob: (job: {
+ prompt: string;
+ schedule: string;
+ name?: string;
+ deliver?: string;
+ }) =>
fetchJSON("/api/cron/jobs", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(job),
}),
pauseCronJob: (id: string) =>
- fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/pause`, { method: "POST" }),
+ fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/pause`, {
+ method: "POST",
+ }),
resumeCronJob: (id: string) =>
- fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/resume`, { method: "POST" }),
+ fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/resume`, {
+ method: "POST",
+ }),
triggerCronJob: (id: string) =>
- fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/trigger`, { method: "POST" }),
+ fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}/trigger`, {
+ method: "POST",
+ }),
deleteCronJob: (id: string) =>
fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${id}`, { method: "DELETE" }),
@@ -134,7 +166,9 @@ export const api = {
// Session search (FTS5)
searchSessions: (q: string) =>
- fetchJSON(`/api/sessions/search?q=${encodeURIComponent(q)}`),
+ fetchJSON(
+ `/api/sessions/search?q=${encodeURIComponent(q)}`,
+ ),
// OAuth provider management
getOAuthProviders: () =>
@@ -163,7 +197,11 @@ export const api = {
},
);
},
- submitOAuthCode: async (providerId: string, sessionId: string, code: string) => {
+ submitOAuthCode: async (
+ providerId: string,
+ sessionId: string,
+ code: string,
+ ) => {
const token = await getSessionToken();
return fetchJSON(
`/api/providers/oauth/${encodeURIComponent(providerId)}/submit`,
@@ -209,8 +247,7 @@ export const api = {
fetchJSON<{ ok: boolean; count: number }>("/api/dashboard/plugins/rescan"),
// Dashboard themes
- getThemes: () =>
- fetchJSON("/api/dashboard/themes"),
+ getThemes: () => fetchJSON("/api/dashboard/themes"),
setTheme: (name: string) =>
fetchJSON<{ ok: boolean; theme: string }>("/api/dashboard/theme", {
method: "PUT",
@@ -244,6 +281,7 @@ export interface StatusResponse {
active_sessions: number;
config_path: string;
config_version: number;
+ embedded_chat: boolean;
env_path: string;
gateway_exit_reason: string | null;
gateway_health_url: string | null;
@@ -252,12 +290,68 @@ export interface StatusResponse {
gateway_running: boolean;
gateway_state: string | null;
gateway_updated_at: string | null;
+ gui: boolean;
hermes_home: string;
latest_config_version: number;
release_date: string;
version: string;
}
+export interface HealthResponse {
+ embedded_chat: boolean;
+ mode: "browser" | "gui";
+ profile: string;
+ status: "ok";
+ version: string;
+}
+
+export interface RuntimeResponse {
+ dashboard: {
+ embedded_chat: boolean;
+ };
+ gateway: {
+ pid: number | null;
+ platforms: Record;
+ running: boolean;
+ state: string | null;
+ };
+ gui: boolean;
+ hermes_home: string;
+ profile: string;
+ status: string;
+}
+
+export interface SetupStateResponse {
+ checklist: {
+ model: boolean;
+ provider: boolean;
+ terminal: boolean;
+ };
+ gui: boolean;
+ hermes_home: string;
+ is_fresh_mode: boolean;
+ model: {
+ configured: boolean;
+ value: string;
+ };
+ needs_setup: boolean;
+ profile: string;
+ provider: {
+ active_provider: string | null;
+ configured_env_keys: string[];
+ recommended_keys: Array<{
+ description: string;
+ is_set: boolean;
+ name: string;
+ url: string | null;
+ }>;
+ };
+ terminal: {
+ backend: string;
+ configured: boolean;
+ };
+}
+
export interface SessionInfo {
id: string;
source: string | null;
diff --git a/web/src/lib/dashboard-flags.ts b/web/src/lib/dashboard-flags.ts
index 0ce9e03be8..4e78c93c2c 100644
--- a/web/src/lib/dashboard-flags.ts
+++ b/web/src/lib/dashboard-flags.ts
@@ -2,6 +2,8 @@ declare global {
interface Window {
/** Set true by the server only for `hermes dashboard --tui` (or HERMES_DASHBOARD_TUI=1). */
__HERMES_DASHBOARD_EMBEDDED_CHAT__?: boolean;
+ /** Set true by the server for `hermes dashboard --gui`. */
+ __HERMES_DASHBOARD_GUI__?: boolean;
/** @deprecated Older injected name; treated as on when true. */
__HERMES_DASHBOARD_TUI__?: boolean;
}
@@ -13,3 +15,8 @@ export function isDashboardEmbeddedChatEnabled(): boolean {
if (window.__HERMES_DASHBOARD_EMBEDDED_CHAT__ === true) return true;
return window.__HERMES_DASHBOARD_TUI__ === true;
}
+
+export function isDashboardGuiEnabled(): boolean {
+ if (typeof window === "undefined") return false;
+ return window.__HERMES_DASHBOARD_GUI__ === true;
+}
diff --git a/web/src/lib/resolve-page-title.ts b/web/src/lib/resolve-page-title.ts
index 00d2d1e6e4..6f728f6a2a 100644
--- a/web/src/lib/resolve-page-title.ts
+++ b/web/src/lib/resolve-page-title.ts
@@ -18,6 +18,9 @@ export function resolvePageTitle(
pluginTabs: { path: string; label: string }[],
): string {
const normalized = pathname.replace(/\/$/, "") || "/";
+ if (normalized === "/setup") {
+ return "Setup";
+ }
if (normalized === "/") {
return t.app.nav.sessions;
}
diff --git a/web/src/pages/SetupPage.tsx b/web/src/pages/SetupPage.tsx
new file mode 100644
index 0000000000..63ed7cf9c3
--- /dev/null
+++ b/web/src/pages/SetupPage.tsx
@@ -0,0 +1,434 @@
+import { OAuthProvidersCard } from "@/components/OAuthProvidersCard";
+import { Toast } from "@/components/Toast";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { useToast } from "@/hooks/useToast";
+import { api, type EnvVarInfo, type SetupStateResponse } from "@/lib/api";
+import { PluginSlot } from "@/plugins";
+import {
+ ArrowRight,
+ CheckCircle2,
+ Circle,
+ KeyRound,
+ Loader2,
+ Settings2,
+ Sparkles,
+} from "lucide-react";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useNavigate } from "react-router-dom";
+
+const MODEL_PRESETS = [
+ "anthropic/claude-sonnet-4.6",
+ "openai/gpt-4.1",
+ "google/gemini-2.5-pro",
+ "deepseek/deepseek-reasoner",
+];
+
+const FALLBACK_PROVIDER_KEYS = [
+ "OPENROUTER_API_KEY",
+ "ANTHROPIC_API_KEY",
+ "OPENAI_API_KEY",
+ "NOUS_API_KEY",
+];
+
+function readModelValue(config: Record | null): string {
+ if (!config) return "";
+ const modelValue = config.model;
+ if (typeof modelValue === "string") return modelValue;
+ if (
+ modelValue &&
+ typeof modelValue === "object" &&
+ !Array.isArray(modelValue)
+ ) {
+ const defaultModel = (modelValue as Record).default;
+ if (typeof defaultModel === "string") return defaultModel;
+ }
+ return "";
+}
+
+export default function SetupPage() {
+ const navigate = useNavigate();
+ const { toast, showToast } = useToast();
+ const [setupState, setSetupState] = useState(null);
+ const [envVars, setEnvVars] = useState | null>(
+ null,
+ );
+ const [config, setConfig] = useState | null>(null);
+ const [loading, setLoading] = useState(true);
+ const [savingKey, setSavingKey] = useState(false);
+ const [savingConfig, setSavingConfig] = useState(false);
+ const [providerKey, setProviderKey] = useState("");
+ const [providerValue, setProviderValue] = useState("");
+ const [modelValue, setModelValue] = useState("");
+ const [terminalBackend, setTerminalBackend] = useState("local");
+
+ const load = useCallback(async () => {
+ setLoading(true);
+ try {
+ const [state, vars, cfg] = await Promise.all([
+ api.getSetupState(),
+ api.getEnvVars(),
+ api.getConfig(),
+ ]);
+ setSetupState(state);
+ setEnvVars(vars);
+ setConfig(cfg);
+ setModelValue(state.model.value || readModelValue(cfg));
+ setTerminalBackend(state.terminal.backend || "local");
+
+ const preferredKeys = [
+ ...state.provider.recommended_keys.map((k) => k.name),
+ ...FALLBACK_PROVIDER_KEYS,
+ ];
+ const availableKeys = preferredKeys.filter((key) => vars[key] != null);
+ const firstUnset = availableKeys.find((key) => !vars[key]?.is_set);
+ const nextKey = firstUnset || availableKeys[0] || "";
+ setProviderKey((prev) => (prev && vars[prev] ? prev : nextKey));
+ } catch (error) {
+ showToast(`Failed to load setup state: ${error}`, "error");
+ } finally {
+ setLoading(false);
+ }
+ }, [showToast]);
+
+ useEffect(() => {
+ void load();
+ }, [load]);
+
+ const providerOptions = useMemo(() => {
+ if (!envVars || !setupState) return [];
+ const keySet = new Set();
+ const options: Array<{
+ key: string;
+ description: string;
+ isSet: boolean;
+ url: string | null;
+ }> = [];
+
+ for (const item of setupState.provider.recommended_keys) {
+ if (!envVars[item.name]) continue;
+ keySet.add(item.name);
+ options.push({
+ key: item.name,
+ description: item.description,
+ isSet: envVars[item.name]?.is_set ?? item.is_set,
+ url: item.url,
+ });
+ }
+
+ for (const [key, info] of Object.entries(envVars)) {
+ if (keySet.has(key)) continue;
+ if (info.category !== "provider") continue;
+ if (!(key.endsWith("_API_KEY") || key.endsWith("_TOKEN"))) continue;
+ options.push({
+ key,
+ description: info.description,
+ isSet: info.is_set,
+ url: info.url,
+ });
+ }
+
+ return options;
+ }, [envVars, setupState]);
+
+ const selectedProviderMeta = providerOptions.find(
+ (o) => o.key === providerKey,
+ );
+ const checklist = setupState?.checklist;
+ const ready = !!checklist?.provider && !!checklist?.model;
+ const completeCount =
+ Number(!!checklist?.provider) +
+ Number(!!checklist?.model) +
+ Number(!!checklist?.terminal);
+
+ const saveProviderKey = async () => {
+ if (!providerKey || !providerValue.trim()) return;
+ setSavingKey(true);
+ try {
+ await api.setEnvVar(providerKey, providerValue.trim());
+ setProviderValue("");
+ showToast(`Saved ${providerKey}`, "success");
+ window.dispatchEvent(new Event("hermes:setup-refresh"));
+ await load();
+ } catch (error) {
+ showToast(`Failed to save ${providerKey}: ${error}`, "error");
+ } finally {
+ setSavingKey(false);
+ }
+ };
+
+ const saveModelAndDefaults = async () => {
+ if (!config) return;
+ const trimmedModel = modelValue.trim();
+ if (!trimmedModel) {
+ showToast("Model is required.", "error");
+ return;
+ }
+
+ const nextConfig = structuredClone(config);
+ nextConfig.model = trimmedModel;
+ const rawTerminal = nextConfig.terminal;
+ const terminal =
+ rawTerminal &&
+ typeof rawTerminal === "object" &&
+ !Array.isArray(rawTerminal)
+ ? { ...(rawTerminal as Record) }
+ : {};
+ terminal.backend = terminalBackend || "local";
+ nextConfig.terminal = terminal;
+
+ setSavingConfig(true);
+ try {
+ await api.saveConfig(nextConfig);
+ setConfig(nextConfig);
+ showToast("Saved model and runtime defaults.", "success");
+ window.dispatchEvent(new Event("hermes:setup-refresh"));
+ await load();
+ } catch (error) {
+ showToast(`Failed to save setup config: ${error}`, "error");
+ } finally {
+ setSavingConfig(false);
+ }
+ };
+
+ if (loading) {
+ return (
+
+
+
+
+ Hermes GUI Setup
+
+
+
+
+
+ {ready ? "Ready" : "Setup Required"}
+
+
+ {completeCount}/3 checks complete
+
+
+ {setupState.is_fresh_mode && (
+
+ Fresh mode active. This GUI run is isolated from your default
+ install.
+
+ )}
+
+ Profile: {setupState.profile} · Home:{" "}
+ {setupState.hermes_home}
+
+
+
+
+
+
+
+
+ 1) Connect a provider
+
+
+
+ showToast(msg, "error")}
+ onSuccess={(msg) => showToast(msg, "success")}
+ />
+
+
+
+
+
+ setProviderValue(e.target.value)}
+ placeholder="Paste API key"
+ className="h-9 font-mono-ui text-xs"
+ />
+
+
+ {selectedProviderMeta?.description && (
+
+ {selectedProviderMeta.description}
+
+ )}
+ {selectedProviderMeta?.url && (
+
+ Get key
+
+ )}
+
+
+
+
+
+
+
+ 2) Choose model + runtime defaults
+
+
+
+
+
+ setModelValue(e.target.value)}
+ placeholder="anthropic/claude-sonnet-4.6"
+ className="font-mono-ui text-xs"
+ />
+
+ {MODEL_PRESETS.map((preset) => (
+
+ ))}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 3) Continue
+
+
+
+
+
+
+
+