The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Pluggable-language JSON-RPC handlers: ``i18n.languages`` and ``i18n.catalog``.
Both are profile-scoped: the user overlay dir (``<home>/locales``) and ``display.language`` belong
to the profile the client is looking at. Plugin packs are process-wide (one PluginManager per home
registers them under the same registry), so a pack installed in profile A is visible to every
profile — a language switcher lists it everywhere, exactly like a bundled locale.
Bodies are rebound onto server.py's globals (method_ctx.bind_module) and reference them bare.
"""
from __future__ import annotations
import logging
from .method_ctx import HandlerRegistry, bind_module
_registry = HandlerRegistry()
method = _registry.method
_profile_scoped = _registry.profile_scoped
_I18N_ERR = 5400
def _load_language_packs() -> None:
"""Plugin packs register during plugin discovery, which nothing in this process may have run yet: the
Desktop asks for its catalog as soon as it connects, before any agent exists. Idempotent. A failed
discovery still answers with the bundled and overlay layers."""
from hermes_cli.plugins import discover_plugins
try:
discover_plugins()
except Exception:
logging.getLogger(__name__).warning("i18n: plugin discovery failed; serving languages without plugin packs",
exc_info=True)
@method("i18n.languages")
@_profile_scoped
def _(rid, params: dict) -> dict:
from agent.i18n import language_options
try:
_load_language_packs()
return _ok(rid, {"languages": language_options()})
except Exception as e:
return _err(rid, _I18N_ERR, str(e))
@method("i18n.catalog")
@_profile_scoped
def _(rid, params: dict) -> dict:
from agent.i18n import resolve_language_id, surface_catalog
from agent.i18n_layers import CORE_SURFACE, SURFACES
surface = str(params.get("surface") or CORE_SURFACE)
if surface not in SURFACES:
return _err(rid, 4002, f"surface must be one of {', '.join(SURFACES)}")
try:
_load_language_packs()
lang = resolve_language_id(params.get("lang", "")) or "en"
return _ok(rid, {"lang": lang, "surface": surface, "messages": surface_catalog(lang, surface)})
except Exception as e:
return _err(rid, _I18N_ERR, str(e))
def register(server) -> None:
bind_module(globals(), server, skip=("_",))
# A cold call runs plugin discovery, which loads every enabled plugin: keep it off the request reader.
server._LONG_HANDLERS = server._LONG_HANDLERS | _registry.names()