eiy dZddlZddlZddlZddlmZmZddlmZm Z ddl m Z m Z m Z mZddlmZddlmZddlmZdd lmZmZmZmZeejZeeZeeZ d e efd Z!d ed e"fd Z#eGddZ$eGddZ%eGddZ&eGddZ'eGddZ(eGddZ)eGddZ*GddeZ+hdZ,dd d!d"d#d$Z-d%Z.d%Z/d&Z0d'Z1d(Z2dZ3d)Z4d*ed+e5d e5fd,Z6e1e2fd-ed.ed e7e5e5ffd/Z8e3e4fd-ed.ed e7e5e5ffd0Z9Gd1d2e+Z:dS)3aL File Operations Module Provides file manipulation capabilities (read, write, patch, search) that work across all terminal backends (local, docker, singularity, ssh, modal, daytona). The key insight is that all file operations can be expressed as shell commands, so we wrap the terminal backend's execute() interface to provide a unified file API. Usage: from tools.file_operations import ShellFileOperations from tools.terminal_tool import _active_environments # Get file operations for a terminal environment file_ops = ShellFileOperations(terminal_env) # Read a file result = file_ops.read_file("/path/to/file.py") # Write a file result = file_ops.write_file("/path/to/new.py", "print('hello')") # Search for content result = file_ops.search("TODO", path=".", file_glob="*.py") N)ABCabstractmethod) dataclassfield)OptionalListDictAny)Path)get_hermes_home)BINARY_EXTENSIONS)build_write_denied_pathsbuild_write_denied_prefixesget_safe_write_rootis_write_deniedreturnctS)a\Return the resolved HERMES_WRITE_SAFE_ROOT path, or None if unset. When set, all write_file/patch operations are constrained to this directory tree. Writes outside it are denied even if the target is not on the static deny list. Opt-in hardening for gateway/messaging deployments that should only touch a workspace checkout. )_shared_get_safe_write_root7/home/div/.hermes/hermes-agent/tools/file_operations.py_get_safe_write_rootr9s ' ( ((rpathc t|S)z.Return True if path is on the write deny list.)_shared_is_write_denied)rs r_is_write_deniedrDs "4 ( ((rc$eZdZUdZdZeed<dZeed<dZ eed<dZ e ed<d Z e eed <dZe ed <dZe ed <d Ze eed <d Ze eed<d Ze eed<d Ze eed<eeZeeed<defdZd S) ReadResultzResult from reading a file.contentr total_lines file_sizeF truncatedNhint is_binaryis_imagebase64_content mime_type dimensionserrordefault_factory similar_filesrcHd|jDS)Nc*i|]\}}||gk ||SNr.0kvs r z&ReadResult.to_dict..^s(TTTA!-AQSGG1GGGr__dict__itemsselfs rto_dictzReadResult.to_dict]s$TT!4!4!6!6TTTTr)__name__ __module__ __qualname____doc__r str__annotations__r!intr"r#boolr$rr%r&r'r(r)r*rlistr-rdictr;rrrrrMs#%%GSKIsItD(3-ItHd$(NHSM(((#Ix}### $J $$$E8C=$uT:::M49:::UUUUUUUrrcpeZdZUdZdZeed<dZeed<dZ e e ed<dZ e e ed<d e fd ZdS) WriteResultzResult from writing a file.r bytes_writtenF dirs_createdNr*warningrcHd|jDS)Nci|] \}}||| Sr0rr1s rr5z'WriteResult.to_dict..jsHHHA!-1---rr6r9s rr;zWriteResult.to_dictis$HH!4!4!6!6HHHHr)r<r=r>r?rHrBrArIrCr*rr@rJrEr;rrrrGrGas%%M3L$E8C=!GXc]!!!IIIIIIIrrGc eZdZUdZdZeed<dZeed<e e Z e eed<e e Z e eed<e e Ze eed <d Zeeeefed <d Zeeed <d efdZd S) PatchResultzResult from patching a file.Fsuccessrdiffr+files_modified files_created files_deletedNlintr*rcd|ji}|jr |j|d<|jr |j|d<|jr |j|d<|jr |j|d<|jr |j|d<|jr |j|d<|S)NrOrPrQrRrSrTr*)rOrPrQrRrSrTr*r:results rr;zPatchResult.to_dictxsT\* 9 '!YF6N   ;'+':F# $   9&*&8F? #   9&*&8F? # 9 '!YF6N : )"jF7O r)r<r=r>r?rOrCrArPr@rrDrQrrRrSrTrr r r*rEr;rrrrNrNms&&GTD#NNN %d ; ; ;NDI;;;$uT:::M49:::$uT:::M49:::%)D(4S> ")))E8C=rrNc@eZdZUdZeed<eed<eed<dZeed<dS) SearchMatchzA single search match.r line_numberr gmtimeN) r<r=r>r?r@rArBr[floatrrrrYrYsF  III LLLE5rrYceZdZUdZeeZeee 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.r+matchesfilescountsr total_countFr#Nr*rcd|ji}|jrd|jD|d<|jr |j|d<|jr |j|d<|jrd|d<|jr |j|d<|S) Nrbc8g|]}|j|j|jdS))rliner rrZr )r2ms r z(SearchResult.to_dict..s8!!!19MM!!!rr_r`raTr#r*)rbr_r`rar#r*rVs rr;zSearchResult.to_dicts!12 < !!!!!F9  : )"jF7O ; +#{F8  > '"&F;  : )"jF7O r)r<r=r>r?rrDr_rrYrAr`r@rErar rBrbr#rCr*rr;rrrr^r^s  !&t!r?rOrCrArkrlr@rmrEr;rrrrjrjsw%%GTGTFCGS       rrjc0eZdZUdZdZeed<dZeed<dS) ExecuteResultz&Result from executing a shell command.rstdoutr exit_codeN) r<r=r>r?rsr@rArtrBrrrrrrrs800FCIsrrrcdeZdZdZed!dedededefdZededefd Z eded ede fd Z e d"ded edede de f dZedede fdZedede fdZededede fdZe d#dedededeedededededefd ZdS)$FileOperationsz@Abstract interface for file operations across terminal backends.roffsetlimitrcdS)z$Read a file with pagination support.Nr)r:rryrzs r read_filezFileOperations.read_file  rcdS)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. Nrr:rs r read_file_rawzFileOperations.read_file_raws  rr cdS)z8Write content to a file, creating directories as needed.Nr)r:rr s r write_filezFileOperations.write_filer}rF old_string new_string replace_allcdS)z,Replace text in a file using fuzzy matching.Nr)r:rrrrs r patch_replacezFileOperations.patch_replaces  r patch_contentcdS)zApply a V4A format patch.Nr)r:rs r patch_v4azFileOperations.patch_v4ar}rcdS)z>Delete a file. Returns WriteResult with .error set on failure.Nrrs r delete_filezFileOperations.delete_filer}rsrcdstcdS)zSMove/rename a file from src to dst. Returns WriteResult with .error set on failure.Nr)r:rrs r move_filezFileOperations.move_filer}r.N2rpatterntarget file_glob output_modecontextc dS)zSearch for content or files.Nr) r:rrrrrzryrrs rsearchzFileOperations.searchs rrwrxFrr Nrrr r)r<r=r>r?rr@rBrr|rrGrrCrNrrrrrr^rrrrrvrvsJJ  c 3 3    ^  # *   ^  s S [   ^ */  # 3 C #' 4?   ^  s {   ^      ^  S s {   ^ BKOP<=  c  C "3- 7: IL  69 BN   ^   rrv>.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)z.pyz.jsz.tsz.goz.rsiirwrxrvaluedefaultcT t|S#ttf$r|cYSwxYw)z8Best-effort integer coercion for tool pagination inputs.)rB TypeError ValueError)rrs r _coerce_intrs<5zz z "s ''ryrzcddlm}|}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_linesrw)tools.tool_output_limitsrmaxrDEFAULT_READ_OFFSETDEFAULT_READ_LIMITmin)ryrzr max_linesnormalized_offsetnormalized_limits rnormalize_read_paginationr st766666 IA{63FGGHH"5*<==1c"2I>>?? . ..rctdt|t}tdt|t}||fS)zCReturn safe search pagination bounds for shell head/tail pipelines.rrw)rrDEFAULT_SEARCH_OFFSETDEFAULT_SEARCH_LIMIT)ryrzrrs rnormalize_search_paginationr3sFA{63HIIJJ1k%1EFFGG . ..rceZdZdZddededefdZ d edefdZdedefdZdedededefdZd?d edededefdZd edefdZd edefd Zd edefd!Zd"ed#edefd$Zd ededefd%Z d@d ed'ed(ed)e def d*Zd+edefd,Zd edefd-Z dAd1ed ed2ed3eededed4ed5edefd6Z d1ed edededef d7Z!d1ed edededef d8Z"d1ed ed3eededed4ed5edefd9Z#d1ed ed3eededed4ed5edefd:Z$d1ed ed3eededed4ed5edefd;Z%dS)BShellFileOperationsz 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. rNconfig/)envgetattrr_command_cache)r: terminal_envrs r__init__zShellFileOperations.__init__Cse0  V',t<<V7<4@@%NNVRU 02rcommandtimeout 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. rNrrrlr returncoder)rsrt)rrrexecuterrget)r:rrrrkwargs effective_cwdrWs r_execzShellFileOperations._execfs"  ( 'F9   !#-F< Iwtx==I !!'GG}GGG::h++jjq11    rcmdc||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)rrrsstrip)r:rrWs r _has_commandz ShellFileOperations._has_commands[ d) ) )ZZ Qc Q Q QRRF'-}':':'<'<'ED  $"3''rrcontent_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). rwTc3HK|]}t|dk|dvdVdS) z rwN)ord)r2cs r z8ShellFileOperations._is_likely_binary..sJ E Ea"%a&&2++!82C2C!"2C2C2C2C E ErNig333333?F)osrsplitextlowerr sumrlen)r:rrext non_printables r_is_likely_binaryz%ShellFileOperations._is_likely_binarys gt$$Q'--// # # #4  I E E>%4%+@ E E EEEM 3s>':':D#A#AADH Hurctj|d}|tvS)z2Check if file is an image we can return as base64.rw)rrrrIMAGE_EXTENSIONS)r:rrs r _is_imagezShellFileOperations._is_images4gt$$Q'--//&&&rrwr start_linecddlm}|}|d}g}t||D]@\}}t ||kr |d|dz}||dd|Ad|S) z7Add line numbers to content in LINE_NUM|CONTENT format.r)get_max_line_length )startNz... [truncated]6d|)rrsplit enumeraterappendjoin) r:r rrmax_line_lengthlinesnumberedires r_add_line_numbersz%ShellFileOperations._add_line_numberss@@@@@@--// d## j999 . .GAt4yy?**,_,-0AA OOq,,,d,, - - - -yy"""rc|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~/rwNrz[a-zA-Z0-9._-]+zecho ~) startswithrrtrsrfindre fullmatchr) r:rrWhomerest 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 rargc:d|ddzdzS)z/Escape a string for safe use in shell commands.'z'"'"')replace)r:rs r_escape_shell_argz%ShellFileOperations._escape_shell_args"S[[i000366r old_content new_contentfilenamec|d}|d}tj||d|d|}d|S)z2Generate unified diff between old and new content.T)keependsza/zb/)fromfiletofiler) splitlinesdifflib unified_diffr)r:rr r  old_lines new_linesrPs r _unified_diffz!ShellFileOperations._unified_diffsn**D*99 **D*99 # y$(__"??    wwt}}rrxryrzc ||}t||\}}d||d}||}|jdkr||S t |j}n#t$rd}YnwxYw|tkr | |rtdd|dSd||d}||}| ||jrtd|d S||zd z } d |d | d ||} || } | jdkrtd| jSd||} || } t | j}n#t$rd}YnwxYw|| k}d}|rd| d zd|d| d|d }t|| j|||||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 < 2>/dev/nullrTzImage file detected. Automatically redirected to vision_analyze tool. Use vision_analyze with this file path to inspect the image contents.)r&r%r"r$ head -c 1000 zUBinary file - cannot display as text. Use appropriate tools to handle this file type.r%r"r*rwzsed -n ',zp' Failed to read file: r*zwc -l < Nz Use offset=z to continue reading (showing -z of z lines))r r!r"r#r$)rrrrrt_suggest_similar_filesrBrsrr MAX_FILE_SIZErrrr)r:rryrzstat_cmd stat_resultr" sample_cmd sample_resultend_lineread_cmd read_resultwc_cmd wc_resultr!r#r$s rr|zShellFileOperations.read_files  &&1&%@@ Id44T::HHHjj**  A % %..t44 4 K.446677II   III  } $ $  >>$   #\  PT%;%;D%A%AOOO  :..  ! !$ (< = = #m E>A%RfRRxRRD4J4J44P4PRRjj**  A % %$PK/dev/null | head -50rdZF<(g?c|d S)Nrr)xs rz.ns 1Q4%r)keycg|]\}}|Srr)r2_fps rrhz>ShellFileOperations._suggest_similar_files..os...%!R2...rNzFile not found: )r*r-)rrdirnamebasenamerrrrrtrsrrrrsetrrrsortr)r:rdir_pathr basename_no_extr lower_namels_cmd ls_resultscoredflfscorecommonsimilars rrz*ShellFileOperations._suggest_similar_filesBs7??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++!    rc||}d||d}||}|jdkr||S t |j}n#t$rd}YnwxYw| |rtdd|S|d||d}| ||jrtd|dS|d ||}|jdkrtd |j St|j| 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. rrrT)r&r%r"ru'Binary file — cannot display as text.rcat rr)r r") rrrrtrrBrsrrrrr)r:rr r!r"r# cat_results rrz!ShellFileOperations.read_file_rawvs   &&Hd44T::HHHjj**  A % %..t44 4 K.446677II   III  >>$   RttyQQQ Q #]43I3I$3O3O#]#]#]^^  ! !$ (< = = )? ZZ Et'='=d'C'C E EFF  1 $ $$OJ rNrO)r:rrprWs rrzShellFileOperations.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}}rc||}t|rtd|dStj|}d}|r:d||}||}|jdkrd}d||}||| }|jdkrtd |j Sd ||d } || } t| j } n2#t$r%t|d } YnwxYwt| |S)u 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. Args: path: File path to write content: Content to write Returns: WriteResult with bytes written or error Write denied: '(' is a protected system/credential file.rFz mkdir -p rTzcat > )rzFailed to write file: rrzutf-8)rHrI)rrrGrrr:rrrtrsrBrrrencode) r:rr parentrI mkdir_cmd mkdir_result write_cmd write_resultr r!rHs rrzShellFileOperations.write_files   && D ! ! g%et%e%e%efff f&&  $DD$:$:6$B$BDDI::i00L%**# Q%S%STTT TId44T::HHHjj**  9 2 8 8 : :;;MM 9 9 9w 7 788MMM 9'%    s&D>>,E-,E-Frrrc ||}t|rtd|dSd||d}||}|jdkrtd|S|j}ddlm}|||||\} } } } | s| dkr@| pd |} dd lm }| || | ||z } n#t$rYnwxYwt| S| || }|j rtd |j Sd||d}||}|jdkrtd |S|j| kr9td |dt| dt|jdS||| |}||}td||g|r|ndS)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 rTrUrrJrrr)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 z#Post-write verification failed for z5: on-disk content differs from intended write (wrote z chars, read back z=). The patch did not persist. Re-read the file and try again.TN)rOrPrQrT)rrrNrrrtrstools.fuzzy_matchr]r^ Exceptionrr*rr _check_lintr;)r:rrrrr%r&r r]r  match_count _strategyr*err_msgr^r[ verify_cmd verify_resultrP lint_results rrz!ShellFileOperations.patch_replaces  && D ! ! g%et%e%e%efff fE$0066DDDjj**  A % %%CT%C%CDDD D$ =<<<<<5K5K Z[6 6 2 [)U  .K1$$OOOOG BBBBBB//jRYZZZ    W--- -t[99   W%UAS%U%UVVV VGD22488FFF  :..  "a ' '%`Z^%`%`aaa a  ; . .MdMMk**MM>A-BV>W>WMMM !!';==&&t,,  6*5?$$&&&4     s5C CCrctddlm}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_parserrirjrN)r:rrirj operations parse_errorrWs rrzShellFileOperations.patch_v4a8sm( MLLLLLLL"1/-"@"@ K  N%L{%L%LMMM M&%j$77 rcdtj|d}|tvrt dd|dSt|}|d}||st d|dS|d| |}| |d }t |j dk|j r|j nd S) z Run syntax check on a file after editing. Args: path: File path to lint Returns: LintResult with status and any errors rwTzNo linter for z files)rkrmrz not availablez{file}r1rr)rOrl)rrrrLINTERSrjrrrrrrtrsr)r:rr linter_cmdbase_cmdrrWs rrazShellFileOperations._check_lintVs-gt$$Q'--// g  d4PS4P4P4PQQQ QS\ ##%%a(  ** Qdx4O4O4OPPP P  4+A+A$+G+GHHC,,$),2M,?,?,A,AI6=&&(((r    rrrrrrrrrc 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 norr*z 2>/dev/null | head -20rrNzSimilar paths: z, r9z. r*rbr`)rrrrrsrrr:r;rtrrrrrrr^ _search_files_search_content)r:rrrrrzryrrcheckrWbasename_query hint_parts parent_checkrBlower_q candidatesentryles rrzShellFileOperations.searchzs&4FEBB   && ed&<&> >rc H|dsd|vr|}n|dd}|dr|||||S|dst dSd}d ||d |d ||d |d zd| }||d}|jsTd ||d |d ||d||zd|d z } || d}g} |jdD]} | s| d d } t| dkrJ| d dd r| | d x| | t | t| S)z-Search for files by name pattern (glob-like).z**/rrgrzFile search requires 'rg' (ripgrep) or 'find'. Install ripgrep for best results: https://github.com/BurntSushi/ripgrep#installationrz-not -path '*/.*'zfind rQz -type f -name z6 -printf '%T@ %p\n' 2>/dev/null | sort -rn | tail -n +rwz | head -n r.ro 2>/dev/null | head -n z | tail -n +rr/rrrr`rb) rrr_search_files_rgr^rrrsrrrisdigitr) r:rrrzrysearch_patternhidden_excluderrW cmd_simpler`repartss rrwz!ShellFileOperations._search_filess!!%(( 4S-?-?$NN$]]3//3N   T " " N((ufMM M  (( K -fd,,T22ff^ffTXTjTjkyTzTzffGMPQzff^cffC,,}""$$ 8Z!7!7!=!=ZZZZ_c_u_uwE`F`FZZ16ZZMSVWZZZJZZ BZ77FM''))//55 # #D JJsA&&E5zzQ58#3#3C#<#<#D#D#F#F U1X&&&& T""""E     rcd|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 rQrr.rocg|]}||Srrr2rDs rrhz8ShellFileOperations._search_files_rg..sGGG1QGQGGGrrzrg --files -g cg|]}||Srrrs rrhz8ShellFileOperations._search_files_rg.. KKKqKKKKr)r`rbr#)rrrrsrrr^r) r:rrrzry glob_pattern fetch_limit cmd_sortedrW all_files cmd_plainpages rrz$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    rc |dr||||||||S|dr||||||||StdS)z,Search for content inside files (grep-like).rgrepzqContent search requires ripgrep (rg) or grep. Install ripgrep: https://github.com/BurntSushi/ripgrep#installationr)r_search_with_rg_search_with_grepr^)r:rrrrzryrrs rrxz#ShellFileOperations._search_contents   T " " ''y%(3W>> >   v & & ))'4E6*5w@@ @ \ rc  gd}|dkr$|dt|g|r*|d||g|dkr|dn|dkr|d|||||||dkr||zd zn||z} |d d d t| gd |} || d} | jdkr_| jsFt| dr | j r| j nd} td| dS|dkrcd| j dD} t| }| |||z}t||S|dkri}| j dD]_}d|vrY|dd}t|dkr0 t|d||d<O#t $rY[wxYw`t|t#|St'jd}t'jd}g}| j dD]W}|r|dkr ||}|r|t-|dpd|dzt|d|d d!d"#|dkr||}|r|t-|dpd|dzt|d|d d!d"#Yt|}||||z}t|||||zk$S)%zSearch using ripgrep.)rz --line-numberz --no-headingz--with-filenamer-Cz--glob files_only-lcount-crhead-nrQr.ror/stderr Search errorSearch failed: rvcg|]}||Srrrs rrhz7ShellFileOperations._search_with_rg..Orrrr:rwrarb^([A-Za-z]:)?(.*?):(\d+):(.*)$^([A-Za-z]:)?(.*?)-(\d+)-(.*)$--rruNrxrfr_rbr#)extendr@rrrrrtrsrhasattrrr^rrrsplitrBrrvaluesrcompilematchrYgroupr:rrrrzryrr cmd_partsrrrW error_msgrtotalrrarer _match_re_ctx_rer_rgs rrz#ShellFileOperations._search_with_rg(sONN  Q;;   dCLL1 2 2 2  L   h(>(>y(I(IJ K K K , & &   T " " " " G # #   T " " " //88999//55666 /6kkefns**uv~ #vtS-=-=>???hhy!!C,,  q )<)<)>)> 181J1Jpv}p ++---bpI&C &C&CQRSSS S , & &KKFM$7$7$9$9$?$?$E$EKKKI NNEVFUN23Dd>>> > G # #F ++--33D99 ! !$;; KKQ//E5zzQ!/258}}F58,,)!!! D!v3v}};O;OPPP P #DEEIj!BCCGG ++--33D99  tt||OOD))NN;ggajj.B!''!**<$' OO ! 4C4 0$$$ Q;; d++A{"#''!**"2aggajj!@(+AGGAJJ$%GGAJJtt$4((( LLE6&5.01D!&5.0 s>J J*)J*c  ddg}|d|dkr$|dt|g|r*|d||g|dkr|dn|d kr|d ||||||||z|dkrd ndz} |d d dt| gd|} || d} | jdkr_| jsFt| dr | j r| j nd} td| dS|dkrcd| j dD} t| }| |||z}t||S|d kri}| j dD]_}d|vrY|dd}t|dkr0 t|d||d<O#t $rY[wxYw`t|t#|St'jd}t'jd}g}| j dD]W}|r|dkr ||}|r|t-|dpd |dzt|d!|d"d#d$%|dkr||}|r|t-|dpd |dzt|d!|d"d#d$%Yt|}||||z}t|||||zk&S)'zFallback search using grep.rz-rnHz--exclude-dir='.*'rrz --includerrrrrrrrrQr.ror/rrrrvcg|]}||Srrrs rrhz9ShellFileOperations._search_with_grep..rrrrrrwrrrrrrurNrxrfr)rrr@rrrrtrsrrrr^rrrrBrrrrrrrYrrs rrz%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-=-=>???hhy!!C,,  q )<)<)>)> 181J1Jpv}p ++---bpI&C &C&CQRSSS S , & &KKFM$7$7$9$9$?$?$E$EKKKI NNEVFUN23Dd>>> > G # #F ++--33D99 ! !$;; KKQ//E5zzQ!/258}}F58,,)!!! D!v3v}};O;OPPP P #DEEIj!BCCGG ++--33D99  tt||OOD))NN;ggajj.B!''!**<$' OO ! 4C4 0$$$ Q;; d++A{"#''!**"2aggajj!@(+AGGAJJ$%GGAJJtt$4(((LLE6&5.01D!&5.0 sJ// J<;J<r0)NNN)rwrrr)&r<r=r>r?r@rrBrrrrCrrrrrrrrr|rrrGrrrrNrrrjrarr^rrwrrxrrrrrrr;s,!2!2#!2!2!2!2FCG $  S s C  )6    @((((((c3$$'c'd'''' # # ## #c # # # #######J7S7S7777  3 # RU    V V cV 3V 3V V V V V p2 32 :2 2 2 2 hJ#J*JJJJ8  S s {    $4 s4 S4 [4 4 4 4 v+0N N #N 3N CN #'N 4?N N N N `s{<      HCLOP<==>=>c=>=>C=>"3-=>7:=>IL=>=>69=>BN=>=>=>=>~1 S1 1 C1 1 Q]1 1 1 1 f) ) 3) s) C) T`) ) ) ) Vs#(3-",/>ALOT`"asa#a(3-a"a,/a>AaLOaT`aaaaF__C_HSM_!$_.1_@C_NQ_Vb______rr);r?rrrabcrr dataclassesrrtypingrrr r pathlibr hermes_constantsr tools.binary_extensionsr agent.file_safetyrrrrrrr@r_HOMEWRITE_DENIED_PATHSWRITE_DENIED_PREFIXESrrCrrrGrNrYr^rjrrrvrrp MAX_LINESMAX_LINE_LENGTHrrrrrrBrtuplerrrrrrrsT4 ########((((((((,,,,,,,,,,,,,,,,,,555555 IDIKK--e4433E::)hsm)))))3)4)))) UUUUUUU U& IIIIIII I  6    6              1 1 1 1 1 S1 1 1 rNMM . % )  (      sSS-@+=//c/%(/BGS/////&/D-A///'*/FKCQTHo////ooooo.ooooor