+ iHj`* a0t$Rt^RIHt^RIt^RIt^RIt^RIHt^RI H t ^RI H t ^RI Ht^RIHt]P"!]4tRtR]R&Rt/RRbRRbRRbRR bRR bR R bR!R bR"R bR#R bR$R bR%R bR&R bR'R bR(R bR)R bR*R bR+R b/R,R bR-R bR.R bR/R bR0R bR1R bR2R bR3R bR4R bR5R bR6RbR7RbR8RbR9RbR:RbR;RbRRbR?RbR@RbRARbRBRbRCRbRDRbRERbRFRbRGRbRHRbRIRbRJRbRKRbRLRbRMRbC/RNRbRORbRPRbRQRbRRRbRSRbRTRbRURbRVRbRWRbRXRbRYRbRZRbR[RbR\RbR]RbR^RbCR_RR`RRaRRbRRcRRdR/CtRe]Rf&/tRg]Rh&/tRi]Rj&]P4!4tRkRlltRmRnltRRoRplltRRqRrlltRRsRtllt RuRvlt!RwRxlt"RRyRzllt#]PH3R{R|llt%]!^R}7R~Rl4t&RRlt'RRlt(RRlt)RRlt*RRRllt+.ROt,R#)uNLightweight i18n for Hermes' static user-facing strings (approval prompts, gateway replies, CLI, tips). Catalogs are flat dotted-key mappings resolved through layers, top first: 1. plugin language packs (``PluginContext.register_locale``; last registered wins) — ``agent.i18n_layers`` 2. the user overlay ``$HERMES_HOME/locales/.yaml`` of the current profile home 3. the bundled ``locales/.yaml`` 4. the same chain for ``en`` 5. the bare key Every layer may be partial. Language resolution: explicit ``lang=`` > ``HERMES_LANGUAGE`` > ``display.language`` > ``en``; any id that some layer supplies is accepted, so a pack-only language (``pl``) works the moment its plugin loads. ``t()`` is a hot path: one cached merged dict per ``(home, lang)``, invalidated by :func:`reset_language_cache` (which every pack registration calls). ) annotationsN) lru_cache)Path)Any) i18n_layers)language_optionsenzhzh-hantjadeesfrtrukafkoitgaptruhuartuple[str, ...]SUPPORTED_LANGUAGESenglishzen-uszen-gbchinesemandarinzzh-cnzzh-hanszzh-sgztraditional-chinesetraditional_chinesezzh-twzzh-hkzzh-mojapanesejpzja-jpgermandeutschzde-dezde-atzde-chspanishuespañolespanolzes-eszes-mxzes-arfrenchu françaisfrancezfr-frzfr-bezfr-cazfr-ch ukrainian ukrainischuукраїнськаzuk-uauaturkishutürkçeztr-tr afrikaanszaf-zakoreanu 한국어zko-kritalianitalianozit-itzit-chirishgaeilgezga-ie portugueseu português portugueszpt-ptzpt-br brazilian brasileirorussianuрусскийzru-ru hungarianmagyarzhu-huarabicuالعربيةzar-sazar-egzar-aezar-mazar-dzdict[str, str]_LANGUAGE_ALIASESz%dict[tuple[str, str], dict[str, str]]_catalog_cachezdict[str, tuple[str, ...]]_supported_cachecV^8dQhRR/#)returnr)formats"//home/ubuntu/.hermes/hermes-agent/agent/i18n.py __annotate__rCHs>>d>c\\P!RR4P4pV'd+\V4P 4'd \V4#V'd\ P RV4\\4P4PPR, #)zLocale dir: ``HERMES_BUNDLED_LOCALES`` (sealed packaging, e.g. Nix) if it exists, else ``/locales``. The source path is returned even when missing so ``_load_bundled`` can log the path it looked at rather than raise. HERMES_BUNDLED_LOCALESzlHERMES_BUNDLED_LOCALES points to a non-directory path (%s); falling back to bundled/source locale resolutionlocales) osgetenvstripris_dirloggerwarning__file__resolveparent)overrides rB _locales_dirrSHsz yy126<<>HDN))++H~ ?@H  > ! ! # * * 1 1I ==rDcV^8dQhRR/#r>r?strr@)rAs"rBrCrCYs""s"rDc.^RIHp\V!44#)get_hermes_home)hermes_constantsrZrVrYs rB _current_homer\Ys0  !!rDc V^8dQhRRRR/#)r>home str | Noner?rr@)rAs"rBrCrC^s  j O rDcT;'g \4p\;_uu_4\PV4pVe VuuRRR4#RRR4\ \ 4\ P!V4,p\.\V\0, 4O5p\;_uu_4V\V&RRR4V# +'giL{;i +'giT#;i)uEvery language some layer supplies for the current profile home: bundled ∪ user overlay ∪ plugin packs, ``en`` first then sorted. Cached until :func:`reset_language_cache`.N) r\ _catalog_lockr<getsetrrlayered_languagesDEFAULT_LANGUAGEsorted)r^cachedlangsresults& rBsupported_languagesrj^s  " "=?D !%%d+      # ${'D'DT'J JE D1A0B(B!C DF !'  M   MsB=) C= C  C! c$V^8dQhRRRRRR/#)r>valuerr^r_r?r@)rAs"rBrCrCms! / /s /* / /rDc\P!V4pV'gR#\V4pW#9dV#\P V4pWC9dV#VP R^4^,pWS9dV#R#)uCanonical supported id for a user-supplied value (code, alias, regional tag), or ``None`` when no layer supplies it — the validation ``hermes config set display.language`` runs.N-)rnormalize_language_idrjr:rbsplit)rlr^key supportedaliasbases&& rBresolve_language_idrumso  + +E 2C #D)I   ! !# &E  99S! Q D$4.$.rDc$V^8dQhRRRRRR/#)r>rlrr^r_r?rVr@)rAs"rBrCrC}s&@@3@j@C@rDc4\W4;'g\#)zLMap a user-supplied value to a supported code (any layer), else the default.)rure)rlr^s&&rB_normalize_langrx}s u + ? ?/??rDc V^8dQhRRRR/#)r>langrVr?r9r@)rAs"rBrCrCs    rDc\4V R2, pVP4'g\PRW4/#\P !V4# \ d#p\PRY4/uRp?#Rp?ii;i)u_One bundled locale YAML flattened to dotted keys (empty dict on any failure — never crashes).z.yamlz!i18n catalog missing for %s at %sz"Failed to load i18n catalog %s: %sN)rSis_filerMdebugrparse_locale_file ExceptionrN)rzpathexcs& rB _load_bundledrsm >tfEN *D <<>> 8$E ,,T22 ;TG sA B%B<BBc(V^8dQhRRRRRRRR/#) r>noderprefixrVoutr9r?Noner@)rAs"rBrCrCs(+++S+~+$+rDc4\P!WV4R#)z9Flatten a nested mapping into ``out`` (text leaves only).N)rflatten)rrrs&&&rB _flatten_intorsc*rDc$V^8dQhRRRRRR/#)r>rzrVr^r_r?r9r@)rAs"rBrCrCs!   :  rDcT;'g \4pW3p\;_uu_4\PV4pVe VuuRRR4#RRR4\ V4pVP \ P!W44VP \ P!V44\;_uu_4V\V&RRR4V# +'giL;i +'giT#;i)z]Merged catalog for ``lang`` in ``home`` (packs > overlay > bundled); cached per (home, lang).N) r\rar;rbrupdater overlay_layer pack_layer)rzr^rqrgmergeds&& rB _load_catalogrs  " "=?D ,C ##C(     4 F MM+++D78 MM+((./ $s  M   MsC 8 C C  C0 c$V^8dQhRRRRRR/#)r>rzrVsurfacer?r9r@)rAs"rBrCrCs!  #  > rDc\V4p/pV\P8wd VP\ V RV 244VP\P !\ 4W44V#)a>What ``i18n.catalog`` serves for one surface: packs > overlay > bundled ``locales/..yaml``. The core surface omits the bundled layer (the Python renderer already has it); the TUI ships only an English catalog in-tree, so its bundled translations live in ``locales/.tui.yaml`` and ride along here..)rxr CORE_SURFACErrsurface_catalogr\)rzrrs&& rBrrs] 4 DF+*** mtfAgY$789 MM+--motMN MrD)maxsizec V^8dQhRRRR/#)r> hermes_homerVr?r_r@)rAs"rBrCrCs    rDc^RIHpV!4PR4;'g/PR4pV'd \W 4#R# \d"p\ P RT4Rp?R#Rp?ii;i)z``display.language`` from config.yaml, read once per profile home (``t()`` is a hot path). Keyed by home so a multiplexed gateway serving several profiles doesn't freeze the first profile's language for every other profile.)load_config_readonlydisplaylanguageNz/Could not read display.language from config: %s)hermes_cli.configrrbrxrrMr})rrrzrs& rB_config_language_cachedrsd :$&**95;;@@L59t1CtC  FLs'"A A A A A8A33A8cV^8dQhRR/#)r>r?r_r@)rAs"rBrCrCs44*4rDc(\\44#N)rr\r@rDrB_config_languagers "=? 33rDcV^8dQhRR/#)r>r?rr@)rAs"rBrCrCsdrDc\P4\;_uu_4\P 4\ P 4RRR4\ P!4R# +'giL';i)zInvalidate cached language resolution, merged catalogs and every layer view (call after ``save_config`` changes ``display.language``, after a pack registers/unregisters, or after editing an overlay file).N)r cache_clearrar;clearr<r clear_cacher@rDrBreset_language_cachersH'')    s )A++ A; c V^8dQhRRRR/#)r>r^rVr?r@)rAs"rBrCrCsnnCnCnrDc^RIHpHpV!R4pV'd \ W04#\V4;'g\# Td#\PP R4pLTi;i)rX)UnscopedSecretError get_secretHERMES_LANGUAGE) agent.secret_scoperrrIenvironrbrxrre)r^rrenv_langs& rB_resolve_languagers]B5/0/7?8 *m>"345s>&A'&A'cV^8dQhRR/#rUr@)rAs"rBrCrCs..c.rDc(\\44#)aResolve the active language using env > config > default order. ``HERMES_LANGUAGE`` is a per-profile ``.env`` value, so it is read through the secret scope: under multiplexing a raw environ read would impose the default profile's language on every other profile.)rr\r@rDrB get_languagers ]_ --rDc(V^8dQhRRRRRRRR/#)r>rqrVrzr_ format_kwargsrr?r@)rAs"rBrCrCs(3j##rDc \4pV'd \W4M \V4p\WC4P V4pVf+V\ 8wd \\ V4P V4pVf\ PRW4TpV'gV#VP!R/VB# \\\3d$p\ PRYY&4TuRp?#Rp?ii;i)zTranslate a dotted catalog key to the active (or explicit ``lang``) language. ``format_kwargs`` are applied with ``str.format``. Falls back to English, then to the bare key; a format failure returns the unformatted string. Nzi18n miss: key=%r lang=%rz3i18n format failed for key=%r lang=%r kwargs=%r: %sr@) r\rxrrrbrerMr}rAKeyError IndexError ValueErrorrN)rqrzrr^targetrlrs&&, rBtrs ?D,0_T (6G6MF & ' + +C 0E }#33.599#> } 0#>  ||,m,, j* -Lc[hn sB**C#CC#C#)rr r r r r rrrrrrrrrrrr) rerrrrrurjrr)-__conditional_annotations____doc__ __future__rloggingrI threading functoolsrpathlibrtypingragentragent.i18n_languagesr getLogger__name__rMr__annotations__rer:r;r<LockrarSr\rjrurxrrrrrrrrrrr__all__)rs@rBrsQ # 1   8 $(_ % t%d%$+T% t%%'.%6?%GNPT%9%'t% T%d%%,T%$%%d%-8%  T!% D!% #.t!% 6B4!%"t#%"&t#%".5d#%$%%$ %%$(/%%& d'%&%d T7D'4$)%>09;5:/1,1 >""  / @ +  /:.F.F  1  4n.. rD