i* UdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ej e ZdZded <d Zid d d d d d ddddddddddddddddddddddddddddid dd!dd"dd#d$d%d$d&d$d'd$d(d$d)d$d*d$d+d,d-d,d.d,d/d,d0d,d1d2d3d2d4d2iZd5ed6<iZd7ed8<ejZdQd;ZdRd?ZdSdAZdTdFZedGHdUdJZdVdKZdWdLZdXdYdOZgdPZdS)ZaLightweight 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)enzhjadeesfrtrukztuple[str, ...]SUPPORTED_LANGUAGESrenglishzen-uszen-gbchinesermandarinzzh-cnzzh-twzzh-hanszzh-hantjapaneser jpzja-jpgermanr deutschzde-despanishr uespañolespanolzes-eszes-mxfrenchr u françaisfrancezfr-frzfr-bezfr-cazfr-ch ukrainianr ukrainischuукраїнськаzuk-uauaturkishr utürkçeztr-trdict[str, str]_LANGUAGE_ALIASESzdict[str, dict[str, str]]_catalog_cachereturnrchttjjdz S)zReturn the directory containing locale YAML files. Lives next to the repo root so both the bundled install and editable checkouts find it without PYTHONPATH gymnastics. locales)r__file__resolveparent//home/piyush/.hermes/hermes-agent/agent/i18n.py _locales_dirr+>s' >> ! ! # # * 1I ==r)valuerstrc6t|tstS|}|stS|t vr|S|t vr t |S|ddd}|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) isinstancer-DEFAULT_LANGUAGEstriplowerrr split)r,keybases r*_normalize_langr8Hs eS ! !  ++--    C   !!!   %% 99S!  Q D """ r)langcDt5t|}||cdddS dddn #1swxYwYt|dz }|sGt d||t5it|<dddn #1swxYwYiS ddl}|dd5}| |pi}dddn #1swxYwYn^#t$rQ}t d||t5it|<dddn #1swxYwYicYd}~Sd}~wwxYwi}t|d |t5|t|<dddn #1swxYwY|S) 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: %s) _catalog_lockr!getr+is_fileloggerdebugyamlopen safe_load Exceptionwarning _flatten_into)r9cachedpathrCfrawexcflats r* _load_catalogrO`s ##D))    >>tNNN *D <<>> 8$EEE  & &#%N4  & & & & & & & & & & & & & & &  YYsWY - - *..##)rC * * * * * * * * * * * * * * * ;T3GGG  & &#%N4  & & & & & & & & & & & & & & &  D#r4   $$#t$$$$$$$$$$$$$$$ KsAAA B--B14B1;DC:. D:C>>DC>D E!#E3 E > E E EE EE!E!> FFFnodeprefixoutNonect|trE|D].\}}|r|d|nt|}t |||/dSt|tr|||<dSdS)N.)r1dictitemsr-rH)rPrQrRr6r, child_keys r*rHrHs$**,, 1 1JC-3A6))C)))SI %C 0 0 0 0 1 1 D#  F r)r0)maxsize str | Nonec ddlm}|}|dpid}|rt|Sn2#t$r%}t d|Yd}~nd}~wwxYwdS)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\r?r8rFrArB)r\cfgr9rMs r*_config_language_cachedrasM111111kmm ""(b--j99  )"4(( ( ) MMM FLLLLLLLLM 4sA A A=A88A=ctt5tddddS#1swxYwYdS)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)ra cache_clearr>r!clearr(r)r*reset_language_cacheres ''))) sAA A ctjd}|rt|St }|r|St S)z?Resolve the active language using env > config > default order.HERMES_LANGUAGE)osenvironr?r8rar2)env_langcfg_langs r* get_languagerlsJz~~/00H)x(((&((H r)r6 format_kwargsc |rt|n t}t|}||}|2|tkr'tt|}|t d|||}|rR |jdi|S#tttf$r*}t d|||||cYd}~Sd}~wwxYw|S)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() r8rlrOr?r2rArBformatKeyError IndexError ValueErrorrG)r6r9rmtargetcatalogr,rMs r*trus$'+ >_T " " " FF##G KK  E }#333.//33C88 }  0#v>>> 5<00-00 0*j1    NNEV]C   LLLLLL   Ls B((C)?C$C)$C))rr2rurlre)r"r)r,rr"r-)r9r-r"r)rPrrQr-rRrr"rS)r"rZ)r"rS)r"r-)N)r6r-r9rZrmrr"r-)__doc__ __future__rloggingrh threading functoolsrpathlibrtypingr getLogger__name__rAr__annotations__r2r r!Lockr>r+r8rOrHrarerlru__all__r(r)r*rsp<#"""""   8 $ $'WWWWW % t %d %$+T % t % %'. %6=t %ENPT %V_ae % %D %#*4 % d %t %&-d % t %   % % (1$ % 9@ % HOPT %  d %   % (0 % 8? % GNt % V]^b % elmq % %$T %,B4 %JQRV %Y]^b %t %  % %(/ % %    -/....   >>>>0    F 1&)))))X   r)