L0&j dZddlZddlZddlZddlmZmZddlmZm Z ddl m Z m Z m Z mZddlmZddlmZddlmZmZmZeejZeeZeeZejd Zejd Zd ed efd Z ded e efdZ!d eded efdZ"dZ#d ed e$ee%ffdZ&d e ed e%fdZ'ded e%fdZ(eGddZ)eGddZ*eGddZ+eGddZ,eGdd Z-eGd!d"Z.eGd#d$Z/d%ed e$eeffd&Z0ejd'Z1d(ed e$ee2efdzfd)Z3Gd*d+eZ4hd,Z5d-d.d/d0d1d2Z6e7hd3Z8d4d5d6d7Z9d8ed%ed e%fd9Z:d:ed e$e%effd;Z;d:ed e$e%effd<ZZ>e>e;ez&ReadResult.to_dict..s(TTTA!-AQSGG1GGGr&__dict__itemsselfs r$to_dictzReadResult.to_dicts$TT!4!4!6!6TTTTr&)__name__ __module__ __qualname____doc__rCstr__annotations__rDintrErFr;rGrrHrIrJrKrLrMrlistrPrdictr^r+r&r$rBrBs#%%GSKIsItD(3-ItHd$(NHSM(((#Ix}### $J $$$E8C=$uT:::M49:::UUUUUUUr&rBceZdZUdZdZeed<dZeed<dZ e e e e fed<dZe e ed<dZe e ed <dZe e ed <d efd ZdS) WriteResultzResult from writing a file.r bytes_writtenF dirs_createdNlintlsp_diagnosticsrMwarningrcHd|jDS)Nci|] \}}||| SrSr+rTs r$rXz'WriteResult.to_dict..sHHHA!-1---r&rYr\s r$r^zWriteResult.to_dicts$HH!4!4!6!6HHHHr&)r_r`rarbrjrerdrkr;rlrr rcr rmrMrnrgr^r+r&r$riris%%M3L$%)D(4S> ")))&*OXc])))E8C=!GXc]!!!IIIIIIIr&ric$eZdZUdZdZeed<dZeed<e e Z e eed<e e Z e eed<e e Ze eed <d Zeeeefed <d Zeeed <d Zeeed <defdZd S) PatchResultzResult from patching a file.FsuccessrdiffrNfiles_modified files_created files_deletedNrlrmrMrcd|ji}|jr |j|d<|jr |j|d<|jr |j|d<|jr |j|d<|jr |j|d<|jr |j|d<|jr |j|d<|S) NrsrtrurvrwrlrmrM)rsrtrurvrwrlrmrMr]results r$r^zPatchResult.to_dictsT\* 9 '!YF6N   ;'+':F# $   9&*&8F? #   9&*&8F? # 9 '!YF6N   =(,( ")))%)OXc])))E8C=r&rrc@eZdZUdZeed<eed<eed<dZeed<dS) SearchMatchzA single search match.r= line_numberrCgmtimeN) r_r`rarbrcrdrer~floatr+r&r$r|r|sF  III LLLE5r&r|ceZdZUdZeeZeee d<eeZ ee e d<ee Z ee efe d<dZee d<dZee d <d Zee e d <d e fd Zd S) SearchResultzResult from searching.rNmatchesfilescountsr total_countFrFNrMrcd|ji}|jrd|jD|d<|jr |j|d<|jr |j|d<|jrd|d<|jr |j|d<|S) Nrc8g|]}|j|j|jdS))r=r!rCr=r}rC)rUms r$ z(SearchResult.to_dict..s8!!!19MM!!!r&rrrTrFrM)rrrrrFrMrys r$r^zSearchResult.to_dicts!12 < !!!!!F9  : )"jF7O ; +#{F8  > '"&F;  : )"jF7O r&)r_r`rarbrrfrrr|rdrrcrgrr rerrFr;rMrr^r+r&r$rrs  !&t!-`` segments. Prefer the rightmost numeric separator so a path like ``dir/file-12-name.py-8-context`` resolves to ``dir/file-12-name.py`` line ``8`` instead of truncating at ``file``. rNz-(\d+)-)refinditerstartregroupend)r!r candidater=s r$_parse_search_context_linerYs 44<<t E[T22  }t  D t U[[^^$$d599;;<<&8 88r&czeZdZdZed#dedededefdZededefd Z eded ede fd Z e d$ded edede de f dZedede fdZedede fdZd$dede de fdZededede fdZe d%dedededeededed ed!edefd"ZdS)&FileOperationsz@Abstract interface for file operations across terminal backends.rr=offsetlimitrcdS)z$Read a file with pagination support.Nr+)r]r=rrs r$ read_filezFileOperations.read_filey  r&cdS)a Read the complete file content as a plain string. No pagination, no line-number prefixes, no per-line truncation. Returns ReadResult with .content = full file text, .error set on failure. Always reads to EOF regardless of file size. Nr+r]r=s r$ read_file_rawzFileOperations.read_file_raw~s  r&rCcdS)z8Write content to a file, creating directories as needed.Nr+)r]r=rCs r$ write_filezFileOperations.write_filerr&F old_string new_string replace_allcdS)z,Replace text in a file using fuzzy matching.Nr+)r]r=rrrs r$ patch_replacezFileOperations.patch_replaces  r& patch_contentcdS)zApply a V4A format patch.Nr+)r]rs r$ patch_v4azFileOperations.patch_v4arr&cdS)z>Delete a file. Returns WriteResult with .error set on failure.Nr+rs r$ delete_filezFileOperations.delete_filerr& recursivecP|rtdS||S)zCross-platform delete that handles files and (with recursive=True) directory trees. Default implementation delegates to ``delete_file`` for the non-recursive case; backends with native recursive support should override. z1Recursive delete not implemented for this backendrM)rirr]r=rs r$ delete_pathzFileOperations.delete_paths3  Z%XYYY Y%%%r&srcdstcdS)zSMove/rename a file from src to dst. Returns WriteResult with .error set on failure.Nr+)r]rrs r$ move_filezFileOperations.move_filerr&.N2rpatternr. file_glob output_modecontextc dS)zSearch for content or files.Nr+) r]rr=r.rrrrrs r$searchzFileOperations.searchs r&rrFrrCNrrrCr)r_r`rarbrrcrerBrrrirr;rrrrrrrrrrr+r&r$rrvs?JJ  c 3 3    ^  # *   ^  s S [   ^ */  # 3 C #' 4?   ^  s {   ^      ^ &&&&&&&& S s {   ^ BKOP<=  c  C "3- 7: IL  69 BN   ^   r&r>.bmp.gif.ico.jpg.png.jpeg.webpz python -m py_compile {file} 2>&1znode --check {file} 2>&1znpx tsc --noEmit {file} 2>&1zgo vet {file} 2>&1zrustfmt --check {file} 2>&1).pyz.js.ts.go.rs>rrr)z/this is not the tsc command you are looking forz%could not determine executable to runznot found in npm registry)zno input filename givenzerror: not a workspace)zcannot find packagezgo: cannot find main module)npxrustfmtgobase_cmdct|}|sdS|tfd|DS)aUReturn True iff ``output`` from ``base_cmd`` indicates the linter itself couldn't run (a tooling gap), as opposed to a real lint error in the file being checked. ``base_cmd`` is the first word of the linter command line (``npx``, ``rustfmt``, ``go``, ...). ``output`` is the stdout/stderr captured from running it. Fc3 K|]}|vV dSrSr+)rUplowers r$ z._looks_like_linter_unusable..s',,aqEz,,,,,,r&)_LINTER_UNUSABLE_PATTERNSgetrany)rrpatternsrs @r$_looks_like_linter_unusablersU),,X66H u LLNNE ,,,,8,,, , ,,r&rCc ddl} ||dS#|j$r'}dd|jd|jd|jdfcYd}~Sd}~wt $r%}dt|jd |fcYd}~Sd}~wwxYw) z;In-process JSON syntax check. Returns (ok, error_message).rNTrFzJSONDecodeError:  (line , column ): ) jsonloadsJSONDecodeErrormsglinenocolno Exceptiontyper_)rC_jsones r$_lint_json_inprocrs1 Gx  VVVU!%UUUU17UUUUUUUUUU 111a)00Q0000000001s, A;A A; A;A60A;6A;c ddl}n#t$rYdSwxYw ||dS#|j$r}dd|fcYd}~Sd}~wt$r%}dt |jd|fcYd}~Sd}~wwxYw)uIn-process YAML syntax check. Returns (ok, error_message). Skipped gracefully if PyYAML isn't installed — YAML parsing is optional. rNT__SKIP__rFz YAMLError: r)yaml ImportError safe_load YAMLErrorrrr_)rC_yamlrs r$_lint_yaml_inprocr*s       1    x ?((('A''''''''' 111a)00Q0000000001s8 0 A8AA8 A8A3-A83A8c ddl}n(#t$r ddl}n#t$rYYdSwxYwYnwxYw ||dS#t$r%}dt |jd|fcYd}~Sd}~wwxYw)zddl} ||dS#t$rH}|jrd|jd|jdnd}dt |jd |j|fcYd}~Sd}~wt$r%}dt |jd |fcYd}~Sd}~wwxYw) uIn-process Python syntax check via ast.parse. Catches SyntaxError, IndentationError, and everything else the ast module rejects — matching py_compile's scope but with no subprocess overhead and no dependency on a ``python`` in PATH. rNrrrrrFr) astparse SyntaxErrorrrrr_rr)rC_astrlocs r$_lint_python_inprocrNs1 7x ::::;(J666186666a)99QU9C999999999 111a)00Q0000000001s, B=A*$B* B7BBB)rz.jsonz.yamlz.ymlz.tomliirrrvaluedefaultcT t|S#ttf$r|cYSwxYw)z8Best-effort integer coercion for tool pagination inputs.)re TypeError ValueError)rrs r$ _coerce_intrws<5zz z "s ''rrcddlm}|}tdt|t}t|t }tdt ||}||fS)aReturn safe read_file pagination bounds. Tool schemas declare minimum/maximum values, but not every caller or provider enforces schemas before dispatch. Clamp here so invalid values cannot leak into sed ranges like ``0,-1p``. The upper bound on ``limit`` comes from ``tool_output.max_lines`` in config.yaml (defaults to the module-level ``MAX_LINES`` constant). r) get_max_linesr)tools.tool_output_limitsrmaxrDEFAULT_READ_OFFSETDEFAULT_READ_LIMITmin)rrr max_linesnormalized_offsetnormalized_limits r$normalize_read_paginationr$st766666 IA{63FGGHH"5*<==1c"2I>>?? . ..r&ctdt|t}tdt|t}||fS)zCReturn safe search pagination bounds for shell head/tail pipelines.rr)rrDEFAULT_SEARCH_OFFSETDEFAULT_SEARCH_LIMIT)rrr"r#s r$normalize_search_paginationr(sFA{63HIIJJ1k%1EFFGG . ..r&ceZdZdZdMdefdZ dNdededededef d Zd ede fd Z dMd ed ede fdZ d ede fdZ dOdededefdZ d edefdZdedefdZd ededdfdZdMd edeedeefdZdMd edeede fdZdedededefdZdPd ed!ed"edefd#Zd edefd$Zd edefd%Zd edefd&ZdQd ed(e defd)Zd ed(e defd*Zd+ed,edefd-Zd ededefd.Z dQd ed/ed0ed1e def d2Z d3edefd4Z!dMd edeede"fd5Z# dMd edeed6eede"fd7Z$de fd8Z%d9ede fd:Z&d ede fd;Z'd eddfd<Z(ddd=d edeed6eedefd>Z) dRdBed edCedDeed"ed!edEedFede*fdGZ+dBed ed"ed!ede*f dHZ,dBed ed"ed!ede*f dIZ-dBed edDeed"ed!edEedFede*fdJZ.dBed edDeed"ed!edEedFede*fdKZ/dBed edDeed"ed!edEedFede*fdLZ0dS)SShellFileOperationsz File operations implemented via shell commands. Works with ANY terminal backend that has execute(command, cwd) method. This includes local, docker, singularity, ssh, modal, and daytona environments. Ncwdc||_|p2t|ddp!tt|ddddpd|_i|_dS)u Initialize file operations with a terminal environment. Args: terminal_env: Any object with execute(command, cwd) method. Returns {"output": str, "returncode": int} cwd: Optional explicit fallback cwd when the terminal env has no cwd attribute (rare — most backends track cwd live). Note: Every _exec() call prefers the LIVE ``terminal_env.cwd`` over ``self.cwd`` so ``cd`` commands run via the terminal tool are picked up immediately. ``self.cwd`` is only used as a fallback when the env has no cwd at all — it is NOT the authoritative cwd, despite being settable at init time. Historical bug (fixed): prior versions of this class used the init-time cwd for every _exec() call, which caused relative paths passed to patch/read/write to target the wrong directory after the user ran ``cd`` in the terminal. Patches would claim success and return a plausible diff but land in the original directory, producing apparent silent failures. r+Nconfig/)envgetattrr+_command_cache)r] terminal_envr+s r$__init__zShellFileOperations.__init__se0  V',t<<V7<4@@%NNVRU 02r&commandtimeout stdin_datarci}|r||d<|||d<|pt|jddp|j}|jj|fd|i|}t |dd|dd S) uExecute command via terminal backend. Args: stdin_data: If provided, piped to the process's stdin instead of embedding in the command string. Bypasses ARG_MAX. Cwd resolution order (critical — see class docstring): 1. Explicit ``cwd`` arg (if provided) 2. Live ``self.env.cwd`` (tracks ``cd`` commands run via terminal) 3. Init-time ``self.cwd`` (fallback when env has no cwd attribute) This ordering ensures relative paths in file operations follow the terminal's current directory — not the directory this file_ops was originally created in. See test_file_ops_cwd_tracking.py. r5Nr6r+rr returncoder)rr)r0r/r+executerr)r]r4r+r5r6kwargs effective_cwdrzs r$_execzShellFileOperations._execs"  ( 'F9   !#-F< Iwtx==I !!'GG}GGG::h++jjq11    r&cmdc||jvr>|d|d}|jdk|j|<|j|S)z6Check if a command exists in the environment (cached).z command -v z >/dev/null 2>&1 && echo 'yes'yes)r1r<rr)r]r=rzs r$ _has_commandz ShellFileOperations._has_commands[ d) ) )ZZ Qc Q Q QRRF'-}':':'<'<'ED  $"3''r&r=content_samplectj|d}|tvrdS|rEt d|ddD}|t t|dz dkSdS)z Check if a file is likely binary. Uses extension check (fast) + content analysis (fallback). rTc3HK|]}t|dk|dvdVdS) z rN)ord)rUcs r$rz8ShellFileOperations._is_likely_binary..sJ E Ea"%a&&2++!82C2C!"2C2C2C2C E Er&Nig333333?F)osr=splitextrr sumr r7)r]r=rAext non_printables r$_is_likely_binaryz%ShellFileOperations._is_likely_binarys gt$$Q'--// # # #4  I E E>%4%+@ E E EEEM 3s>':':D#A#AADH Hur&ctj|d}|tvS)z2Check if file is an image we can return as base64.r)rGr=rHrIMAGE_EXTENSIONS)r]r=rJs r$ _is_imagezShellFileOperations._is_images4gt$$Q'--//&&&r&rrC start_linecddlm}|}|d}g}t||D]?\}}t ||kr |d|dz}||d|@d|S)uJAdd line numbers to content in ``LINE_NUM|CONTENT`` format. The gutter uses a compact ``|`` prefix (e.g. ``34|foo``) rather than a fixed-width zero/space-padded one (`` 34|foo``). The padding was pure token overhead: on dense source the padded gutter cost ~48% more tokens than the bare content and ~16% more than the compact form, because the leading spaces + zero-padding tokenize into extra tokens on every single line. An A/B (Sonnet 4.6, 2 passes) showed the compact gutter matches the padded gutter on line-reference / patch / value-lookup / structure tasks (4/4 both), while dropping line numbers entirely regressed line-referencing (the model hand-counted and was off-by-one, 3/4) — so we keep the numbers, just not the padding. r)get_max_line_lengthr*)rNz... [truncated]|)rrRr enumerater7rr) r]rCrPrRmax_line_lengthlinesnumberedir!s r$_add_line_numbersz%ShellFileOperations._add_line_numberss A@@@@@--// d## j999 + +GAt4yy?**,_,-0AA OOqMM4MM * * * *yy"""r&c|s|S|dr9|d}|jdkr|jr|j}|dkr|S|dr ||ddzS|dd}|d}|dkr |d|n|}|rt jd|rt|d |}|jdkrQ|jr8|j}|dt|zd} || zS|S) z Expand shell-style paths like ~ and ~user to absolute paths. This must be done BEFORE shell escaping, since ~ doesn't expand inside single quotes. ~z echo $HOMErz~/rNr.z[a-zA-Z0-9._-]+zecho ~) r5r<rrrfindr fullmatchr7) r]r=rzhomerest slash_idxusername expand_result user_homesuffixs r$ _expand_pathz ShellFileOperations._expand_pathsr K ??3   2ZZ --F1$$)<)<)>)>$}**,,3;;K__T**+$qrr(?*ABBx IIcNN /8A~~4  ++42 -? J J2%)JJ/B/B/B$C$CM$.!33 8L8R8R8T8T3$1$8$>$>$@$@ !%a#h--&7&8&8!9(611 r&argc:d|ddzdzS)z/Escape a string for safe use in shell commands.'z'"'"'r1)r]rfs r$_escape_shell_argz%ShellFileOperations._escape_shell_argBs"S[[i000366r&rc||}tj|pd}||}|d}d|d|d|zdz}|||S)a"Write ``content`` to ``path`` atomically via temp-file + rename. Streams ``content`` over stdin into a temp file in the SAME directory as ``path`` (so the final ``mv`` is a real rename on the same filesystem, not a non-atomic cross-device copy), preserves the existing file's mode if it exists, then renames over the target. On any failure the temp file is removed so we never leak a partial ``.hermes-tmp`` file next to the user's data, and the original file is left untouched. Content rides stdin so there is no ARG_MAX limit. Returns an :class:`ExecuteResult`; ``exit_code == 0`` means the file was swapped into place atomically. A non-zero exit means nothing was renamed and the original (if any) is intact. rz.hermes-tmp.XXXXXXz set -e; d=z; t=z; tmp="$(mktemp -p "$d" a 2>/dev/null || mktemp "$d/.hermes-tmp.$$.XXXXXX" 2>/dev/null || { tmp="$d/.hermes-tmp.$$"; : > "$tmp" && echo "$tmp"; })"; [ -n "$tmp" ] || { echo "atomic write: could not create temp file" >&2; exit 1; }; trap 'rm -f "$tmp"' EXIT; if [ -e "$t" ]; then m="$(stat -c%a "$t" 2>/dev/null || stat -f%Lp "$t" 2>/dev/null || true)"; [ -n "$m" ] && chmod "$m" "$tmp" 2>/dev/null || true; fi; cat > "$tmp"; mv -f "$tmp" "$t"; trap - EXIT)r6)rirGr=dirnamer<)r]r=rCq_pathparentq_parenttmplscripts r$ _atomic_writez!ShellFileOperations._atomic_writeGs''--&&-#))&11%%&:;; % % %% % % %'+ , /  "zz&Wz555r& pre_contentc|rt|Sd||d}||}|jdks|jsdSt|jS)uDetect the dominant line ending of a file on disk. If ``pre_content`` is already available (we just read the file for lint/LSP purposes), inspect that — zero extra exec calls. Otherwise issue a tiny ``head -c 4096`` to sample the first 4KB. Returns ``"\r\n"`` for CRLF (Windows), ``"\n"`` for LF (Unix), or ``None`` if undetermined (new file, empty file, single-line file with no line break in the first chunk). z head -c 4096 2>/dev/nullrN)r-rir<rrr]r=rrhead_cmd head_results r$_detect_file_line_endingz,ShellFileOperations._detect_file_line_ending}sx  4&{33 3N4#9#9$#?#?MMMjj**  A % %[-? %4";#5666r&c|t|Sd||d}||}|jdks|jsdSt|jS)aLWhether the file on disk starts with a UTF-8 BOM. Uses ``pre_content`` if we already read the file (zero extra exec calls); otherwise issues a tiny ``head -c 3`` to sample just the marker. A missing/empty file returns False (new writes get no BOM unless the caller explicitly includes one). Nz head -c 3 rtrF)r<rir<rrrus r$ _file_has_bomz!ShellFileOperations._file_has_bomss  "K(( (J 6 6t < <JJJjj**  A % %[-? %5 *+++r& old_content new_contentfilenamec|d}|d}tj||d|d|}d|S)z2Generate unified diff between old and new content.Trza/zb/)fromfiletofiler)rdifflib unified_diffr)r]r{r|r} old_lines new_linesrts r$ _unified_diffz!ShellFileOperations._unified_diffsn**D*99 **D*99 # y$(__"??    wwt}}r&rrrc D||}t||\}}d||d}||}|jdkr||St |j} t| }n#t$rd}YnwxYw|tkr | |rtdd|dSd||d}||} t | j} ||| rtd|d S||zd z } d |d | d ||} || } | jdkrtd| jSt | j}|d krt|\}}d||}||}t |j} t| }n#t$rd}YnwxYw|| k}d}|rd| d zd|d| d|d }t|||||||S)a Read a file with pagination, binary detection, and line numbers. Args: path: File path (absolute or relative to cwd) offset: Line number to start from (1-indexed, default 1) limit: Maximum lines to return (default 500, max 2000) Returns: ReadResult with content, metadata, or error info wc -c < rtrTzImage file detected. Automatically redirected to vision_analyze tool. Use vision_analyze with this file path to inspect the image contents.)rIrHrErG head -c 1000 zUBinary file - cannot display as text. Use appropriate tools to handle this file type.rHrErMrzsed -n ',zp' Failed to read file: rzwc -l < Nz Use offset=z to continue reading (showing -z of z lines))rCrDrErFrG)rer$rir<r_suggest_similar_filesr%rrerr MAX_FILE_SIZErOrBrLr9rY)r]r=rrstat_cmd stat_result stat_outputrE sample_cmd sample_result sample_outputend_lineread_cmd read_result read_output_wc_cmd wc_result wc_outputrDrFrGs r$rzShellFileOperations.read_files9  &&1&%@@ Id44T::HHHjj**  A % %..t44 41+2DEE  K--//00II   III  } $ $  >>$   #\  PT%;%;D%A%AOOO  :.. 3M4HII  ! !$ 6 6 #m E>A%RfRRxRRD4J4J44P4PRRjj**  A % %$PK/dev/null | head -50r*dZF<(g?c|d S)Nrr+)xs r$z.?s 1Q4%r&)keycg|]\}}|Sr+r+)rUrfps r$rz>ShellFileOperations._suggest_similar_files..@s...%!R2...r&NzFile not found: )rMrP)rGr=rkbasenamerHrrir<rrrrr5r7setrrrsortrB)r]r=dir_pathr}basename_no_extrJ lower_namels_cmd ls_resultscoredflfscorecommonsimilars r$rz*ShellFileOperations._suggest_similar_filess7??4((/C7##D))'**844Q7gx((+1133^^%% T$00::SSSJJv&&   ! # # (8(>(>(@(@ #%++--33D99 F FWWYY##EEW%%a((+11337L7L7N7NNNEE]]:.. #*2G2G2K2K #EE2%%EE:%%#b''A++EE#RW--a00399;;sBB __s2ww6F6{{c#j//3r77&C&Cc&III "199MM5"',,x*C*C"DEEE  (((..6"1":...+T++!    r&c~||}d||d}||}|jdkr||St |j} t|}n#t$rd}YnwxYw| |rtdd|S|d||d}t |j}| ||rtd|dS|d ||}|jdkrtd |j Stt |j\} } t| | S) zRead the complete file content as a plain string. No pagination, no line-number prefixes, no per-line truncation. Uses cat so the full file is returned regardless of size. rrtrT)rIrHrEru'Binary file — cannot display as text.rcat rr)rCrE)rerir<rrr%rrerrrOrBrLr9) r]r=rrrrErr cat_result raw_contentrs r$rz!ShellFileOperations.read_file_rawGs   &&Hd44T::HHHjj**  A % %..t44 41+2DEE  K--//00II   III  >>$   RttyQQQ Q #]43I3I$3O3O#]#]#]^^ 3M4HII  ! !$ 6 6 )? ZZ Et'='=d'C'C E EFF  1 $ $$OJ r)rer@rir<rirr)r]rrrrzs r$rzShellFileOperations.move_files$$$$s R RA"" R")P)P)P)PQQQQQQ R M$((-- M M0F0Fs0K0K M M    q %Vs%V%V%V%Vv}%V%VWWW W}}r&c||}t|rtd|dStj|d}d}|tvp||}|rGd| |d}| |}|j dkr|j r|j }| ||}|d krt|d }|||rt!|s t"|z}||tj|} d } | r:d | | } | | } | j dkrd } |||} | j dkrtd | j Sd| |d}| |} t+|j }n2#t.$r%t1|d}YnwxYw||||}d}|js|jr||||}|r|}t|| |r|nd|S)uO Write content to a file, creating parent directories as needed. Pipes content through stdin to avoid OS ARG_MAX limits on large files. The content never appears in the shell command string — only the file path does. After the write, runs a post-first / pre-lazy lint check via ``_check_lint_delta()``. If the new content is clean, the lint call is O(one parse). If the new content has errors, the pre-write content is linted too and only errors newly introduced by this write are surfaced — pre-existing problems are filtered out so the agent isn't distracted chasing them. Args: path: File path to write content: Content to write Returns: WriteResult with bytes written, lint summary, or error. Write denied: '(' is a protected system/credential file.rrNrrtrr)Fz mkdir -p TzFailed to write file: rzutf-8rr post_content)rjrkrlrm)rer@rirGr=rHrLINTERS_INPROC_lsp_handles_extensionrir<rrrxr3rzr<r6_snapshot_lsp_baselinerkrqrerrr7encode_check_lint_deltarsr_maybe_lsp_diagnosticsr^)r]r=rCrJrrwant_prerroriginal_endingrmrk mkdir_cmd mkdir_result write_resultrrrj lint_resultrmblocks r$rzShellFileOperations.write_files5.  && D ! ! g%et%e%e%efff f"gt$$Q'--//%) .(LD,G,G,L,L  1 Id44T::HHHH**X..K$))k.@))0 77kJJ f $ $-gv>>G   dK 0 0 *'9J9J *')G ##D)))&&  $DD$:$:6$B$BDDI::i00L%**# "))$88  !Q & &%Sl>Q%S%STTT TId44T::HHHjj**  9 2 8 8 : :;;MM 9 9 9w 7 788MMM 9,,T{Y`,aa *.   (+"5 (//+G0E ("''%*5?$$&&&4+     s&H55,I$#I$rrrc J||}t|rtd|dSd||d}||}|jdkrtd|S|j}t|\}}ddlm } | ||||\} } } } | s| dkr@| pd |} dd lm }|||| ||z }n#t$rYnwxYwt|St|}|rt| |} ||| }|jrtd |jSd||d}||}|jdkrtd |St|j\}}|d ddd}| d ddd}||kr4td|dt#|dt#|dS||| |}|||| }td||g|r|nd|jS)ai Replace text in a file using fuzzy matching. Args: path: File path to modify old_string: Text to find (must be unique unless replace_all=True) new_string: Replacement text replace_all: If True, replace all occurrences Returns: PatchResult with diff and lint results rrrrrtrr)fuzzy_find_and_replacez'Could not find match for old_string in )format_no_match_hintzFailed to write changes: z2Post-write verification failed: could not re-read r)r*r0z#Post-write verification failed for z5: on-disk content differs from intended write (wrote z chars, read back zb chars after normalizing line endings). The patch did not persist. Re-read the file and try again.rTN)rsrtrurlrm)rer@rrrir<rrr9tools.fuzzy_matchrrrr-r3rrMrr7rrr^rm)r]r=rrrrrrCrrr| match_count _strategyrMerr_msgr file_endingr verify_cmd verify_result_verify_bomless_verify_stdout_normalized_new_content_normalizedrtrs r$rz!ShellFileOperations.patch_replaceWs  && D ! ! g%et%e%e%efff fE$0066DDDjj**  A % %%CT%C%CDDD D$  ((  =<<<<<5K5K Z[6 6 2 [)U  .K1$$OOOOG BBBBBB//jRYZZZ    W--- -*'22  L1+{KKKt[99   W%UAS%U%UVVV VGD22488FFF  :..  "a ' '%`Z^%`%`aaa a( (<==$3$;$;FD$I$I$Q$QRVX\$]$]!"-"5"5fd"C"C"K"KDRV"W"W $(? ? ?MdMM566MM011MMM !!';== ,,TwU`,aa  6*5?$$&&&4)8    sC C,+C,rctddlm}m}||\}}|rtd|S|||}|S)a Apply a V4A format patch. V4A format: *** Begin Patch *** Update File: path/to/file.py @@ context hint @@ context line -removed line +added line *** End Patch Args: patch_content: V4A format patch string Returns: PatchResult with changes made r)parse_v4a_patchapply_v4a_operationszFailed to parse patch: r)tools.patch_parserrrrr)r]rrr operations parse_errorrzs r$rzShellFileOperations.patch_v4asm( MLLLLLLL"1/-"@"@ K  N%L{%L%LMMM M&%j$77 r&c`tj|d}t|}||Ud||d}||}|jdkrtdd|d S|j }||\}}|d krtdd |d  St||rd n|S|tvrtdd|d S|tvr*| |rtdd|d St|} | d} || std| d S| d||} || d} | jdkrt#| | j rzddlm} | | j }t+d|D|dd}td| d|dd St| jdk| j r| j nd S)u8 Run syntax check on a file after editing. Prefers the in-process linter for structured formats (JSON, YAML, TOML) when possible — those parse via the Python stdlib in microseconds and don't require a subprocess. Falls back to the shell linter table for compiled/type-checked languages (py_compile, node --check, tsc, go vet, rustfmt). Args: path: File path (used to select the linter + for shell invocation). content: Optional file content. If provided AND an in-process linter matches the extension, we lint the content directly without re-reading the file from disk. Ignored for shell linters. Returns: LintResult with status and any errors. rNrrtrTzFailed to read z for lint)rrrzNo linter available for z (missing dependency)rrsrzNo linter for z fileszLSP server handles u — shell linter skippedz not availablez{file}rr5) strip_ansic3fK|],}||V-dSrSrrUlns r$rz2ShellFileOperations._check_lint..;s7IIbhhjjIIIIIIIr&xz not usable: )rGr=rHrrrrir<rrrLINTERS_SHELL_LINTER_LSP_REDUNDANT_lsp_will_handlerr@rrtools.ansi_striprrnextr)r]r=rCrJinprocrrrerr linter_cmdrr=rzrr# first_lines r$ _check_lintzShellFileOperations._check_lints(gt$$Q'--// ##C((  L$"8"8">">LLL"jj22 (A--%d<]d<]<]<]^^^^%,fWooGBj  !$8mSV8m8m8mnnnnbr1BsCCC C g  d4PS4P4P4PQQQ Q - - -$2G2G2M2M -LcLLL  S\ ##%%a(  ** Qdx4O4O4OPPP P  4+A+A$+G+GHHC,,  q %@6=%Y%Y 4 3 3 3 3 3 j//5577GIIg&8&8&:&:III J#DD*TcT2BDD  $),2M,?,?,A,AI6=&&(((r    r&rc|||}|js|jr|S||S|||}|js|js|js|Sd|jDfd|jD}|st d|jdSt ddd |z S) u\ Run post-write syntax lint with pre-write baseline comparison. Two-tier strategy: 1. **Syntax check** (in-process or shell-based, microseconds). Catches the bug class that motivated this layer: corrupt writes, mashed quotes, truncated output. Hot path. 2. **Delta refinement against pre-write content** when the syntax tier reports errors. Filter out errors that already existed pre-edit so the agent isn't distracted by inherited state. Semantic diagnostics from the LSP layer are fetched separately via :meth:`_maybe_lsp_diagnostics` and surfaced in the ``lsp_diagnostics`` field on :class:`WriteResult` / :class:`PatchResult`. Keeping the two channels separate lets the agent (and any downstream parsers) read syntax errors and semantic errors as independent signals. Args: path: File path (for linter selection). pre_content: File content BEFORE the write. Pass None for new files or when the pre-state isn't available — the delta refinement is skipped and all post errors are returned. post_content: File content AFTER the write. Optional; if None, the shell linter reads from disk (same as _check_lint). Returns: LintResult. ``output`` contains either the full post-lint errors (no pre-state) or just the new-error lines (delta refinement applied). )rCNc^h|]*}||+Sr+rrs r$ z8ShellFileOperations._check_lint_delta..s-PPPBRXXZZPRXXZZPPPr&chg|].}||v,|/Sr+r)rUr pre_liness r$rz9ShellFileOperations._check_lint_delta..s9jjjRrxxzzjbhhjj`iNiNibNiNiNir&Fu^Pre-existing lint errors — this edit didn't introduce new ones but the file is still broken.)rsrrzLNew lint errors introduced by this edit (pre-existing errors filtered out): r*r)rrsrrrrr)r]r=rrrpostpre post_linesrs @r$rz%ShellFileOperations._check_lint_deltaHs-Ll;; < 4< K  Kt[99 ; #+ SZ KQP#**?*?*A*APPP jjjj4;#9#9#;#;jjj  {x  8:>))J:O:OP    r&c~t|dd}|dS ddlm}n#t$rYdSwxYwt ||S)u}Return True iff this FileOperations is wired to a local backend. LSP servers run on the host process — they need access to the files they're linting. Remote/sandboxed backends (Docker, Modal, SSH, Daytona) keep files inside the sandbox where the host-side LSP server can't reach them, so we skip the LSP path for those entirely. r/NFr)LocalEnvironment)r0tools.environments.localr r isinstance)r]r/r s r$_lsp_local_onlyz#ShellFileOperations._lsp_local_onlysndE4(( ;5  A A A A A A A   55 #/000s  ,,rJc|sdS ddlm}n#t$rYdSwxYw|}|D]}||jvrdSdS)uReturn True iff some registered LSP server claims this extension. Used to decide whether to capture pre-write content for the line-shift map. Capturing is cheap (one ``cat`` on the host) but pointless if no LSP would ever look at the file. Safe to call on remote backends — the registry is purely in-process metadata; we still gate the actual LSP path on :meth:`_lsp_local_only`. Fr)SERVERST)agent.lsp.serversrrr extensions)r]rJr ext_lowersrvs r$rz*ShellFileOperations._lsp_handles_extensions 5  1 1 1 1 1 1 1   55 IIKK   CCN**tt+us  c |sdS ddlm}n#t$rYdSwxYw |}n#t$rYdSwxYw|dS t ||S#t$rYdSwxYw)u!Return True iff the LSP service is active AND will lint this file. Stronger than :meth:`_lsp_handles_extension` — that one only checks the static server registry. This one additionally requires the LSP service to be configured/enabled and the file to pass :meth:`agent.lsp.manager.LSPService.enabled_for` (which gates on workspace detection, disabled-server set, and the broken-pair short-circuit). Used by :meth:`_check_lint` to decide whether to skip the per-file shell linter for extensions in ``_SHELL_LINTER_LSP_REDUNDANT``. Best-effort: any failure path returns False so the shell linter runs as before — never suppress lint based on an LSP probe that couldn't actually answer the question. Fr get_service)r agent.lsprrr; enabled_forr]r=rsvcs r$rz$ShellFileOperations._lsp_will_handles"##%% 5  - - - - - - -   55  +--CC   55  ;5 --.. .   55 s- -- < A  A !A44 BBc|sdS ddlm}|}n#t$rYdSwxYw|dS ||dS#t$rYdSwxYw)uLCapture pre-edit LSP diagnostics so the post-write delta is correct. Best-effort. Silent on every failure path — LSP is an enrichment layer and must never break a write. Skipped entirely on non-local backends (Docker, Modal, SSH, etc.) — the server can't see files inside the sandbox. Nrr)rrrrsnapshot_baseliners r$rz*ShellFileOperations._snapshot_lsp_baselines##%%  F  - - - - - -+--CC    FF  ; F   ! !$ ' ' ' ' '    DD s) 77A A$#A$rc|sdS ddlm}n#t$rYdSwxYw |}n#t$rYdSwxYw|||sdSd}|.|,||kr& ddlm}|||}n#t$rd}YnwxYw ||d|}n#t$rYdSwxYw|sdS ddlm } m } | ||} | sdS| d | zS#t$rYdSwxYw) uBest-effort LSP semantic diagnostics for ``path``. Returns a formatted ```` block, or empty string when LSP is unavailable / disabled / produced no errors. When both ``pre_content`` and ``post_content`` are provided, a line-shift map is built and passed to the LSPService so baseline diagnostics are remapped into post-edit coordinates before the set-difference. Without this, edits that delete or insert lines surface every pre-existing diagnostic below the edit point as "introduced by this edit". Wraps everything in a try/except so a misbehaving LSP server can't break a write. This intentionally swallows all errors — the calling tier already returned a clean syntax result, so ``""`` here just means "no extra info to add". Skipped entirely on non-local backends (Docker, Modal, SSH, etc.) — same reasoning as ``_snapshot_lsp_baseline``. rrrN)build_line_shiftT)delta line_shift)report_for_filetruncatez)LSP diagnostics introduced by this edit: ) rrrrragent.lsp.range_shiftr get_diagnostics_syncagent.lsp.reporterr#r$) r]r=rrrrrr"r rr#r$rs r$rz*ShellFileOperations._maybe_lsp_diagnosticss6##%% 2  - - - - - - -   22  +--CC   22  ;cood33;2   "|'?KS_D_D_ "BBBBBB--k<HH  " " "!  " 224tPZ2[[KK   22  2  D D D D D D D D#OD+66E r8H5PQQ Q   22 sW -- < A  A 3B BBB22 C?CC. C.. C<;C<rrrrr.rrrc t||\}}||}|d||d} d| jvrt j|pd} t j|} d|g} |d|| d} d| jvr=| r:|d || d }|j d kr|j r| }g}|j d D]q}|s| }||vs!||vs| |d dr3|t j| |r|r3| dd|d dzt!d| d S|dkr|||||S||||||||S)a\ Search for content or files. Args: pattern: Regex (for content) or glob pattern (for files) path: Directory/file to search (default: cwd) target: "content" (grep) or "files" (glob) file_glob: File pattern filter for content search (e.g., "*.py") limit: Max results (default 50) offset: Skip first N results output_mode: "content", "files_only", or "count" context: Lines of context around matches Returns: SearchResult with matches or file list ztest -e z! && echo exists || echo not_found not_foundrzPath not found: ztest -d z && echo yes || echo nor?rz 2>/dev/null | head -20rr*NzSimilar paths: z, rz. rMrr)r(rer<rirrGr=rkrrrrrr5rrr _search_files_search_content)r]rr=r.rrrrrcheckrmbasename_query hint_parts parent_checkrlower_q candidatesentryles r$rzShellFileOperations.searchHs&4FEBB   && ed&<&> >r&c(|dsd|vr|}n|dd}t|}td|jD}|dr|||||S|dstdS|sd nd }|rd |nd } d } |s d |d zd|} d||| d||d| } | | d} | j sJd||| d||d| } | | d} g}| j dD]}|s|d d }t|dkrJ|d dd r||d x|||r|}g}|D]} t||j}n$#t$$rt|j}YnwxYwtd|Dr{||||||z}t|t|S)z-Search for files by name pattern (glob-like).z**/r.c3HK|]}|dvo|dVdS>..rrNr5rUparts r$rz4ShellFileOperations._search_files..sL' '   # <(<(<' ' ' ' ' ' r&rgr\zFile search requires 'rg' (ripgrep) or 'find'. Install ripgrep for best results: https://github.com/BurntSushi/ripgrep#installationrz-not -path '*/.*'rrz | tail -n +rz | head -n zfind z -type f -name z* -printf '%T@ %p\n' 2>/dev/null | sort -rnrrz 2>/dev/null | sort -rnr*rrrc3HK|]}|dvo|dVdSr9r;r<s r$rz4ShellFileOperations._search_files..s8^^Dt;.G4??33G3G^^^^^^r&rr)r5rr rpartsr@_search_files_rgrrir<rrr7risdigitrresolve relative_tor)r]rr=rrsearch_pattern search_roothas_hidden_path_ancestorhidden_excludehidden_filter_exprpagination_exprr=rz cmd_simplerr!rAnormalized_rootfiltered_files file_path rel_partss r$r,z!ShellFileOperations._search_filess!!%(( 4S-?-?$NN$]]3//3N4jj #&' ' #)' ' ' $ $     T " " N((ufMM M  (( K 5MT,,RT5CK1111 ' LKVaZKKEKKOMd,,T22M4FMMW[WmWmn|W}W}MM;JMMC,,}""$$ 8C!7!7!=!=C?QCCbfbxbxzHcIcICC1@CCJZZ BZ77FM''))//55 # #D JJsA&&E5zzQ58#3#3C#<#<#D#D#F#F U1X&&&& T"""" $ :)1133ON" 1 1 6 $Y 7 7 9 9 E Eo V V \II!666 $Y 5III6^^T]^^^^^%%i0000"6&5.#89EE     s9JJ65J6cd|vr|dsd|}n|}||z}d||d||d|}||d}d|jd D} | s~d ||d||d|} || d}d |jd D} | |||z} t | t| t| |k S) adSearch for files by name using ripgrep's --files mode. rg --files respects .gitignore and excludes hidden directories by default, and uses parallel directory traversal for ~200x speedup over find on wide trees. Results are sorted by modification time (most recently edited first) when rg >= 13.0 supports --sortr. r.*zrg --files --sortr=modified -g rz 2>/dev/null | head -n rrcg|]}||Sr+r+rUrs r$rz8ShellFileOperations._search_files_rg..sGGG1QGQGGGr&r*zrg --files -g cg|]}||Sr+r+rTs r$rz8ShellFileOperations._search_files_rg..sKKKqKKKKr&)rrrF)r5rir<rrrrr7) r]rr=rr glob_pattern fetch_limit cmd_sortedrz all_files cmd_plainpages r$rBz$ShellFileOperations._search_files_rgs g  g&8&8&=&= (w==LL"Lfn  'd.D.D\.R.R ' '%%d++ ' '$ ' '  J33GG 3 3 5 5 ; ;D A AGGG  L+!7!7 !E!E++))$//++(++  ZZ 2Z66FKKFM$7$7$9$9$?$?$E$EKKKI./I)nn 3    r&c |dr||||||||S|dr||||||||StdS)z,Search for content inside files (grep-like).r>grepzqContent search requires ripgrep (rg) or grep. Install ripgrep: https://github.com/BurntSushi/ripgrep#installationr)r@_search_with_rg_search_with_grepr)r]rr=rrrrrs r$r-z#ShellFileOperations._search_contents   T " " ''y%(3W>> >   v & & ))'4E6*5w@@ @ \ r&c gd}|dkr$|dt|g|r*|d||g|dkr|dn|dkr|d|||||||dkr||zd zn||z} |d d d t| gd d|z} || d} t | j\} } | jdkrW| sC| p| j pd}td|dS| }|dkr^d| dD}t|}||||z}t||S|dkri}| dD]_}d|vrY| dd}t|dkr0 t|d||d<O#t$rY[wxYw`t|t!|St%jd}g}| dD]}|r|dkr ||}|r|t+|dpd|dzt|d|dd d!"|dkrPt/|}|r?|t+|d|d|dd d!"t|}||||z}t|||||zk#S)$zSearch using ripgrep.)r>z --line-numberz --no-headingz--with-filenamer-Cz--glob files_only-lcount-crrSr,-nset -o pipefail; rrrr Search errorSearch failed: r+cg|]}||Sr+r+rTs r$rz7ShellFileOperations._search_with_rg..LDDDq!DDDDr&r*r@:rrr^([A-Za-z]:)?(.*?):(\d+):(.*)$rrr*NrrrrrF)extendrcrirrr<rrrrrrr7rsplitrerrIvaluesrcompilerr|rrr]rr=rrrrr cmd_partsrWr=rzrr error_msgrrYtotalr[rr!rA _match_rerrparseds r$r^z#ShellFileOperations._search_with_rgsONN  Q;;   dCLL1 2 2 2  L   h(>(>y(I(IJ K K K , & &   T " " " " G # #   T " " " //88999//55666 /6kkefns**uv~ #vtS-=-=>???"CHHY$7$77C,, 7v}EE W  q  #))++Vv}/B/B/D/DVI&C &C&CQRSSS S , & &DDFLLNN$8$8$>$>DDDI NNEVFUN23Dd>>> > G # #F ,,T22 ! !$;; KKQ//E5zzQ!/258}}F58,,)!!! D!v3v}};O;OPPP P #DEEIG ,,T22  tt||OOD))NN;ggajj.B!''!**<$' OO ! 4C4 0$$$ Q;;7==F{!'(.q $*1IdsdO((( LLE6&5.01D!&5.0 sJ'' J43J4c ddg}|d|dkr$|dt|g|r*|d||g|dkr|dn|d kr|d ||||||||z|dkrd ndz} |d d dt| gdd|z} || d} t | j\} } | jdkrW| sC| p| j pd}td|dS| }|dkr^d| dD}t|}||||z}t||S|d kri}| dD]_}d|vrY| dd}t|dkr0 t|d||d<O#t$rY[wxYw`t|t!|St%jd}g}| dD]}|r|dkr ||}|r|t+|dpd|dzt|d |d!d"d#$|dkrPt/|}|r?|t+|d|d|dd"d#$t|}||||z}t|||||zk%S)&zFallback search using grep.r]z-rnHz--exclude-dir='.*'rraz --includerbrcrdrerrSr,rfrgrrrrrhrir+cg|]}||Sr+r+rTs r$rz9ShellFileOperations._search_with_grep..rkr&r*r@rlrrmrnrrr*roNrrrp)rrqrcrirr<rrrrrrr7rrrerrIrsrrtrr|rrrus r$r_z%ShellFileOperations._search_with_grepsV$  -... Q;;   dCLL1 2 2 2  O   k4+A+A)+L+LM N N N , & &   T " " " " G # #   T " " " //88999//55666fnw{{B #vtS-=-=>???"CHHY$7$77C,, 7v}EE W  q  #))++Vv}/B/B/D/DVI&C &C&CQRSSS S , & &DDFLLNN$8$8$>$>DDDI NNEVFUN23Dd>>> > G # #F ,,T22 ! !$;; KKQ//E5zzQ!/258}}F58,,)!!! D!v3v}};O;OPPP P #DEEIG ,,T22  tt||OOD))NN;ggajj.B!''!**<$' OO ! 4C4 0$$$ Q;;7==F{!'(.q $*1IdsdO(((LLE6&5.01D!&5.0 sJ99 KKrS)NNN)rrrr)1r_r`rarbrcr3rerr<r;r@rLrOrYrerirqrrxrzrrBrrrrirrrrrrrrrrrrrrrrrrrr,rBr-r^r_r+r&r$r*r*sk!2!2#!2!2!2!2FCG $  S s C  )6    @((((((c3$$'c'd'''' #####c####4######J7S7S7777 46#464646464646l77S7x}7X`adXe7777*,,#,HSM,T,,,,"  3 # RU    _ _ c_ 3_ 3_ _ _ _ _ B2 32 :2 2 2 2 h% #% *% % % % N:: ::::>>>>>>>>)3)4)K))))V S s {    $T sT ST [T T T T v+0y y #y 3y Cy #'y 4?y y y y vs{=>c=>=>C=>"3-=>7:=>IL=>=>69=>BN=>=>=>=>~P SP P CP P Q]P P P P d) ) 3) s) C) T`) ) ) ) Vs#(3-",/>ALOT`"psp#p(3-p"p,/p>ApLOpT`ppppdmmCmHSMm!$m.1m@CmNQmVbmmmmmmr&r*)KrbrGrrabcrr dataclassesrrtypingrrr r pathlibr tools.binary_extensionsr agent.file_safetyr rrr?rcr^_HOMEWRITE_DENIED_PATHSWRITE_DENIED_PREFIXESrtrrr%r-r3r6tupler;r9r<r@rBrirrr|rrrrrrerrrNr frozensetrrrrrr rr MAX_LINESMAX_LINE_LENGTHrrrr&r'rr$r(r*r+r&r$rs4 ########((((((((,,,,,,,,,,,,555555 IDIKK--e4433E::2:BCC2:LMM"c"c""""" ,#ss:  SU39-58C=5T5555 )3)4)))) UUUUUUU U& IIIIIII I&  >    6              .6C.6E#s(O.6.6.6.6lBJRSS9S9U3S=-AD-H9999:; ; ; ; ; S; ; ; FNMM . % )  (   X(i(=(=(=>>   . -# -s -t - - - - 1s 1uT3Y'7 1 1 1 11s1uT3Y'71111&1s1uT3Y'71111"11tSy)911110         sSS-@+=//c/%(/BGS/////&/D-A///'*/FKCQTHo////ZZZZZ.ZZZZZr&