߲j, dZddlZddlmZmZddlmZmZmZm Z m Z eGddZ eGddZ eGd d Z eGd d ZeGd dZeGddZeGddZej$dZej$dZej$dej*Zej$dej*ZdedefdZdedefdZdede efdZdededefdZd Zdedeee ffd!Z!de ede fd"Z"d#Z#d$Z$dZ%d%Z&d&ed'edefd(Z'e#e$fd)ed*edeeeffd+Z(e%e&fd)ed*edeeeffd,Z)y)-uHResult dataclasses and pure text helpers shared by ``tools.file_operations`` and its search/lint mixins. Leaf module (imports nothing from ``tools`` at module scope) so nothing cycles. The ``to_dict`` output of every class here IS tool behavior — key names, order and omission rules are pinned by tests and read by the model. N) dataclassfield)AnyClassVarDictListOptionalc eZdZUdZdZeed<dZeed<dZ eed<dZ e ed<d Z e e ed <d Ze eed <dZe ed <dZe ed <d Ze eed<d Ze eed<d Ze eed<d Ze eed<eeZeeed<d Ze eed<defdZy ) ReadResultzResult from reading a file.contentr total_lines file_sizeF truncatedNtruncated_lineshint is_binaryis_imagebase64_content mime_type dimensionserrordefault_factory similar_files _snapshotreturnc|jjDcic]#\}}|jdr||gk7s!||%c}}Scc}}wN___dict__items startswithselfkvs A/home/ubuntu/.hermes/hermes-agent/tools/file_operations_common.pyto_dictzReadResult.to_dictsE!%!4!4!6nAall3>OTUTafgkmfm1nnnsA A A A )__name__ __module__ __qualname____doc__r str__annotations__rintrrboolrr rrrrrrrrlistrrrtupledictr*r)r r s%GSKIsIt&*OXd^*D(3-ItHd$(NHSM(#Ix}# $J $E8C=$T:M49:!%Ix%oor7r ceZdZUdZdZeed<dZeed<dZ e eed<dZ e e ed<dZ e ee efed <dZe e ed <dZe e ed <dZe e ed <d efdZy) WriteResultzResult from writing a file.r bytes_writtenF dirs_createdNverified_content_sha256lintlsp_diagnosticsrwarningrc|jjDcic]\}}|jdr|||c}}Scc}}wrr!r%s r)r*zWriteResult.to_dict3s<!%!4!4!6bAall3>OTUTa1bbbsAAA)r+r,r-r.r:r1r0r;r2r<r r=r/r>rrr?rr@r5r*r6r7r)r9r9#s%M3L$ $Hhtn#%)OXc])%)D(4S> ")&*OXc])E8C=!GXc]!ccr7r9ceZdZUdZdZeed<dZeed<e e Z e eed<e e Z e eed<e e Ze eed <d Zeeeefed <d Zeeed <d Zeeed <dZeed<d Zeeed<dZeeed<defdZy ) PatchResultzResult from patching a file.Fsuccessr diffrfiles_modified files_created files_deletedNr>r?r no_changenote)rErFrGrHr>r?r _DICT_FIELDSrcd|ji}|jrd|d<|jr|j|d<|jD]}t ||}|s|||<|S)NrDTrIrJ)rDrIrJrKgetattr)r&resultkeyvalues r)r*zPatchResult.to_dictLsi"+T\\!: >>"&F;  99!YYF6N$$ $CD#&E#s  $ r7)r+r,r-r.rDr2r0rEr/rr3rFrrGrHr>r rrr?rrIrJrKrr4r5r*r6r7r)rCrC7s&GTD#N %d ;NDI;$T:M49:$T:M49:%)D(4S> ")%)OXc])E8C=ItD(3-%L(5/  r7rCc>eZdZUdZeed<eed<eed<dZeed<y) SearchMatchzA single search match.path line_numberr gmtimeN) r+r,r-r.r/r0r1rUfloatr6r7r)rRrRYs I LE5r7rRc eZdZUdZeeZeee d<eeZ ee e d<ee Z ee efe d<dZee d<dZee d <d Zee e d <d Zee e d <d Zee e d <dZeee d<dee fdZddede fdZy ) SearchResultzResult from searching.rmatchesfilescountsr total_countFrN limit_reasonr@r_DENSIFY_MIN_MATCHESrcrt|j|jkryg}d}|jD]q}|j|k7r'|j |j|j}|j d|j d|j jsdj|S)zLossless path-grouped text block: path once, then `` : `` rows. Relies on rg/grep emitting a file's hits consecutively. None when too few matches to be worth it.Nz z:  ) lenrYr_rSappendrTr rstripjoin)r&lines current_pathms r)_densify_matcheszSearchResult._densify_matchesrs t|| t88 8&*  EAvv% QVV$ vv LL2amm_Bqyy/?/?/A.BC D  E yyr7densifycd|ji}|jr`|r|jnd}| d|d<||d<n?|jDcgc]&}|j|j|j d(c}|d<|j r|j |d<|jr|j|d<|jr d |d <d |d <d D]}t||}|s|||<|Scc}w) Nr\ztpath-grouped: each file path on its own line, followed by indented ': ' rows for matches in that filematches_format matches_text)rSliner rYrZr[Trtotal_count_is_lower_bound)r]r@r) r\rYrirSrTr rZr[rrM)r&rjrNdenserhrOrPs r)r*zSearchResult.to_dicts%2D4D4D$E <>"&F; 37F/ 07 $CD#&E#s  $ %s +C$)F)r+r,r-r.rr3rYrrRr0rZr/r5r[rr1r\rr2r]r r@rr_rrir*r6r7r)rXrXbs !&t!>>>>>> formatted_contentrcttj|}|r(t|ttj|SdS)aUnresolved git merge-conflict blocks in a ``LINE|CONTENT`` read; 0 when the page has no balanced ``<<<<<<< `` / ``>>>>>>> `` pair (a lone marker in prose or a test fixture is not a conflict). Reported on read so the model resolves the conflict instead of editing around it.r)rb_CONFLICT_OPENfindallmin_CONFLICT_CLOSE)r~openss r)count_conflict_blocksrs@ &&'89 :EJO3uc/112CDE FVUVVr7textc6|s|Sg}|jdD]n}d|vxsd|v}tjdtjd|j dd}|r|j ddk(r^|j |pdj|S)zStrip leaked terminal fence wrappers (OSC sequences, fence markers) from command output; drops lines that were nothing but wrapper.T)keepends__HERMES_FENCE_z]r z' ) splitlines_FENCE_MARKER_REsub_OSC_SEQUENCE_REreplacestriprcre)r cleaned_linesrnhad_terminal_wrappercleaneds r)_strip_terminal_fence_leaksrs  !M.&0D8KGtO"&&r+;+?+?D+IJRRSY[]^ GMM*$=$C W% & 77= !!r7samplec*|r|ddnd}d|vryd|vryy)a'Dominant line ending of ``sample`` (``\r\n`` if any CRLF in the first 4KB, else ``\n``), or None for empty/single-line content. Preserves a file's endings across write_file/patch: bare-LF tool args would otherwise silently normalize CRLF files, and patch would produce mixed endings.Nir  rar6)rheads r)_detect_line_endingrs* #6%4=D ~ t| r7targetc|jddjdd}|dk(r|S|dk(r|jddS|S)uConvert every line ending (CRLF, lone CR, LF) in ``text`` to ``target``. Idempotent. Collapses to LF first — separate replacements would double-convert CRLF → LFLF.rra )r)rr lf_normalizeds r)_normalize_line_endingsrsNLL.66tTBM ~ $$T622 Kr7ucHt|r|ttddfS|dfS)zvReturn (text-without-leading-BOM, had_bom). Only a leading BOM is stripped; mid-content U+FEFF is legitimate data.NTF)_has_bomrb _UTF8_BOMrs r) _strip_bomrs+~C NO$d** ;r7cFt|xr|jtS)z)True if ``text`` begins with a UTF-8 BOM.)r2r$rrs r)rrs : 4$//)44r7i2rPdefaultcH t|S#ttf$r|cYSwxYw)z8Best-effort integer coercion for tool pagination inputs.)r1 TypeError ValueError)rPrs r) _coerce_intrs*5z z "s !!offsetlimitc ddlm}tdt|t}tdt t|t |}||fS)zClamp read_file pagination so invalid values can never reach a sed range like ``0,-1p`` (schemas declare bounds, but not every caller enforces them). The ``limit`` ceiling is ``tool_output.max_lines`` from config.yaml.r) get_max_linesr)tools.tool_output_limitsrmaxrDEFAULT_READ_OFFSETrDEFAULT_READ_LIMIT)rrrnormalized_offsetnormalized_limits r)normalize_read_paginationrsF 7A{63FGH1c+e5G"H-/Z[ . ..r7cjtdt|ttdt|tfS)zCReturn safe search pagination bounds for shell head/tail pipelines.rr)rrDEFAULT_SEARCH_OFFSETDEFAULT_SEARCH_LIMIT)rrs r)normalize_search_paginationr's. q+f&;< =s1kRWYmFn?o oor7)*r.re dataclassesrrtypingrrrrr r r9rCrRrXrrrzcompilerrMrrr/r1rrrrrr4r2rrrrrrrrrr6r7r)rsL (66 oo o* cc c&  B   99 9x        2::BC2::LM0"$$7"**12448WSWSW "c "c "    # s s   SU39-58C=5T5sSS-@+=/c/%(/BGS///D-App'*pFKCQTHopr7