+ lHj6Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RIH t Rt RRlt !RR] 4t R R ltR R ltR Rlt.ROtR#)aIn-process write primitives for the local POSIX backend. ``write_file`` asked the backend shell three questions per write (pre-write probe, atomic write, sha256 verification): three ``bash`` spawns, ~100 ms on a warm host before any real work. On the local POSIX backend the file is on this host, so ``ShellFileOperations`` answers them here instead, under the same gate as the native read path (``_native_read_enabled``; ``HERMES_NATIVE_FILE_READ=0`` turns both off). Semantics mirror the shell scripts they replace; anything they cannot answer (a FIFO, a device, an unexpected error) returns None and the caller takes the shell path. ) annotationsN)Optionalsc V^8dQhRRRR/#)pathstrreturnz Optional[int])formats"A/home/ubuntu/.hermes/hermes-agent/tools/file_operations_native.py __annotate__r s    c X\P!V\P\\R^4,4p\ P !\P!T4P4'g"\P!T4\T4hT# \dR#i;i)zfd of ``path`` when it is a regular file; None when missing; raises ``_NotRegular`` otherwise. One lookup with O_NONBLOCK, judged by fstat: a FIFO swapped in never blocks this thread. O_NONBLOCKN) osopenO_RDONLYgetattrFileNotFoundErrorstatS_ISREGfstatst_modeclose _NotRegular)rfds& r _open_regularrsw WWT2;;\1)EE F << ,, - -  $ I s;B B)(B)c]tRt^#tRtR#)rr N)__name__ __module__ __qualname____firstlineno____static_attributes__r r r rr#sr rc$V^8dQhRRRRRR/#)rrr want_textboolrz&Optional[tuple[bool, Optional[bytes]]]r )r s"r r r 's" , , , ,)O ,r c*\V4pVfR#\VR4;_uu_4pV'dVP4MVPR4pRRR4XP \ 4T3# +'giL';i \dR#i;i)z``(has_bom, body)`` for a write target: ``body`` is the whole file when ``want_text`` else its first 4 KB (the line-ending sample); ``(False, None)`` when the file is missing; None = ask the shell.Nrbi)FN)rrreadOSError startswith _UTF8_BOM)rr$rfhdatas&& r prober.'st 4  :  "d^^r )2779rwwt}D ??9 %t ++ ^ s3BB*A0B0 B ;BB BBc$V^8dQhRRRRRR/#)rrrr-bytesr Optional[str]r )r s"r r r 5s!%%s%%%M%r c \PPV4'd \PPV4MTp\PP V4;'gRp\P !VRR7\ P!\P !V4P4p\PPVR\P!^4 24p\P!T\P\P,\P ,\#\R^4,VfRMR4pTe\P*!Yd4\TR 4;_uu_4pTP-T4RRR4\P.!YR4R# \dRpELi;i \$d:pTP&;'gT R TP(;'gT 2uRp?#Rp?ii;i \$dLi;i +'giL;i \$dp\0P2!\$4;_uu_4\P4!T4RRR4M +'giM;iTP&;'gT R TP(;'gT 2uRp?#Rp?ii;i) aReplace ``path`` with ``data`` atomically; None on success, else an error message. Same contract as the shell script: a symlink target is written through (the link survives), parent directories are created, the temp file lives in the target's directory so the rename is atomic, an existing target's mode is kept and a new one gets the umask default (``O_CREAT`` with 0o666 applies the process umask itself), and the temp is removed on every failure. The temp holds its final mode before the first byte lands: an existing target's temp is created 0o600 and ``fchmod``-ed to the target's mode, so a private file's new contents are never readable through a wider temp (the shell script's ``mktemp`` 0600 temp gave the same guarantee)..T)exist_okNz .hermes-tmp. O_CLOEXECiiz: wb)rrislinkrealpathdirnamemakedirsrS_IMODErrjoinsecrets token_hexrO_WRONLYO_CREATO_EXCLrr)strerrorfilenamefchmodwritereplace contextlibsuppressunlink) rr-targetparentmodetmprer,s && r atomic_writerO5s(*ww~~d';';RWW  d #F WW__V $ + +F < FT* "&,,rwwv/F/F"GDggll6\'2C2CA2F1G#HI WWS"++ 2RYY>[Z[A\\"lU7 <    "#"d^^r HHTN 3 )! D  <**//""QZZ%9%96$:;;<    ^ <   ) ) IIcN* ) ) )**//""QZZ%9%96$:;;B#G"I'H=IH/#I GGGG H")H HHH H,)I+H,,I/ H? :I K "K/J K J K5K KKKc V^8dQhRRRR/#)rrrrr1r )r s"r r r ]s  C M r cda\V4pVfR#\P!4p\VR4;_uu_4o\ V3RlR4FpVP V4K RRR4VP4# +'giTP4#;i \ dR#i;i)zQHex sha256 of the regular file at ``path``; None when it cannot be read natively.Nr'c&<SPR4#)i)r()r,sr sha256_of..esbggg&6r r )rhashlibsha256riterupdater) hexdigest)rrdigestchunkr,s& @r sha256_ofr]]s  4  :! "d^^r6< e$=     ^     s3B )B )A>&B > B B B B/.B/)rOr.r])__doc__ __future__rrGrVrr=rtypingrr+rr)rr.rOr]__all__r r r rbsN#      '  ,%P  1r