+ iڕaRst>0tRt^RIt^RIt^RIt^RIt^RIt^RIHt^RI H t ^RI H t ]P!]4t]P ]P"]P$0tRtRs]^kRRltRt]!0Rtm4tR R ltRutR R 0tR RltRRlt]P>!4t /t!]^k]P>!4t"/t#]^kRvRRllt$RwRRllt%RxRRllt&RvRRllt'RwRRllt(RwRRllt)RvRR llt*R!R"lt+R#R$lt,RvR%R&llt-RyR)R*llt.RzR-R.llt/R/R0R1]&/R/R2R1]-/R/R3R1]./R/R4R1]//.t0R5t1^R6I2H3t3R7t4R/R0R8R9R:R;RR;R?R8R@/RAR;RBR8RCR^RD^/RER;RBR8RFRRRGRH//RIR>.//t5R/R2R8RJR:R;RR;R?R8RK/R+R;R?R8RL//RIR>R+.//t6R/R3R8RMR:R;RR;R?R8RQ/RRR;R?R8RS/RTR;R?R8RU/RVR;RWR8RXRR(/R3R;R?R8RY//RIRN.//t7R/R4R8RZR:R;RR;R?R8R`RR,/RaR;R?R8Rb/RER;RBR8RcR^2/RAR;RBR8RdR^/ReR;R?RO.R{OR8RfRR+/RgR;RBR8RhR^//RIR[.//t8Rit9Rjt:Rkt;Rlt<]3Pz!R0Rm]5]9]4RnRo7]3Pz!R2Rm]6]:]4RpRo7]3Pz!R3Rm]7];]4RqRo7]3Pz!R4Rm]8]<]4RrRo7R#)|z6File Tools Module - LLM agent file manipulation tools.N)Path)ShellFileOperations)redact_sensitive_textic$V^8dQhR\/#)return)int)formats"-/home/ubuntu/hermes-agent/tools/file_tools.py __annotate__r s""S"c\e\#^RIHpV!4pVPR4p\ V\ \ 34'dV^8d\ V4s\#\s\# \d\s\#i;i)zReturn the configured max characters per file read. Reads ``file_read_max_chars`` from config.yaml on first call, caches the result for the lifetime of the process. Falls back to the built-in default if the config is missing or invalid. ) load_configfile_read_max_chars) _max_read_chars_cachedhermes_cli.configrget isinstancerfloat Exception_DEFAULT_MAX_READ_CHARS)rcfgvals r _get_max_read_charsrs)%% 1mgg+, cC< ( (S1W%(X ") )5 !!   4 !! sAA.. BBic0V^8dQhR\R\/#)rfilepathrstrbool)r s"r r r Isr c\PPV4pV\9dR#VP R4'dVP R4'dR#R#)u3Return True if the path would hang the process (infinite output or blocking input). Uses the *literal* path — no symlink resolution — because the model specifies paths directly and realpath follows symlinks all the way through (e.g. /dev/stdin → /proc/self/fd/0 → /dev/pts/0), defeating the check. Tz/proc/F)z/fd/0z/fd/1z/fd/2)ospath expanduser_BLOCKED_DEVICE_PATHS startswithendswith)r normalizeds& r _is_blocked_devicer'IsR##H-J**X&&:+>+>#,, r z/var/run/docker.sockz/run/docker.sockc>V^8dQhR\R\R,/#)rrrNr)r s"r r r bsCC$Jr c,\PP\PPV44p\ F"pVPV4'gKRV R2u# V\9dRV R2#R# \\ 3dTpLTi;i)zHReturn an error message if the path targets a sensitive system location.z,Refusing to write to sensitive system path: zD Use the terminal tool with sudo if you need to modify system files.N) r r!realpathr"OSError ValueError_SENSITIVE_PATH_PREFIXESr$_SENSITIVE_EXACT_PATHS)rresolvedprefixs& r _check_sensitive_pathr2bs77##BGG$6$6x$@A+   v & &>xjIVV + )):8*ER R   Z sYW$! m4MM}8MY&! o6QQ&:Q--&77&-C KKDhXZP[ \# HH#VZZ%C& 3Et(L$fjj1A5&I*FJJ7Mt,T$fjj1A2&F $ J5 FJJz26FJJz26FJJz266::i4 &**-=u"E   L7" &**-?"G  /!y)%!1)J/ L0\A\A\Ac\Ac\A#\A^a\Ar c \V4'd\P!RRV R2/4#^RIp^RIHpVP V4P4P4pV!4P4pVR, R, R, VR, R, .pVF1p VPV 4\P!RR V R 2/4u# \V4p WV3p \;_uu_4\PVR RR ^R \4R//4p V P!R/4P!V 4p RRR4X eF\"P$P'V 4pW8Xd\P!RRRVRR/RR7#\+V4pVP-WV4pVP/4p\1VP2;'gR4pVP!R^4p\54pVV8d?VP!RR4p\P!RRVR RVR RV R2RVRVRV/RR7#VP2'd*\7VP24VnVP2VR&V'dAV\88d6V^8d/VP!R4'dVPRR VR R!24R"WV3p\;_uu_4RX 9d/V R&V R ,P;WV34V R ,V8XdV R ;;,^, uu&M VV R &^V R &V R ,p\"P$P'V 4pVV R,V &VV PR#/4V &RRR4X^8d#\P!RR$V R%2RVR&V/RR7#V^8d R'V R(2VR)&\P!VRR7# \dEK5i;i +'giEL;i \(dELpi;i \(dLi;i +'giL;i \<d.p\P!R\T4/RR7uRp?#Rp?ii;i)*z-Read a file with pagination and line numbers.errorz Cannot read 'zE': this is a device file that would block or produce infinite output.N)get_hermes_homeskillsz.hubz index-cachezAccess denied: z is an internal Hermes cache file and cannot be read directly to prevent prompt injection. Use the skills_list or skill_view tools instead.last_key consecutive read_historydedupcontentuFile unchanged since last read. The content from the earlier read_file result in this conversation is still current — refer to that instead of re-reading.r!TF ensure_asciirQ file_size total_linesunknownzRead produced ,z, characters which exceeds the safety limit (zD chars). Use offset and limit to read a smaller range. The file has z lines total. truncated_hintzThis file is large (zj bytes). Consider reading only the section you need with offset and limit to keep context usage efficient.readread_timestampsz.BLOCKED: You have read this exact file region z| times in a row. The content has NOT changed. You already have this information. STOP re-reading and proceed with your task. already_readz%You have read this exact file region z times consecutively. The content has not changed since your last read. Use the information you already have. If you are stuck in a loop, stop reading and proceed with writing or responding._warning)r'jsondumpspathlibhermes_constantsrrr"resolve relative_tor-r_read_tracker_lock _read_tracker setdefaultsetrr r!getmtimer,r{ read_fileto_dictlenrrr_LARGE_FILE_HINT_BYTESaddr)r!rrr=_pathlib_get_hh _resolved _hermes_home _blocked_dirs_blocked resolved_str dedup_key task_data cached_mtime current_mtimerzresult result_dict content_lenr max_charsrread_keycount _mtime_nowes&&&& r read_file_toolrsZA d # #::#D6*88  #?MM$'224<<> y((* 8 #f ,} < 8 #f , &H %%h/zz)$0KK#&"9~ !51  %00D-w;I%=="599)DL    #  " 0 0 >  0::!U'%*++1!)##D%8nn& &....B/ OOK3 ')  "%//-CK::$[O4))21 6$$/= ? {Y " # # >>>26>>BFN%+^^K " )&<<CKOOK00  " "7&ym433 D%0  i'%' '" n % ) )4*? @$0-(A-((0 *%+, -(m,E  WW--l; 0: '"9-LV $$%6;LI' . A:::DUGLBB"# #aZ7w?cc  # zz+E::q    (  L  ) T Azz7CF+%@@As,P'A8P'(,O P'P'6AO> P' AO1B-P'<P'0P'?(P'(*P'AP1AP10P'"'P' OP'OP' O. ( P'1 P<P'?PP' PPPP P$ P'' Q2"QQQc0V^8dQhR\R\/#r<)rlist)r s"r r r s  C  r c \;_uu_4\PV/4pVPR\44p/pVF:wrEpWC9d.W4&W4,P RV RWV,^, 24K< \ VP 44UUu.uF wrxRVRV/NK uppuuRRR4#uuppi +'giR#;i)zReturn a list of files read in this session for the given task. Used by context compression to preserve file-read history across compression boundaries. rzlines -r!regionsN)rrrrappendsorteditems) r=rr seen_pathsr!rrprs & r get_read_files_summaryrs  !%%gr2  }}^SU;  %1 !T5%#%    # #fVHAfnq6H5I$J K&2 %Z%5%5%78 8 Q 7 +8       sBCB= /C=C C c$V^8dQhR\/#r}r))r s"r r r s " " "r c\;_uu_4V'd\PVR4M\P4RRR4R# +'giR#;i)zClear the read tracker. Call with a task_id to clear just that task, or without to clear all. Should be called when a session is destroyed to prevent memory leaks in long-running gateway processes. N)rrrprrs&r clear_read_trackerrs8      gt ,    !    rc$V^8dQhR\/#r}r))r s"r r r s//c/r cZ\;_uu_4V'd=\PV4pV'dRV9dVR,P4M;\P 4F#pRV9gK VR,P4K% RRR4R# +'giR#;i)uClear the deduplication cache for file reads. Called after context compression — the original read content has been summarised away, so the model needs the full content if it reads the same file again. Without this, reads after compression would return a "file unchanged" stub pointing at content that no longer exists in context. Call with a task_id to clear just that task, or without to clear all. rN)rrrrvaluesr=rs& r reset_file_deduprst   %))'2IW 1'"((**113 i'g&,,.4    s%B:B4B B* c$V^8dQhR\/#r}r))r s"r r r s ) )C )r c\;_uu_4\PV4pV'd RVR&^VR&RRR4R# +'giR#;i)uuReset consecutive read/search counter for a task. Called by the tool dispatcher (model_tools.py) whenever a tool OTHER than read_file / search_files is executed. This ensures we only warn or block on *truly consecutive* repeated reads — if the agent does anything else in between (write, patch, terminal, etc.) the counter resets and the next read is treated as fresh. Nrr)rrrrs& r notify_other_tool_callrs@  !%%g. $(Ij !'(Im $    s (A A c4V^8dQhR\R\RR/#rrr=rNr))r s"r r r s&RRSR3R4Rr c\\V4P4P44p\P P V4p\;_uu_4\PT4pTeY4PR/4T&RRR4R# \\3dR#i;i +'giR#;i)uRecord the file's current modification time after a successful write. Called after write_file and patch so that consecutive edits by the same task don't trigger false staleness warnings — each write refreshes the stored timestamp to match the file's new state. Nr) rrr"rr r!rr,r-rrrr)rr=r0rrs&& r _update_read_timestamprstH~002::<=((2   !%%g.  DQ !2B 7 A   Z    sAB.B/B,+B,/ C cJV^8dQhR\R\R\R,/#rr))r s"r r r s%C##*r c\\V4P4P44p\ ;_uu_4\PT4pT'g RRR4R#TPR/4PT4pRRR4XfR#\PPT4pYT8wdRT R2#R# \\ 3dR#i;i +'giL\;i \dR#i;i)u Check whether a file was modified since the agent last read it. Returns a warning string if the file is stale (mtime changed since the last read_file call for this task), or None if the file is fresh or was never read. Does not block — the write still proceeds. Nrz Warning: z was modified since you last read it (external edit or concurrent agent). The content you read may be stale. Consider re-reading the file to verify before writing.) rrr"rr,r-rrrr r!r)rr=r0r read_mtimers&& r _check_file_stalenessrstH~002::<=  !%%g.   ]]#4b9==hG  ((2 "z"L L ' Z    s50CC)!CC1CC C. 1 D?DcHV^8dQhR\R\R\R\/#)rr!rr=rr))r s"r r r /s.AA#AAcA#Ar cp\V4pV'd\P!RV/RR7#\W4p\ V4pVP W4pVP 4pV'dWGR&\W4\P!VRR7# \dp\T4'd,\PR\T4PT4M,\PR\T4PTRR7\P!R\T4/RR7uR p?#R p?ii;i) zWrite content to a file.rFrrz"write_file expected denial: %s: %szwrite_file error: %s: %sT)exc_infoN)r2rrrr{ write_filerrrr9rsdebugtype__name__rr) r!rr= sensitive_err stale_warningrzrrrs &&& r write_file_toolr/s)$/Mzz7M2GGA-d<  )$$T3nn& &3 # t-zz+E:: A ' * * LL=tAw?O?OQR S LL3T!W5E5EqSWL Xzz7CF+%@@ AsA%B D5 B D0*D50D5replaceFcxV^8dQhR\R\R\R\R\R\R\R\/#) rmoder! old_string new_string replace_allpatchr=rr)r s"r r r GsS6A6AS6AC6AC6A6A486AIL6A6A,/6Ar c>.pV'dVPV4VR8Xd^V'dV^RIpVPRWXP4F1p VPV P ^4P 44K3 VF2p \ V 4p V 'gK\P!RV /RR7u# .p VF)p \W4p V 'gKV PV 4K+ \V4pVR8XdTV'g\P!RR/4#VeVf\P!RR /4#VPWW44pMTVR8Xd3V'g\P!RR /4#VPV4pM\P!RR V 2/4#VP4pV 'd.\V 4^8Xd V ^,MR PV 4VR &VP!R4'gVFp \#W4K \P!VRR7pVP!R4'd!R\%VR,49d VR, pV# \&d.p\P!R\%T4/RR7uRp?#Rp?ii;i)z4Patch a file using replace mode or V4A patch format.rNz/^\*\*\*\s+(?:Update|Add|Delete)\s+File:\s*(.+)$rFrrz path requiredz"old_string and new_string requiredzpatch content requiredzUnknown mode: z | rzCould not findzp [Hint: old_string not found. Use read_file to verify the current content, or search_files to locate the text.])rrefinditer MULTILINEgroupstripr2rrrr{ patch_replace patch_v4arrjoinrrrr)rr!rrrrr=_paths_to_check_re_m_prstale_warnings_swrzrr result_jsonrs&&&&&&& r patch_toolrGs> O t$ w5,,QSXZgZghB  " "288A;#4#4#6 7i-b1 =::w 6UK K&A!B'4Cs%%c*" !) 9 zz7O"<==!Z%7zz7,P"QRR++DjVF W_zz7,D"EFF''.F::w.(?@A Ann& ;>~;NRS;SnQ&7Y^YcYcdrYsK #w''%&r3&jj5A  ??7 # #(8C G@TugFDD7"E"# #!)vK!  69 % %^^1i((QYYY 5aii @AI$nn& A:1%9VV  # jj5A  ??; ' ' .K F{mTWX XK[  \ Azz7CF+%@@AsTF9F9AF%0F98AF9 F9!A,F9F9% F6 0 F99 G1"G,&G1,G1namerfunctionrr search_filesc\#)z&Get the list of file tool definitions.) FILE_TOOLSr r get_file_toolsrs r )registryc^RIHpV!4#)z=Lazy wrapper to avoid circular import with tools/__init__.py.check_file_requirements)toolsrrs r _check_file_reqsrs- " $$r descriptionuRead a text file with line numbers and pagination. Use this instead of cat/head/tail in terminal. Output format: 'LINE_NUM|CONTENT'. Suggests similar filenames if not found. Use offset and limit for large files. Reads exceeding ~100K characters are rejected; use offset and limit to read specific sections of large files. NOTE: Cannot read images or binary files — use vision_analyze for images. parametersrobject propertiesr!stringz8Path to the file to read (absolute, relative, or ~/path)rintegerz9Line number to start reading from (1-indexed, default: 1)minimumrz9Maximum number of lines to read (default: 500, max: 2000)maximumirequireduWrite content to a file, completely replacing existing content. Use this instead of echo/cat heredoc in terminal. Creates parent directories automatically. OVERWRITES the entire file — use 'patch' for targeted edits.zWPath to the file to write (will be created if it doesn't exist, overwritten if it does)z%Complete content to write to the fileaiTargeted find-and-replace edits in files. Use this instead of sed/awk in terminal. Uses fuzzy matching (9 strategies) so minor whitespace/indentation differences won't break it. Returns a unified diff. Auto-runs syntax checks after editing. Replace mode (default): find a unique string and replace it. Patch mode: apply V4A multi-file patches for bulk changes.renumzVEdit mode: 'replace' for targeted find-and-replace, 'patch' for V4A multi-file patchesz/File path to edit (required for 'replace' mode)rzText to find in the file (required for 'replace' mode). Must be unique in the file unless replace_all=true. Include enough surrounding context to ensure uniqueness.rz_Replacement text (required for 'replace' mode). Can be empty string to delete the matched text.rbooleanzLReplace all occurrences instead of requiring a unique match (default: false)zV4A format patch content (required for 'patch' mode). Format: *** Begin Patch *** Update File: path/to/file @@ context hint @@ context line -removed line +added line *** End PatchuSearch file contents or find files by name. Use this instead of grep/rg/find/ls in terminal. Ripgrep-backed, faster than shell equivalents. Content search (target='content'): Regex search inside files. Output modes: full matches with line numbers, file paths only, or match counts. File search (target='files'): Find files by glob pattern (e.g., '*.py', '*config*'). Also use this instead of ls — results sorted by modification time.rzPRegex pattern for content search, or glob pattern (e.g., '*.py') for file searchrfileszK'content' searches inside file contents, 'files' searches for files by namezCDirectory or file to search in (default: current working directory)rzOFilter files by pattern in grep mode (e.g., '*.py' to only search Python files)z1Maximum number of results to return (default: 50)z0Skip first N results for pagination (default: 0)rzOutput format for grep mode: 'content' shows matching lines with line numbers, 'files_only' lists file paths, 'count' shows match counts per filerzDNumber of context lines before and after each match (grep mode only)c VPR4;'gRp\VPRR4VPR^4VPRR4VR7#)r=r:r!rQrrr)r!rrr=)rrargskwtids&, r _handle_read_filer/sP &&  ( (yC txx3DHHXqU_b ccr c VPR4;'gRp\VPRR4VPR4VPR4VPR4VPRR4VPR 4VR 7#) r=r:rrr!rrrFr)rr!rrrrr=)rrr+s&, r _handle_patchr3&ss &&  ( (yC  XXfi (txx/?88L)dhh|6LHH]E2$((7:KUX ZZr c VPR4;'gRpRRRR/pVPRR4pVPWD4p\VPRR4WPPR R 4VPR 4VPR ^24VPR ^4VPRR4VPR^4VR7 #)r=r:greprfindr)rrrQr!rrrrrr) rrr!rrrrrr=)rr)r,r-r. target_map raw_targetrs&, r _handle_search_filesr9.s &&  ( (yC)VW5J(I.J ^^J 3F B'XXfc=R((;'txx/DTXXV^`aMbHH]I6TU@V`c eer fileu📖)rtoolsetschemahandlercheck_fnemojiu✍️u🔧u🔎cV^8dQh/^\9d\R,;R&^\9d \;R&^\9d \;R&#)rNrror)__conditional_annotations__rdict)r s"r r r sF<<4*)d )5=|}=`ta=r > /dev/tty /dev/fd/0 /dev/fd/1 /dev/fd/2 /dev/full /dev/zero /dev/stdin /dev/random /dev/stderr /dev/stdout /dev/console /dev/urandom)z/etc/z/boot/z/usr/lib/systemd/)r:)N)rr:)rNNNFNr:)rrN2rrQr:)r files_onlyr)?rA__doc__r7rloggingr rqrrtools.file_operationsr agent.redactr getLoggerrrsEACCESEPERMEROFSr8rrrr frozensetr#r'r.r/r2r9rrrnrorrr{rrrrrrrrrrrrrtools.registryrrREAD_FILE_SCHEMAWRITE_FILE_SCHEMA PATCH_SCHEMASEARCH_FILES_SCHEMAr/r1r3r9registerr )rAs@r rbs<  5.   8 $ ,, U[[A"%))"0! " # *D02DE(!"^^% vr$\A~ ( "/, ) R$>A06ArAAJ [*n5 \:7 Wj*- ^Z5  $%  Kc VX}6pq vy-9tvBCENPQR fi8su~ADFOQUV VH  Lp VX}7PQ -9`a  VY'   GB VXv 7/C]UmoxzCD VX}6gh 68]=cd 68]=^_ FI}?MOXZ_` fh 8uv   VH  $ NO -:LM vx)W1E}Wdfoqz{ VX}6{~GILM &(MQ[o{KSYZr