iL dZddlZddlZddlZddlmZmZddlmZm Z ddl m Z m Z m Z mZddlmZddlmZddlmZmZmZmZeejZeeZeeZd e efd Zd ed e fd Z!eGd dZ"eGddZ#eGddZ$eGddZ%eGddZ&eGddZ'eGddZ(GddeZ)hdZ*ddd d!d"d#Z+d$Z,d$Z-d%Z.d&Z/d'Z0dZ1d(Z2d)ed*e3d e3fd+Z4e/e0fd,ed-ed e5e3e3ffd.Z6e1e2fd,ed-ed e5e3e3ffd/Z7Gd0d1e)Z8dS)2aL 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)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_root:/home/ubuntu/.hermes/hermes-agent/tools/file_operations.py_get_safe_write_rootr8s ' ( ((rpathc t|S)z.Return True if path is on the write deny list.)_shared_is_write_denied)rs r_is_write_deniedrCs "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__rstr__annotations__r intr!r"boolr#rr$r%r&r'r(r)rlistr,rdictr:rrrrrLs#%%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|] \}}||| Sr/rr0s rr4z'WriteResult.to_dict..isHHHA!-1---rr5r8s rr:zWriteResult.to_dicths$HH!4!4!6!6HHHHr)r;r<r=r>rGrAr@rHrBr)rr?rIrDr:rrrrFrF`s%%M3L$E8C=!GXc]!!!IIIIIIIrrFc 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)NrNrOrPrQrRrSr))rNrOrPrQrRrSr)r9results rr:zPatchResult.to_dictwsT\* 9 '!YF6N   ;'+':F# $   9&*&8F? #   9&*&8F? # 9 '!YF6N : )"jF7O r)r;r<r=r>rNrBr@rOr?rrCrPrrQrRrSrr r r)rDr:rrrrMrMls&&GTD#NNN %d ; ; ;NDI;;;$uT:::M49:::$uT:::M49:::%)D(4S> ")))E8C=rrMc@eZdZUdZeed<eed<eed<dZeed<dS) SearchMatchzA single search match.r line_numberrgmtimeN) r;r<r=r>r?r@rArZfloatrrrrXrXsF  III LLLE5rrXceZdZUdZeeZeee 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) Nrac8g|]}|j|j|jdS))rlinerrrYr)r1ms r z(SearchResult.to_dict..s8!!!19MM!!!rr^r_r`Tr"r))rar^r_r`r"r)rUs rr:zSearchResult.to_dicts!12 < !!!!!F9  : )"jF7O ; +#{F8  > '"&F;  : )"jF7O r)r;r<r=r>rrCr^rrXr@r_r?rDr`r rArar"rBr)rr:rrrr]r]s  !&t!rNrBr@rjrkr?rlrDr:rrrririsw%%GTGTFCGS       rric0eZdZUdZdZeed<dZeed<dS) ExecuteResultz&Result from executing a shell command.rstdoutr exit_codeN) r;r<r=r>rrr?r@rsrArrrrqrqs800FCIsrrqcdeZdZdZed!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)r9rrxrys 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. Nrr9rs r read_file_rawzFileOperations.read_file_raws  rrcdS)z8Write content to a file, creating directories as needed.Nr)r9rrs r write_filezFileOperations.write_filer|rF old_string new_string replace_allcdS)z,Replace text in a file using fuzzy matching.Nr)r9rrrrs r patch_replacezFileOperations.patch_replaces  r patch_contentcdS)zApply a V4A format patch.Nr)r9rs r patch_v4azFileOperations.patch_v4ar|rcdS)z>Delete a file. Returns WriteResult with .error set on failure.Nrr~s r delete_filezFileOperations.delete_filer|rsrcdstcdS)zSMove/rename a file from src to dst. Returns WriteResult with .error set on failure.Nr)r9rrs r move_filezFileOperations.move_filer|r.N2rpatterntarget file_glob output_modecontextc dS)zSearch for content or files.Nr) r9rrrrryrxrrs rsearchzFileOperations.searchs rrvrwFrrNrrrr)r;r<r=r>rr?rArr{rrFrrBrMrrrrrr]rrrrrurusJJ  c 3 3    ^  # *   ^  s S [   ^ */  # 3 C #' 4?   ^  s {   ^      ^  S s {   ^ BKOP<=  c  C "3- 7: IL  69 BN   ^   rru>.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.rsiirvrwrvaluedefaultcT t|S#ttf$r|cYSwxYw)z8Best-effort integer coercion for tool pagination inputs.)rA TypeError ValueError)rrs r _coerce_intrs<5zz z "s ''rxrycddlm}|}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_linesrv)tools.tool_output_limitsrmaxrDEFAULT_READ_OFFSETDEFAULT_READ_LIMITmin)rxryr max_linesnormalized_offsetnormalized_limits rnormalize_read_paginationrst766666 IA{63FGGHH"5*<==1c"2I>>?? . ..rctdt|t}tdt|t}||fS)zCReturn safe search pagination bounds for shell head/tail pipelines.rrv)rrDEFAULT_SEARCH_OFFSETDEFAULT_SEARCH_LIMIT)rxryrrs rnormalize_search_paginationr2sFA{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)r9 terminal_envrs r__init__zShellFileOperations.__init__Bse0  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. rNrrrkr returncoder)rrrs)rrrexecuterqget)r9rrrrkwargs effective_cwdrVs r_execzShellFileOperations._execes"  ( '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)rrrrstrip)r9rrVs 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). rvTc3HK|]}t|dk|dvdVdS) z rvN)ord)r1cs r z8ShellFileOperations._is_likely_binary..sJ E Ea"%a&&2++!82C2C!"2C2C2C2C E ErNig333333?F)osrsplitextlowerr sumrlen)r9rrext 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.rv)rrrrIMAGE_EXTENSIONS)r9rrs r _is_imagezShellFileOperations._is_images4gt$$Q'--//&&&rrvr 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) r9rrrmax_line_lengthlinesnumberedirds 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~/rvNrz[a-zA-Z0-9._-]+zecho ~) startswithrrsrrrfindre fullmatchr) r9rrVhomerest 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)r9rs 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)r9rrr  old_lines new_linesrOs r _unified_diffz!ShellFileOperations._unified_diffsn**D*99 **D*99 # y$(__"??    wwt}}rrwrxryc ||}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)rvzsed -n ',zp' Failed to read file: r)zwc -l < Nz Use offset=z to continue reading (showing -z of z lines))rr r!r"r#)rrrrrs_suggest_similar_filesrArrrr MAX_FILE_SIZErrrr)r9rrxrystat_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.ms 1Q4%r)keycg|]\}}|Srr)r1_fps rrgz>ShellFileOperations._suggest_similar_files..ns...%!R2...rNzFile not found: )r)r,)rrdirnamebasenamerrrrrsrrrrrrsetrrrsortr)r9rdir_pathr basename_no_extr lower_namels_cmd ls_resultscoredflfscorecommonsimilars rrz*ShellFileOperations._suggest_similar_filesAs7??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)rr!) rrrrsrrArrrrrrr)r9rrr r!r" cat_results rrz!ShellFileOperations.read_file_rawus   &&Hd44T::HHHjj**  A % %..t44 4 K.446677II   III  >>$   RttyQQQ Q #]43I3I$3O3O#]#]#]^^  ! !$ (< = = )? ZZ Et'='=d'C'C E EFF  1 $ $$OJ rMrN)r9rrprVs 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)rGrH)rrrFrrr9rrrsrrrArrrencode) r9rrparentrH mkdir_cmd mkdir_result write_cmd write_resultrr rGs 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 rSrTrrIrrr)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)rNrOrPrS)rrrMrrrsrrtools.fuzzy_matchr\r] Exceptionrr)rr _check_lintr:)r9rrrrr$r%rr\r match_count _strategyr)err_msgr]rZ verify_cmd verify_resultrO 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_parserrhrirM)r9rrhri operations parse_errorrVs rrzShellFileOperations.patch_v4a7sm( 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 rvTzNo linter for z files)rjrlrz not availablez{file}r0rr)rNrk)rrrrLINTERSrirrrrrrsrrr)r9rr linter_cmdbase_cmdrrVs rr`zShellFileOperations._check_lintUs-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, r8z. r)rar_)rrrrrrrrr9r:rsrrrrrrr] _search_files_search_content)r9rrrrryrxrrcheckrVbasename_query hint_parts parent_checkrAlower_q candidatesentryles rrzShellFileOperations.searchys&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 rPz -type f -name z6 -printf '%T@ %p\n' 2>/dev/null | sort -rn | tail -n +rvz | head -n r-rn 2>/dev/null | head -n z | tail -n +rr.rrrr_ra) rrr_search_files_rgr]rrrrrrrisdigitr) r9rrryrxsearch_patternhidden_excluderrV cmd_simpler_rdpartss rrvz!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 rPrr-rncg|]}||Srrr1rCs rrgz8ShellFileOperations._search_files_rg..sGGG1QGQGGGrrzrg --files -g cg|]}||Srrrs rrgz8ShellFileOperations._search_files_rg.. KKKqKKKKr)r_rar")rrrrrrrr]r) r9rrryrx glob_pattern fetch_limit cmd_sortedrV 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])r9rrrryrxrrs rrwz#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-nrPr-rnr.stderr Search errorSearch failed: rucg|]}||Srrrs rrgz7ShellFileOperations._search_with_rg..Nrrrr:rvr`ra^([A-Za-z]:)?(.*?):(\d+):(.*)$^([A-Za-z]:)?(.*?)-(\d+)-(.*)$--rrtNrwrer^rar")extendr?rrrrrsrrrhasattrrr]rrrsplitrArrvaluesrcompilematchrXgroupr9rrrryrxrr cmd_partsrrrV error_msgrtotalrr`rdr _match_re_ctx_rer^rfs 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 --includerrrrrrrrrPr-rnr.rrrrucg|]}||Srrrs rrgz9ShellFileOperations._search_with_grep..rrrrrrvrrrrrrtrNrwrer)rrr?rrrrsrrrrrr]rrrrArrrrrrrXrrs 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<r/)NNN)rvrrr)&r;r<r=r>r?rrArqrrBrrrrrrrrr{rrrFrrrrMrrrir`rr]rrvrrwrrrrrrr: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)9r>rrrabcrr dataclassesrrtypingrrr r pathlibr tools.binary_extensionsr agent.file_safetyr rrrrrr?r_HOMEWRITE_DENIED_PATHSWRITE_DENIED_PREFIXESrrBrrrFrMrXr]rirqrurro MAX_LINESMAX_LINE_LENGTHrrrrrrArtuplerrrrrrrsB4 ########((((((((,,,,,,,,,,,,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