PL jb%UdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ej e ZdZded <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`<ejZdydcZdzdgZd{diZd|dnZedopd}drZd~dsZddtZdddwZgdxZdS)aLightweight 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_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/kuhnn/.hermes/hermes-agent/agent/i18n.py _locales_dirrAWs' >> ! ! # # * 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) isinstancerCDEFAULT_LANGUAGEstriplowerrr6split)rBkeybases r@_normalize_langrNas 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_lockr7getrAis_fileloggerdebugyamlopen safe_load Exceptionwarning _flatten_into)rOcachedpathrYfrawexcflats r@ _load_catalogreys ##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.)rGdictitemsrCr^)rfrgrhrLrB child_keys r@r^r^s$**,, 1 1JC-3A6))C)))SI %C 0 0 0 0 1 1 D#  F r?rF)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.configrrrUrNr\rWrX)rrcfgrOrcs r@_config_language_cachedrwsM111111kmm ""(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)rw cache_clearrTr7clearr>r?r@reset_language_cacher{s ''))) sAA A ctjd}|rt|St }|r|St S)z?Resolve the active language using env > config > default order.HERMES_LANGUAGE)osenvironrUrNrwrH)env_langcfg_langs r@ get_languagersJz~~/00H)x(((&((H r?rL 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>) rNrrerUrHrWrXformatKeyError IndexError ValueErrorr])rLrOrtargetcatalogrBrcs r@trs$'+ >_T " " " FF##G KK  E }#333.//33C88 }  0#v>>> 5<00-00 0*j1    NNEV]C   LLLLLL   Ls B((C)?C$C)$C))rrHrrr{)r8r)rBrr8rC)rOrCr8r5)rfrrgrCrhr5r8ri)r8rp)r8ri)r8rC)N)rLrCrOrprrr8rC)__doc__ __future__rloggingr~ threading functoolsrpathlibrtypingr getLogger__name__rWr__annotations__rHr6r7LockrTrArNrer^rwr{rr__all__r>r?r@rs <#"""""   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-/....   >>>>0    F 1&)))))X   r?