+ jHj Rt^RIt^RIt^RIt^RIt^RIHt^RIH t H t H t H t H t ^RIt^RIHt^RIHt]!4R, t]tRRltR R ltR R lt!R R4t!RR4tR#)avEvent hook system: fires handlers at gateway lifecycle points. Hooks live in ~/.hermes/hooks// with HOOK.yaml (name, description, events) and handler.py (``def handle(event_type, context)``, sync or async); errors never block the pipeline. Events: gateway:startup, session:start/end/reset, agent:start, agent:step (each tool-loop turn), agent:end, command:* (wildcard). agent:* context: platform, user_id, chat_id, thread_id ("" outside a thread), chat_type ("dm"|"group"|"forum"|""), session_id, message (500 chars); agent:end adds response, model, provider. Forum follow-ups pass ``message_thread_id=int(thread_id)``. NPath)AnyCallableDictListOptional)get_hermes_home)hermes_home_keyhooksc$V^8dQhR\/#returnr)formats"2/home/ubuntu/.hermes/hermes-agent/gateway/hooks.py __annotate__rs]]D]c\\\4pV\8wdV#\4R, #)aActive profile's hooks dir at call time: the patched ``HOOKS_DIR`` when a test changed it, else ``get_hermes_home()/hooks``. The import-time constant is the LAUNCH profile's; under ``gateway.multiplex_profiles`` every served profile has its own ``hooks/``, and a registry loaded from the launch home would run the default profile's handlers (arbitrary Python) on every other profile's messages, responses and user ids.r )r HOOKS_DIR_HOOKS_DIR_AT_IMPORTr ) configureds r_resolve_hooks_dirrs) iJ#';;:\ARU\A\\rc4V^8dQhR\R\RR/#)rnamereasonrN)str)rs"rrr's!<<)>~~m55{5KLH :h55X]]$788 VX]]3I \\(B 'F Y 455! ,K >> 1 1+ LD |t{{*Y ;<< ^^ , ,T 2F%CKK  '$/IY <== imR)H HH   T* s F-G ca]tRt^KtoRtRt]V3RlRl4tV3RlRltV3RlRlt V3R lR lt RV3R lR llt RV3RlRllt Rt VtR #) HookRegistryz(Discovers, loads, and fires event hooks.c"/Vn.VnR#N _handlers _loaded_hooksselfs&r__init__HookRegistry.__init__Ns46)+rc0<V^8dQhRS[S[,/#r listr2)r __classdict__s"rrHookRegistry.__annotate__Ss((d4j(rc,\VP4#rK)rUrNrOs&r loaded_hooksHookRegistry.loaded_hooksRsD&&''rc<V^8dQhRR/#rrN)rrVs"rrrWVsTTTrc R#)zEExtension point for always-on built-in hooks; currently none shipped.Nr]rOs&r_register_builtin_hooks$HookRegistry._register_builtin_hooksVsrc<V^8dQhRR/#r\r])rrVs"rrrWYsYY4Yrc  ZVP4\4pVP4'gR#\VP 44FpVP 4'gK\ V4pTfK-TwrVrxTF.p TPPT .4PT4K0 TPPRTRTRTR \T4/4\R T R T 2RR7K R# \d)p\RTP RT 2RR7Rp?KRp?ii;i) z^Register built-in hooks, then load every valid hook dir under the active profile's ``hooks/``.Nzooks] Error loading hook rTrrr+r(pathz[hooks] Loaded hook 'z' for events: )r_rr-sortediterdiris_dirrGr<r!rrM setdefaultappendrNr) rP hooks_dirr$loadederBr(rFr+events & rdiscover_and_loadHookRegistry.discover_and_loadYs $$&&( !! y0023H??$$ '1~8> 5Iy))%4;;IF    % %M;&RXZ]^fZgh  ))N6(KSW X!4  3HMM?"QCHPTU s( C77 D*D%%D*c6<V^8dQhRS[RS[S[,/#)r event_typer)rrUr)rrVs"rrrWqsCDNrc \VPPV.44pRV9dEVPVPPVP R4^, R2.44V#)uExact-match handlers first, then ``:*`` wildcards. A bare base type ("agent") does NOT fire for "agent:start" — only exact matches and explicit wildcards.:z:*)rUrMr3extendsplit)rPrphandlerss&& r_resolve_handlersHookRegistry._resolve_handlersqsb**:r:; *  OODNN..*2B2B32G2J1K2/NPRS TrNcP<V^8dQhRS[RS[S[S[S[3,,RR/#rrpcontextrNrrr2r)rrVs"rrrWys055S58DcN3K5W[5rc D"VPW4GRjxL R#L5i)z9Fire all handlers for an event, discarding return values.N) emit_collectrPrprzs&&&remitHookRegistry.emitys 444s   cb<V^8dQhRS[RS[S[S[S[3,,RS[S[,/#rrprzrrrr2rrU)rrVs"rrrW}s6S8DcN;S_cdg_hrc :"Vf/p.pVPV4FKpV!W4p\P!V4'd VGRjxL MTpVeVPV4KKKM V#L# \dp\ RT RT 2RR7Rp?KwRp?ii;i5i)zFire handlers and return their non-None return values in order (decision-style hooks, e.g. ``command:`` policies). A failing handler is logged, not fatal.Nz[hooks] Error in handler for 'z': Tr)rvasyncio iscoroutinerhr<r!)rPrprzresultsfnresultrks&&& rr}HookRegistry.emit_collect}s ?G((4B WJ0)0)<)rsj  66-,   '  ]<I@@@F'F'Fr