+ lHj (Rt^RIt^RIt^RIt^RIt^RIt^RIHt^RIH t H t ]P!R4t ]R] R]P/RRll4t]R 3R R lltR R ltR4t]P(!R4tRRltRRltRRltRRltRRlt]!0R5m4t]0R6m,tRRltR7RRlltRRlt RR lt!R!R"lt"R#R$lt#] R%R&l4t$] R'R(l4t$R)R*lt$R+R,lt%R-R/R.R/llt&R8R0R1llt'R2R3lt(R#)9aTerminal backend configuration: scope-aware TERMINAL_* reads, env-var parsing, container-cwd sanity checks, plugin-backend classification, and the ``_quiet`` best-effort block shared by the terminal_tool_* modules. Split out of ``tools/terminal_tool.py``; every public/patched name is re-imported there, so ``tools.terminal_tool.`` keeps resolving (and monkeypatching) as before. N)contextmanager)Anyoverloadztools.terminal_toolexclevelc0V^8dQhR\R\/#)labelr)strint)formats"?/home/ubuntu/.hermes/hermes-agent/tools/terminal_tool_config.py __annotate__rs77#7C7c'h"RxR# Td\P!Y .TO5RR/R#i;i5i)zBest-effort block: swallow *exc*, log *label* (``%``-formatted with *args*) at *level* with the traceback. For janitor/advisory work that must never take the terminal tool down.Nexc_infoT)loggerlog)r rrargss&$$*r _quietrs1 7 7 56$667s2 2!/2/2integercHV^8dQhR\R\R\R\/#)rnamedefault converter type_label)r r)r s"r rr s(     s  s  c  rc VPR4'd \W4M\P!W4pV!V4# \\ P 3d\ RT RT: RT R24hi;i)zParse an env var with *converter*, raising a clear ValueError on bad values (e.g. TERMINAL_TIMEOUT=5m) instead of an opaque crash. TERMINAL_* names are read scope-aware via :func:`_tenv`. TERMINAL_zInvalid value for z: z (expected z1). Check ~/.hermes/.env or environment variables.) startswith_tenvosgetenv ValueErrorjsonJSONDecodeError)rrrrraws&&&& r _parse_env_varr& s{#'//+">">% BIIdD\C ~ ,, -  b{:,G= >   s A2A4c$V^8dQhR\/#)rreturnr )r s"r rr.s@@c@rc\P!4# \\3d6\ R4;'g \P P R4u#i;i)z``os.getcwd()`` tolerant of a deleted cwd (FileNotFoundError) or a macOS TCC-protected one without Full Disk Access (PermissionError); falls back to TERMINAL_CWD, then the home directory. TERMINAL_CWD~)r getcwdFileNotFoundErrorPermissionErrorrpath expanduserrr _safe_getcwdr3.sL@yy{  /@^$??(:(:3(??@s"A AAz^[A-Za-z]:[\\/]c0V^8dQhR\R\/#rr0r(r bool)r s"r rr>sVVsVtVrcxVP\4;'g\\P V44#N)r_HOST_CWD_PREFIXESr7_WINDOWS_DRIVE_REmatchr0s&r _is_host_cwdr>>s+ ??- . U U$7H7N7Nt7T2UUrc0V^8dQhR\R\/#r5r6)r s"r rrBs>>>>rcd\V4;'d\\PV44#)z@True for any ``D:\...`` / ``e:/...`` path. Not a username check.)r7r;r<r=s&r _is_windows_drive_pathrABs% : = =$066t<==rc0V^8dQhR\R\/#r5r))r s"r rrGs    rcT;'gRPRR4p\V4^8d4V^,R8Xd&V^,P4VR,,p\V4^8dVPR4pV#)zCompare host paths without caring about slash style or drive-letter case. A trailing slash is not significant, except we never collapse a drive root (``C:/``) into a bare ``C:`` that would prefix-match every path on that drive. \/::NN)replacelenlowerrstrip)r0texts& r _host_path_keyrNGsg JJB  c *D 4yA~$q'S.Aw}}b) 4y1}{{3 Krc VV^8dQhR\R\R\R\R,/#)rr0 host_rootcontainer_rootr(Nr))r s"r rrUs/**c*c*3*SVY]S]*rc\V\4'd-\V\4'd\V\4'gR#V'dV'd V'gR#\V4p\V4pV'd V'gR#VPR4;'gRpW48XdV#VP R4'dTMVR,pVP V4'gR#V RV\ V4R 2#)zMap *path* onto *container_root* when it is *host_root* or a child of it. Returns None when *path* is not under that host directory. Slash style and drive-letter case do not matter; a sibling directory (``proj`` vs ``proj-other``) is not a child. NrF) isinstancer rNrLendswithrrJ)r0rPrQkeyrootmountprefixs&&& r translate_mounted_host_pathrYUs dC 9c(B(B*UcehJiJi y  C ) $D d  ! !# & - -#E { ]]3''TTCZF >>& ! !WAc#f+,'( ))rc<V^8dQhR\R\R\/#)rcwdrWr(r6)r s"r rrms! 9 9 9C 9D 9rc|V'dV'dW8XdR#\V4'dR#VR8H;'dVR8g#)zTrue when *cwd* was the host workspace (or the assumed ``/workspace`` view of it). An explicit in-container path other than that assumption is left alone. FTz /workspace)_is_unusable_container_cwd)r[rWs&&r cwd_follows_host_mountr^ms6 s|!#&& ,  8 85L#88rc0V^8dQhR\R\/#)renv_typefn_namer))r s"r rr|s  c C rcV'd V\9dV#^RIHp\WA4!V.VO5!# \dTu#i;i)uCall ``agent.terminal_env_registry.(env_type, *args)`` for a plugin backend. Fail-soft: *default* for built-in/empty backends, when the registry is unavailable, or when the provider raises — a misbehaving plugin must never take the terminal tool down.N)_BUILTIN_BACKENDSagent.terminal_env_registryterminal_env_registrygetattr Exception)r`rarrregs&&&* r _plugin_registry_lookupri|sE x#441s$X555 s0 AAc0V^8dQhR\R\/#)rr`attrr))r s"r rrsVVsV#Vrc\VRW!V4#)zJClassification flag of a plugin-registered backend (fail-soft, see above). provider_flagri)r`rkrs&&&r _plugin_env_flagros "8_gW UUrc0V^8dQhR\R\/#)rr`r(r6)r s"r rrsYYCYDYrc<V\9;'g \VR4#)zLTrue for built-in container backends and plugins declaring ``is_container``. is_container)_CONTAINER_BACKENDSror`s&r _is_container_backendrus * * X X.>x.XXrc$V^8dQhR\/#)rr`r))r s"r rrsCCsCrc\VRR4#)z>Return the registered plugin provider for *env_type*, or None. get_providerNrnrts&r _get_plugin_env_providerrys "8^T BBrc>V^8dQhR\R\R,/#)renvr(N)rr )r s"r rrs"]]S]S4Z]rc\VRR4p\V\4'd&\P!V4'd VR8wdV#R#)zThe home a plugin environment started in (``_build_plugin_env`` stamps it per environment, so two sandboxes of one backend never share it), or None._hermes_sandbox_homeNrF)rfrSr posixpathisabs)r{homes& r plugin_sandbox_homers? 3. 5DdC((Y__T-B-Bts{4\X\\rc<V^8dQhR\R\R\/#)rr[r{r()rr7)r s"r rrs!55#5C5D5rc.\V4pV'd3\V\4'd\P!V4'gR#\P !V4\P !V4rW8H;'gVP VR,4#)zTrue for *cwd* at or under *env*'s sandbox home: a ``cd`` inside that sandbox, not a host workspace, even when it looks like one (``/home/...``).FrF)rrSr r~rnormpathr)r[r{rs&& r _in_sandbox_homersh s #D z#s++9??33G3G""4()*<*r r0r)r[rs&$r r]r]s; C..   6 6BGGMM#$6 66rc<V^8dQhR\R\R\/#rrrr(r))r s"r rrs!'''c'3'rc^RIHpV!W4#)aScope-aware read of a ``TERMINAL_*`` variable. Every terminal setting must go through this: under gateway multiplexing the active profile's config arrives via a per-turn scope, and a raw ``os.getenv`` would read whatever a previous turn pinned into the process env (cross-profile leak).) terminal_env)tools.terminal_scoper)rrrs&& r rrs 2  &&rc<V^8dQhR\R\R\/#rr6)r s"r rrs&@@S@3@4@rc:\W4P4R9#)zGScope-aware boolean ``TERMINAL_*`` read: true/1/yes (case-insensitive).>1yestrue)rrK)rrs&&r _tenv_boolrs   % % '+? ??r)z/Users/z/home/>modaldockerdaytonavercel_sandbox>rlocal managed_modal)F)rD))__doc__loggingr#r r~re contextlibrtypingrr getLoggerrrgDEBUGrr r&r3r:compiler;r>rArNrYr^ frozensetrsrcriroruryrrrrr]rrr2rr rs  %    0 17)7'--77>AT]  @+JJ12V> *0 9 PQ'*KK V Y C ]5 E E G GH6"7t7"'@r