The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""``/api/ui-preferences``: the Webapp's door to this machine's UI preferences store (#145213).
Thin HTTP over :mod:`hermes_cli.ui_preferences`. The store belongs to the machine serving the
Webapp, so every browser and origin that opens it reads and writes the same document native
Desktop on this machine uses (through its preload capability, not this route). Mounted only on
surfaces whose policy names ``ui_preferences`` (404 elsewhere) and, like every ``/api/`` route,
only past the session-token / sign-in gate.
"""
from __future__ import annotations
from typing import Optional
from fastapi import APIRouter, HTTPException
from pydantic import BaseModel, Field
from hermes_cli import ui_preferences
router = APIRouter()
class PreferencesPatch(BaseModel):
#: Per-key changes; ``null`` deletes the key (the renderer's "back to default").
values: dict[str, Optional[str]] = Field(default_factory=dict)
#: This browser's first contact with the store generation: adds only the keys the store
#: lacks, never overwriting or deleting one.
seed: bool = False
@router.get("/api/ui-preferences")
def get_ui_preferences() -> dict:
try:
return ui_preferences.read_preferences()
except ui_preferences.PreferencesBusy as exc:
raise HTTPException(status_code=503, detail=str(exc)) from exc
@router.patch("/api/ui-preferences")
def patch_ui_preferences(body: PreferencesPatch) -> dict:
try:
return ui_preferences.write_preferences(body.values, seed=body.seed)
except ui_preferences.PreferencesError as exc:
raise HTTPException(status_code=400, detail=str(exc)) from exc
except ui_preferences.PreferencesBusy as exc:
raise HTTPException(status_code=503, detail=str(exc)) from exc