+ iHj_5baR't 0tRt^RIt^RIt^RIHt^RIHtHtH t ^RI H t ^RI H t HtHt^RIHtHtRtR(RR lltR R R R RRRRRRRRRRRRRR/ t]^k];QJd.RR)4FNK 5M !RR)44t]!0R*m4tRRltRR ltR!R"ltR#R$lt!R%R&4tR#)+aFile-mutation verification footers and turn-completion explanations for ``AIAgent``. The footer tells the model (and user) when a claimed file mutation did not land; the explainer summarises why a turn ended without a final answer. Every method resolves through ``AIAgent``'s MRO. N)suppress)AnyDictOptionalt)_extract_error_preview_extract_file_mutation_targets#_extract_landed_file_mutation_paths)FILE_MUTATING_TOOL_NAMESfile_mutation_result_landedzy{model} didn't produce a reply this time, even after retries. Send `continue` to try again, or switch models with /model.c0V^8dQhR\R\/#)modelreturnstr)formats":/home/ubuntu/.hermes/hermes-agent/agent/turn_explainers.py __annotate__rsYYcY3YcB\RT;'g \R4R7#)zXLocalized ``EMPTY_RESPONSE_EXPLANATION`` with the model name (or "The model") filled in.explainer.empty_responseexplainer.shared.the_modelrrrs&rempty_response_explanationrs 'u/W/W:V8W XXrempty_response_exhaustedr!all_retries_exhausted_no_responsez0explainer.exit.all_retries_exhausted_no_responsepartial_stream_recoveryz&explainer.exit.partial_stream_recoveryfallback_prior_turn_contentz*explainer.exit.fallback_prior_turn_contentredirect_restart_limit_exceededz.explainer.exit.redirect_restart_limit_exceededrebuilt_restart_limit_exceededz-explainer.exit.rebuilt_restart_limit_exceededbudget_exhaustedzexplainer.exit.budget_exhausted ollama_runtime_context_too_smallz/explainer.exit.ollama_runtime_context_too_smallpending_tool_resultz"explainer.exit.pending_tool_resultc#."TF qRV 23xK R#5i)zexplainer.exit.N).0prefixs& r r)0s$)8gVvh '(8gscFV^8dQhR\\,R\/#)rcauser)rr)rs"rrr8s"qq q#qrc&V\9dRV 2#R#)zexplainer.persistence.zexplainer.persistence.default)_PERSISTENCE_CAUSES)r+s&r_persistence_explanation_keyr.8s/48K/K #E7 +pQpprcRV^8dQhR\R\\,R\/#)rpathtask_idrrr)rs"rrr<s% 8 8# 8 8# 8rcX^RIHp\T!Y;'gR44p\P P\P PV44# \d@\P P \P PT44pLi;i)zOne key per on-disk target: the file tools' task-resolved absolute path, case-folded on case-insensitive hosts. A failure recorded as ``notes.md`` and the write that later lands as ``/repo/notes.md`` (or ``Notes.md`` on Windows) must meet on the same key.)_resolve_path_for_taskdefault) tools.file_tools_pathsr4r Exceptionosr0abspath expandusernormcasenormpath)r0r1r4resolveds&& r_file_mutation_identityr><sz=A-d4H4HyIJ 77  BGG,,X6 77 =77??277#5#5d#;<=sA AAB)(B)cFV^8dQhR\R\\,/#)ridentityr)rrtuple)rs"rrrIs((3(8E?(rc\P!V4pTPTP3# \dR#i;i)zX``(mtime_ns, size)`` of the target, ``None`` when it does not exist (or cannot be read).N)r8statOSError st_mtime_nsst_size)r@sts& r_file_stat_signaturerHIs> WWX  NNBJJ '' s 0 ??cHV^8dQhR\R\R\R\/#)renv_var config_key cache_attrr)rbool)rs"rrrRs)ScsW[rc \PPV4pVe"VP4P 4R9#\ WR4pVeV#^RIHpV!4;'g/p\V\4'dVPR4MRp\V\4'd"W(9d\VPV44p MRp \WV 4V # \d/pLi;i \dR#i;i)uV``display.`` (default True), cached per agent on ``cache_attr``. ``env_var`` overrides on every call and is never cached. Reads the persisted config.yaml so gateway and CLI share the setting; ``load_config`` is imported lazily (startup cycle, and tests patch it at ``hermes_cli.config``). Any failure → True (safe default: on).N) load_configdisplayT>0noofffalse) r8environgetstriplowergetattrhermes_cli.configrOr7 isinstancedictrMsetattr) agentrJrKrLenvcached _load_config_cfg_displayenableds &$$$ r_display_flag_enabledreRs jjnnW% ?99;$$&.II ID1  M  E>''RD+5T4*@*@488I&d h % %**@8<< 34GG7+ D  sCAC3C3C -C 0A/C3 C0-C3/C00C33 DDca]tRt^otoRtRR/V3RlRllt]V3RlRl4tV3RlR ltV3R lR lt ] P!R 4t ] V3R lRl4t] V3RlRl4t]RV3RlRll4tRtVtR#)TurnExplainersMixinzPFile-mutation failure footer + turn-completion explainer (see module docstring).r1Nc b<V^8dQhRS[RS[S[S[3,RS[RS[RS[S[,RR/#)r tool_nameargsresultis_errorr1rN)rr\rrMr)r __classdict__s"rr TurnExplainersMixin.__annotate__rsK2*2*2*$(cN2* setdefaultrHlistitemsrVpop)selfrirjrkrlr1statetargetslanded landed_pathschangedmgrrs_ppreviewr0r@pclearedinfos&&&&&$ r_record_file_mutation_result0TurnExplainersMixin._record_file_mutation_resultrs 0 0 ;TB = 0A ,Y? >yPVWLd$?FG"|,$ 148C73 5#A#AM-g.B.BCK*%i00222610+ F,V4G24A  I&2Fx2P( +1,g==A(73= #5;;=1 d88J(?(NOSZZIIdD)2!100sGG G c~<V^8dQhRS[S[S[S[S[3,3,RS[S[S[S[S[3,3,/#rfailedrr\rr)rrms"rrrnsE   T#tCH~2E-F  4PSUYZ]_bZbUcPcKd  rc VP4UUu/uF.wrRV9g!\VR,4VR,8XgK,WbK0 upp#uuppi)agDrop entries whose target changed on disk since the failed call. The recorder only sees write_file/patch receipts; a terminal redirect or an execute_code write leaves none. Re-checking the stat signature at turn end keeps the footer from listing a file that was in fact modified later this turn. Entries without a snapshot (hand-built dicts) are kept as-is. rCr@)r{rH)rr0rs& r_file_mutations_still_failed0TurnExplainersMixin._file_mutations_still_failedsS*0 )7:4T!%9$z:J%KtTZ|%[ DJ   s )A A c <V^8dQhRS[/#rrrM)rrms"rrrns   rc \VRRRR7#)zZ``display.file_mutation_verifier`` / ``HERMES_FILE_MUTATION_VERIFIER`` (a patchable seam).HERMES_FILE_MUTATION_VERIFIERfile_mutation_verifier%_file_mutation_verifier_enabled_cacherJrKrLrer}s&r_file_mutation_verifier_enabled3TurnExplainersMixin._file_mutation_verifier_enableds$ 9F^>  rc <V^8dQhRS[/#rr)rrms"rrrns  D rc \VRRRR7#)zM``display.turn_completion_explainer`` / ``HERMES_TURN_COMPLETION_EXPLAINER``. HERMES_TURN_COMPLETION_EXPLAINERturn_completion_explainer(_turn_completion_explainer_enabled_cacherrrs&r"_turn_completion_explainer_enabled6TurnExplainersMixin._turn_completion_explainer_enableds$ >TurnExplainersMixin._neutralize_footer_paths..s1QWWQZL1Br)_FOOTER_PATH_REsub)clsrs&&r_neutralize_footer_paths,TurnExplainersMixin._neutralize_footer_pathss& K""&&'BDIIrcR<V^8dQhRS[S[S[S[S[3,3,RS[/#rr)rrms"rrrns.>>$sDcN?R:S>X[>rc  >V'gR#\R\V4R7.p\VP44R,pVFywrEVP R4;'gRP 4pVP R4;'gRpTP \RYGT;'g \R 4R 74K{ \V4\V4, pV^8dVP \R VR74VPR PV44#) aRender the per-turn failed-mutation dict as a user-facing footer. Up to 10 paths with their first error preview, then an overflow count; "" when nothing failed. Every path is backtick-wrapped via ``_neutralize_footer_paths`` so protected files cannot be auto-delivered. zexplainer.file_mutation.header)count:N Nrurtpatchzexplainer.file_mutation.entryzexplainer.file_mutation.failed)r0rtrzexplainer.shared.and_more ) rlenrzr{rVrWappendrjoin) rrlinesshownr0rrrt remainings && r$_format_file_mutation_failure_footer8TurnExplainersMixin._format_file_mutation_failure_footers33v;GHV\\^$S)JDxx066B==?G88F#..wD LL:#*#Q#Qa0P.QS T K#e*, q= LL6iH I++DIIe,<==rcB<V^8dQhRS[RS[S[,RS[RS[/#)rturn_exit_reasonpersistence_causerrr2)rrms"rrrns7)E)E)E2:3-)E]`)E )Erc  ~V'gR#\V4pVPR4'dR#\PV4pVf+\F wrgVPV4'gKTpM Ve!\ YS;'g \ R4R7pMVR8Xd^RIHp Hp ^RI H p R V !4R V !4R V R RR R/p VR9dD^RIH p ^RI H p\T;'gV!44V R &\V !4R, 4V R &\ \V43/V BpMRpV'd\ R4V,#R#)zUser-facing explanation for an abnormal turn ending, or "" for normal / unknown reasons. ``text_response(...)`` is the healthy terminal; unknown/diagnostic-only reasons (e.g. ``guardrail_halt``, which surfaces its own message) are not second-guessed. r text_responseNrrsession_persistence_failed)display_hermes_homeprofile_cli_selector)STORAGE_RECOVERY_DOCS_URLhome profile_arg recovery_docsdb_path backups_dir)get_default_hermes_root)_default_db_pathbackupszexplainer.no_reply_prefix)corrupt fts_index)r startswith_EXIT_REASON_EXPLANATIONSrV _EXIT_REASON_PREFIX_EXPLANATIONSrhermes_constantsrrhermes_state_errorsrr hermes_staterr.)rrrrreasonkeyr( prefix_keybodyrrrfillrrs&&&& r#_format_turn_completion_explanation7TurnExplainersMixin._format_turn_completion_explanations2 %&   _ - -'++F3 ;&F"$$V,,$C'G ?S H H+G)HID 3 3 R E +-}>R>T!:Ir=Z\$D!$<<D9"%g&C&C1A1C"DY&)*A*Ci*O&P]#12CDMMDD8>,)E)E)ErrgcbV^8dQh/^\9d\\\3,;R&#)rr)__conditional_annotations__r\r)rs"rrrs,B  4S> Cr)r)interrupted_during_api_callmax_iterations_reachederror_near_max_iterationsrepeated_outer_errors> disklockedrreplacedr turn_lease compression deleted_walcompression_closedsession_row_missing)!rrr8r contextlibrtypingrrr agent.i18nragent.tool_dispatch_helpersrr r agent.tool_result_classificationr rvr EMPTY_RESPONSE_EXPLANATIONrrrAr frozensetr-r.r>rHrergr)rs@rrs  &&B Y :')[G!#O%'W$&U9&(Y? - $)5)8g)55)8g)$  !pqq 8(:dEdEr