#j+-UdZddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z ej eZdZded <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_cachereturnrctjdd}|r@t|}|r|St d|ttj j dz }|r|SdD]C}tj |}|st|dz }|r|cSD|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 //home/ubuntu/.hermes/hermes-agent/agent/i18n.py _locales_dirrQXs$y1266<<>>H NN        ?    h''))07)CJ1 ((  II )           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) isinstancerTDEFAULT_LANGUAGErBlowerrr6split)rSkeybases rP_normalize_langr^s eS ! !  ++--    C   !!!   %% 99S!  Q D """ rRlangcDt5t|}||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_lockr7getrQis_filerDdebugyamlopen safe_load ExceptionrE _flatten_into)r_cachedpathrgfrOexcflats rP _load_catalogrqs ##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.)rXdictitemsrTrk)rrrsrtr\rS child_keys rPrkrks$**,, 1 1JC-3A6))C)))SI %C 0 0 0 0 1 1 D#  F rRrW)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~rdr^rjrDrf)r~cfgr_ros rP_config_language_cachedrsM111111kmm ""(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_clearrcr7clearrRrPreset_language_cachers ''))) sAA A ctjd}|rt|St }|r|St S)z?Resolve the active language using env > config > default order.HERMES_LANGUAGE)r@environrdr^rrY)env_langcfg_langs rP get_languagersJz~~/00H)x(((&((H rRr\ 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) r^rrqrdrYrDrfformatKeyError IndexError ValueErrorrE)r\r_rtargetcatalogrSros rPtrs$'+ >_T " " " FF##G KK  E }#333.//33C88 }  0#v>>> 5<00-00 0*j1    NNEV]C   LLLLLL   Ls B((C)?C$C)$C))rrYrrr)r8r)rSrr8rT)r_rTr8r5)rrrrsrTrtr5r8ru)r8r|)r8ru)r8rT)N)r\rTr_r|rrr8rT) __doc__ __future__rloggingr@rI threading functoolsrpathlibrtypingr getLogger__name__rDr__annotations__rYr6r7LockrcrQr^rqrkrrrr__all__rrRrPrs-<#"""""   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-/....   2222j0    F 1&)))))X   rR