Pmj)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\dZd]d^d^d^d^d^d^d^d_Zd`eda<iZdbedc<ejZd|dfZd}djZd~dlZddqZedrsdduZddvZddwZdddzZgd{ZdS)a@Lightweight 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, zh-hant, ja, de, es, fr, tr, uk, af, ko, it, ga, pt, ru, hu, ar. Unknown values fall back to en. ) annotationsN) lru_cache)Path)Any)enzhzh-hantjadeesfrtrukafkoitgaptruhuarztuple[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-huarabicr)uالعربيةzar-sazar-egzar-aezar-mazar-dzdict[str, str]_LANGUAGE_ALIASESzdict[str, dict[str, str]]_catalog_cachereturnrc>tjdd}|r@t|}|r|St d|ttj j dz }|S)a4Return 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 editable installs, where the working tree sits next to ``agent/``. 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) osgetenvstripris_dirloggerwarning__file__resolveparent)override candidate source_dirs 0/home/thesage/.hermes/hermes-agent/agent/i18n.py _locales_dirrL[sy1266<<>>H NN        ?    h''))07)CJ 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) isinstancerODEFAULT_LANGUAGErAlowerrr8split)rNkeybases rK_normalize_langrYys eS ! !  ++--    C   !!!   %% 99S!  Q D """ rMlangcDt5t|}||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: %sr=) _catalog_lockr9getrLis_filerCdebugyamlopen safe_load ExceptionrD _flatten_into)rZcachedpathrbfrawexcflats rK _load_catalogrms ##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.)rSdictitemsrOrf)rnrorprWrN child_keys rKrfrfs$**,, 1 1JC-3A6))C)))SI %C 0 0 0 0 1 1 D#  F rMrR)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_config_readonlydisplaylanguagez/Could not read display.language from config: %sN)hermes_cli.configrzr_rYrerCra)rzcfgrZrks rK_config_language_cachedrsM::::::""$$ ""(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)r cache_clearr^r9clearrMrKreset_language_cachers ''))) sAA A ctjd}|rt|St }|r|St S)z?Resolve the active language using env > config > default order.HERMES_LANGUAGE)r?environr_rYrrT)env_langcfg_langs rK get_languagersJz~~/00H)x(((&((H rMrW 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) rYrrmr_rTrCraformatKeyError IndexError ValueErrorrD)rWrZrtargetcatalogrNrks rKtrs$'+ >_T " " " FF##G KK  E }#333.//33C88 }  0#v>>> 5<00-00 0*j1    NNEV]C   LLLLLL   Ls B((C)?C$C)$C))rrTrrr)r:r)rNrr:rO)rZrOr:r7)rnrrorOrpr7r:rq)r:rx)r:rq)r:rO)N)rWrOrZrxrrr:rO)__doc__ __future__rloggingr? threading functoolsrpathlibrtypingr getLogger__name__rCr__annotations__rTr8r9Lockr^rLrYrmrfrrrr__all__rrMrKrsO>#"""""   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"%<="%< ="%<(/="%@ dA"%"%@'+ D4$C"%"%"%""""H-/....   <0    F 1&)))))X   rM