`gj+-UdZddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z ejeZdZded <d Zid d d d d d ddddddddddddddddddddddddddddid dd!dd"dd#dd$d%d&d%d'd%d(d%d)d%d*d%d+d,d-d,d.d,d/d,d0d,d1d,d2d,id3d4d5d4d6d4d7d4d8d4d9d:d;d:dd?d>d@dAdBdAdCdAdDdEdFdEdGdEdHdEidIdJdKdJdLdJdMdNdOdNdPdNdQdNdRdNdSdNdTdNdUdVdWdVdXdVdYdZd[dZd\dZZd]ed^<iZd_ed`<ej*ZdldaZdmdbZdndcZdoddZedefdpdgZdqdhZdrdiZdsdtdjZgdkZy)uaLightweight internationalization (i18n) for Hermes static user-facing messages. Scope (thin slice, by design): only the highest-impact static strings shown to the user by Hermes itself -- approval prompts, a handful of gateway slash command replies, restart-drain notices. Agent-generated output, log lines, error tracebacks, tool outputs, and slash-command descriptions all stay in English. Catalog files live under ``locales/.yaml`` at the repo root. Each catalog is a flat dict keyed by dotted paths (e.g. ``approval.choose`` or ``gateway.approval_expired``). Missing keys fall back to English; if English is missing too, the key path itself is returned so a broken catalog never crashes the agent. Usage:: from agent.i18n import t print(t("approval.choose_long")) # current lang print(t("gateway.draining", count=3)) # {count} formatted print(t("approval.choose_long", lang="zh")) # explicit override Language resolution order: 1. Explicit ``lang=`` argument passed to :func:`t` 2. ``HERMES_LANGUAGE`` environment variable (for tests / quick override) 3. ``display.language`` from config.yaml 4. ``"en"`` (baseline) Supported languages: en, zh, ja, de, es, fr, tr, uk. Unknown values fall back to en. ) annotationsN) lru_cache)Path)Any)enzhzh-hantjadeesfrtrukafkoitgaptruhuztuple[str, ...]SUPPORTED_LANGUAGESrenglishzen-uszen-gbchinesermandarinzzh-cnzzh-hanszzh-sgztraditional-chineser traditional_chinesezzh-twzzh-hkzzh-mojapaneser jpzja-jpgermanr deutschzde-dezde-atzde-chspanishr uespañolespanolzes-eszes-mxzes-arfrenchr u françaisfrancezfr-frzfr-bezfr-cazfr-ch ukrainianr ukrainischuукраїнськаzuk-uauaturkishrutürkçeztr-tr afrikaansrzaf-zakoreanru 한국어zko-kritalianritalianozit-itzit-chirishrgaeilgezga-ie portugueseru português portugueszpt-ptzpt-br brazilian brasileirorussianruрусскийzru-ru hungarianrmagyarzhu-hudict[str, str]_LANGUAGE_ALIASESzdict[str, dict[str, str]]_catalog_cachectjddj}|r3t|}|j r|St j d|ttjjjdz }|j r|SdD]<}tj|}|st|dz }|j s:|cS|S)a=Return the directory containing locale YAML files. Resolution order, first existing wins: 1. ``HERMES_BUNDLED_LOCALES`` env var -- set by the Nix wrapper (or any sealed-packaging system) to point at the installed catalog directory. 2. ``/locales`` -- source checkouts and ``pip install -e .``, where the working tree sits next to ``agent/``. 3. ``/locales`` -- pip wheel installs. setuptools ``data-files`` extracts ``locales/*.yaml`` under the interpreter's ``data`` scheme; the other schemes are checked as a safety net for nonstandard layouts. Falling through to the source-style path (even when missing) keeps ``_load_catalog`` error messages informative -- it logs the path it looked at -- rather than raising. HERMES_BUNDLED_LOCALESzlHERMES_BUNDLED_LOCALES points to a non-directory path (%s); falling back to bundled/source locale resolutionlocales)datapurelibplatlib) osgetenvstripris_dirloggerwarning__file__resolveparent sysconfigget_path)override candidate source_dirschemeraws =/root/.hermes/venv/lib/python3.12/site-packages/agent/i18n.py _locales_dirrPXs$yy126<<>HN      ?  h'')0077)CJ1  ( I )       ct|tstS|jj }|stS|t vr|S|t vr t |S|jddd}|t vr|StS)aNormalize a user-supplied language value to a supported code. Accepts supported codes directly, common aliases (``chinese`` -> ``zh``), and case-insensitive regional tags (``zh-CN`` -> ``zh``). Returns the default language for unknown values. -r) isinstancestrDEFAULT_LANGUAGErAlowerrr6split)valuekeybases rO_normalize_langr]s~ eS ! ++-   C  !!   %% 99S! Q D "" rQct5tj|}| |cdddS dddt|dz }|j s1t j d||t5it|<dddiS ddl}|jdd5}|j|xsi}dddi}td |t5|t|<ddd|S#1swYxYw#1swYiSxYw#1swYKxYw#t$rH}t jd||t5it|<dddn #1swYnxYwicYd}~Sd}~wwxYw#1swY|SxYw) zLoad and flatten one locale YAML file into a dotted-key dict. YAML files can be nested for human readability; this produces the flat key space :func:`t` expects. Cached per-language for the process. Nz.yamlz!i18n catalog missing for %s at %srrzutf-8)encodingz"Failed to load i18n catalog %s: %sr:) _catalog_lockr7getrPis_filerCdebugyamlopen safe_load ExceptionrD _flatten_into)langcachedpathrefrNexcflats rO _load_catalogrpsZ ##D)    >tfEN *D <<> 8$E  &#%N4  &  YYsWY - *..#)rC *D#r4 $#t$ K5 &  * * ;T3G  &#%N4  & & & $ KsqC#0 C/DC<2D E#C,/C9<DD EE. E8 EE EEEE&ct|tr:|jD]&\}}|r|d|n t|}t |||(yt|tr|||<yy)N.)rUdictitemsrVri)nodeprefixoutr[rZ child_keys rOririsc$**, 1JC-36(!C5)SI %C 0 1 D# F  rQrT)maxsizec ddlm}|}|jdxsijd}|r t|S y#t$r }t j d|Yd}~yd}~wwxYw)aCRead ``display.language`` from config.yaml once per process. Cached because ``t()`` is called in hot paths (every approval prompt, every gateway reply) and re-reading YAML each call would be wasteful. ``reset_language_cache()`` clears this when config changes at runtime (e.g. after the setup wizard). r) load_configdisplaylanguagez/Could not read display.language from config: %sN)hermes_cli.configr{rbr]rhrCrd)r{cfgrjrns rO_config_language_cachedrsqM1m "(b--j9 "4( (   M FLL Ms=A A+ A&&A+ctjt5tj dddy#1swYyxYw)zInvalidate cached language resolution and catalogs. Call after :func:`hermes_cli.config.save_config` if a running process needs to pick up a changed ``display.language`` without restart. N)r cache_clearrar7clearrQrOreset_language_cachers4 '') s 9Actjjd}|r t|St }|r|St S)z?Resolve the active language using env > config > default order.HERMES_LANGUAGE)r?environrbr]rrW)env_langcfg_langs rO get_languagers9zz~~/0Hx((&(H rQc |r t|n t}t|}|j|}|'|tk7rttj|}|t j d|||}|r |jdi|S|S#tttf$r%}t jd|||||cYd}~Sd}~wwxYw)aATranslate a dotted key to the active language. Parameters ---------- key Dotted path into the catalog, e.g. ``"approval.choose_long"``. lang Explicit language override. Takes precedence over env + config. **format_kwargs ``str.format`` substitution arguments (``t("gateway.drain", count=3)`` expects a catalog entry with a ``{count}`` placeholder). Returns ------- The translated string, or the English fallback if the key is missing in the target language, or the bare key if English is also missing. Nzi18n miss: key=%r lang=%rz3i18n format failed for key=%r lang=%r kwargs=%r: %sr) r]rrprbrWrCrdformatKeyError IndexError ValueErrorrD)r[rj format_kwargstargetcatalogrZrns rOtrs$'+_T " FF#G KK E }#33./33C8 }  0#v> 5<<0-0 0 L *j1  NNEV]C L  s;BC#C=CC)rrWrrr)returnr)rZrrrV)rjrVrr5)rurrvrVrwr5rNone)r str | None)rr)rrV)N)r[rVrjrrrrrV) __doc__ __future__rloggingr?rH threading functoolsrpathlibrtypingr getLogger__name__rCr__annotations__rWr6r7LockrarPr]rprirrrr__all__rrQrOrs<#    8 $(_% t%d%$+T%t %  %(/ %7@ %HOPT %9%'t)%, T-%,d-%,%,T-%2$3%2%d3%2-83%4 T5%4D5%4#.t5%46B45%8t9%8&t9%8.5d9%<=%< =%<(/=%>B-/).  2j0 F 1&)X rQ