߲j# dZddlZddlZddlZddlmZmZehdZehdZ dZ de de fd Z dd e de fd Z dd e defd Zdd e de dzfd Zde ezezdefdZde dzde dzfdZde dzfdZdd e de dzfdZdd e de dzfdZde dede fdZde dedeezfdZ dddd e dedzdeezfdZdde d e deezfdZdde ded e de dzfdZy)aPath resolution for the file tools: task-aware base dir, ``~`` expansion, workspace-divergence warning. Core invariant: the base directory anchoring relative paths is ALWAYS absolute and derived from the task's terminal cwd, never from the process cwd unless no other anchor exists (a relative/sentinel ``TERMINAL_CWD`` would silently anchor edits to the agent process cwd, e.g. the main repo during a worktree session). N)Path PurePosixPath>./cwdauto.>modaldockerdaytona singularityvercel_sandbox)localsshr r r r pathreturnc|rd|vr|S ddlm}|}|r@|dk(s|jdr*|dk(r|Stj j ||ddStj j|S#t$rd}YnwxYw)aoExpand ``~`` using the effective profile home (``get_subprocess_home``) so gateway/cron runs, whose process HOME may differ, agree with interactive CLI sessions. This mirrors ``hermes_constants.get_subprocess_home()`` so that ``~`` resolves consistently regardless of whether the tool runs interactively or inside a gateway-driven cron job (#48552). ~r)get_subprocess_homeNz~/)hermes_constantsr Exception startswithosrjoin expanduser)rrhomes ;/home/ubuntu/.hermes/hermes-agent/tools/file_tools_paths.py _expand_tilders 3d? 8"$  5s{tD T48(DD 77  d ## s A88 BBtask_idc ddlm}m}m}m} ||}|5|j |xs|j |}dddd|jjj t fdtDd}t|dd}|st|tr|r|xs|St|j dxstj dxsdjS#t $r|}YwxYw#1swYxYw#t $r3ttj dxsdjcYSwxYw) z@Best-effort terminal backend type for path-resolution decisions.r)_active_environments _env_lock_get_env_config_resolve_container_task_idNc3,K|] }|vs| yw)N).0hnames r z._terminal_env_type_for_task..8sGqQ$YGs _hermes_backend_nameenv_type TERMINAL_ENVr)tools.terminal_toolr"r#r$r%rget __class____name__lowernext_ENV_CLASS_NAME_HINTSgetattr isinstancestrrgetenv) r r"r#r$r% container_keyenvhintstampedr*s @r_terminal_env_type_for_taskr>*s;A Z Z $6w?M _&**=9^=Q=U=UV]=^C _ ?==))//1DG$9GNDc#94@G 7C0Ww&?$((4\ .8Q\U\]ccee $#M $ _ _ A299^,78>>@@AsQ DC5D%DA-D-AD5 DDDDD D9E Ecdt|} ddlm}||S#t$r |tvcYSwxYw)Nr)_is_container_backend)r>r/r@r!_CONTAINER_PATH_BACKENDS_FALLBACK)r r-r@s r_uses_container_pathsrBAs:*73H==$X.. =<<<=s //c2t|r t|SdS)zMThe task's backend name when its file paths belong to a container, else None.N)rBr>)r s rcontainer_backend_for_taskrDKs3H3Q &w /[W[[cPttjt|S)zNormalize path syntax without following host symlinks: container paths are meaningful inside the sandbox, and a host-side ``/workspace`` symlink must not rewrite them.)r posixpathnormpathr8)rs r_normalize_without_host_derefrIPs ++CI6 77rErawct|xsdj}|jtvryt |}t j j|r|SdS)zReturn *raw* expanded when it is a non-sentinel ABSOLUTE anchor, else ``None`` (a relative anchor is exactly the ambiguity that misroutes worktree edits).rN)r8stripr3_TERMINAL_CWD_SENTINELSrrrisabs)rJexpandeds r_sentinel_free_abs_cwdrPVsP ciR.   C yy{--S!Hww}}X.88D8rEc6ddlm}t|xsdS)zReturn ``$TERMINAL_CWD`` only when it names a real (absolute, non-sentinel) anchor. Scope-aware: under gateway multiplexing the routed profile's cwd lives in the per-turn scope.rscope_terminal_cwdN)agent.runtime_cwdrSrPrRs r_configured_terminal_cwdrU`s5 !"4"6">$ ??rEcr ddlm}||}t|j dS#t$rYywxYw)zReturn a registered cwd override keyed by the RAW task id, when available. ``terminal_tool`` collapses CWD-only overrides to the shared ``"default"`` env, but the cwd value stays keyed by the raw session id. r)resolve_task_overridesNr)r/rWrrPr0)r rW overridess r_registered_task_cwd_overriderYis> >*73  ")--"6 77 s * 66cx ddlm}||}|xst|xs t S#t$rd}Y(wxYw)a6Best-effort absolute workspace root, or ``None`` when no reliable anchor exists. Order: (1) the session's own cwd record (per-session, so one session's ``cd`` never leaks into another); (2) a registered raw-keyed cwd override (TUI/Desktop/ACP); (3) a sentinel-free absolute ``$TERMINAL_CWD``. r)get_session_cwdN)r/r[rrYrU)r r[recordeds r_authoritative_workspace_rootr]ysF7"7+  [4W= [AYA[[ s + 99textcontainer_pathsc8|sddlm}||}t|S)zExpand ``~``; on host backends also translate Git Bash ``/c/Users/...`` drive paths before Path sees them. Container/WSL Linux paths are never rewritten.r)_msys_to_windows_path)tools.environments.localrar)r^r_ras r _host_textrcs B$T*  rEc|rDtj|s$tjt||}t |St j dk(rOddl}|j|s |jt||}t|j|St|}|jst||z }|jS)zReturn *text* as an absolute, normalized path, joining it onto ``base()`` when relative. Container: pure-posix, no host deref. Host: resolve() (win32: ntpath normpath).win32rN) rGrNrr8rIsysplatformntpathrrH is_absoluteresolve)r^baser_rhps r_anchorrmst$>>#df+t4D,T22 ||w||D!;;s46{D1DFOOD)** T A ==? L1  99;rEr_ct|}| t|}tt|xst j |tj |S)zReturn the ABSOLUTE base directory for resolving relative paths: ``_authoritative_workspace_root``, else the process cwd as a last resort.)r]rBrmrcrgetcwd)r r_roots r_resolve_base_dirrrsD ) 1D/8 :d1biik?CRYYP_ ``rEfilepathcRttt|fdS)zyResolve *filepath* against the task's absolute base directory (absolute inputs are returned resolved-but-unanchored).ctS)Nrn)rr)r_r srz(_resolve_path_for_task..s,WoVrE)rBrmrc)rsr r_s `@r_resolve_path_for_taskrws-,G4O :h8VXg iirEresolvedcz tt|jryt|}|syt |rt tt|}n"tt|j }|j|ryd|dt|dt|dS#t$rYywxYw)zWarn when a RELATIVE path resolved OUTSIDE the task's workspace root (the edit is about to land in a different checkout than the terminal's cwd). ``None`` for absolute paths, an unknown root, or a path under the root.NzRelative path z resolved to z), which is OUTSIDE the active workspace (z). The edit will land in a different directory than the terminal's cwd. If this is not intended (e.g. a git-worktree session writing into the main checkout), pass an absolute path under the workspace instead.) rrrir]rBrIrjis_relative_tor8r)rsrxr workspace_rootrqs r_path_resolution_warningr|s  h' ( 4 4 66w?  )0mN6S1TUD n56>>@D  " "4 (XL c(m5FG--0YM:L M N s""B. B.AB.B.. B:9B:)default)__doc__rrGrfpathlibrr frozensetrMrAr5r8rr>boolrBrDrIrPrUrYr]rcrmrrrwr|r'rErrs  '$$BC$-.m$n!U$$$(AASA.=3=t=\\C$J\ 8d ](B8}8 9d 9sTz9@#*@ 83 8sTz 8 \3 \sTz \ S4C#dtm7K(a@Da a26+aIMP]I]aiSi3itmG[isdSY\_cYcrE