+ JizRt^RIt^RIt^RIHtHtHtHtH t ^RI t ^RI H t ] !4R, t !RR4tR#)a Event Hook System A lightweight event-driven system that fires handlers at key lifecycle points. Hooks are discovered from ~/.hermes/hooks/ directories, each containing: - HOOK.yaml (metadata: name, description, events list) - handler.py (Python handler with async def handle(event_type, context)) Events: - gateway:startup -- Gateway process starts - session:start -- New session created (first message of a new session) - session:end -- Session ends (user ran /new or /reset) - session:reset -- Session reset completed (new session entry created) - agent:start -- Agent begins processing a message - agent:step -- Each turn in the tool-calling loop - agent:end -- Agent finishes processing - command:* -- Any slash command executed (wildcard match) Errors in hooks are caught and logged but never block the main pipeline. N)AnyCallableDictListOptional)get_hermes_homehooksca]tRt^"toRtRt]V3RlRl4tV3RlRltV3RlRlt R V3R lR llt R t Vt R #) HookRegistryz Discovers, loads, and fires event hooks. Usage: registry = HookRegistry() registry.discover_and_load() await registry.emit("agent:start", {"platform": "telegram", ...}) c"/Vn.VnR#N _handlers _loaded_hooksselfs&*/home/ubuntu/hermes-agent/gateway/hooks.py__init__HookRegistry.__init__,s46)+c0<V^8dQhRS[S[,/#)return)rdict)format __classdict__s"r __annotate__HookRegistry.__annotate__2s((d4j(rc ,\VP4#)z'Return metadata about all loaded hooks.)listrrs&r loaded_hooksHookRegistry.loaded_hooks1sD&&''rc<V^8dQhRR/#rrN)rrs"rrr6s T T Trc  ^RIHpVPPR.4P V4VP P RRRRRR.RR /4R # \ dp\R T 2R R 7R p?R #R p?ii;i)z/Register built-in hooks that are always active.)handlezgateway:startupnamezboot-md descriptionz(Run ~/.hermes/BOOT.md on gateway startupeventspathz (builtin)z.[hooks] Could not load built-in boot-md hook: TflushN)gateway.builtin_hooks.boot_mdr&r setdefaultappendr Exceptionprint)rboot_md_handlees& r_register_builtin_hooks$HookRegistry._register_builtin_hooks6s T N NN % %&7 < C CN S    % % I,- '   T B1#Fd S S TsAA A?$A::A?c<V^8dQhRR/#r#r$)rrs"rrrEsCVCV4CVrc  vVP4\P4'gR#\\P 44EF3pVP 4'gKVR, pVR, pVP4'dVP4'gK\\ P!VPRR74pV'd\V\4'g\RVP R2RR 7KVPR VP4pVPR .4pV'g\RV R 2RR 7EK\PP!R V 2V4pVeVP"f\RV R2RR 7EKQ\PP%V4pVP"P'V4\)VRR4p V f\RV R2RR 7EKVF.p VP*P-V .4P/V 4K0 VP0P/R VRVPRR4R VR\3V4/4\RV RV 2RR 7EK6 R# \4d*p \RTP RT 2RR 7Rp ? EKiRp ? ii;i)a Scan the hooks directory for hook directories and load their handlers. Also registers built-in hooks that are always active. Each hook directory must contain: - HOOK.yaml with at least 'name' and 'events' keys - handler.py with a top-level 'handle' function (sync or async) Nz HOOK.yamlz handler.pyzutf-8)encodingz[hooks] Skipping z: invalid HOOK.yamlTr+r'r)z: no events declared hermes_hook_z: could not load handler.pyr&z: no 'handle' function foundr(r*z[hooks] Loaded hook 'z' for events: zooks] Error loading hook z: )r4 HOOKS_DIRexistssortediterdiris_diryaml safe_load read_text isinstancerr1r'get importlibutilspec_from_file_locationloadermodule_from_spec exec_modulegetattrrr.r/rstrr0) rhook_dir manifest_path handler_pathmanifest hook_namer)specmodule handle_fneventr3s & rdiscover_and_loadHookRegistry.discover_and_loadEsg $$&!! y0023H??$$${2M#l2L ''))1D1D1F1F* V>>-*A*A7*A*STz(D'A'A-hmm_ ''/#FHd; $-i[8TU]ab$ENN--eR8?? J$""))I!8<< r#BfCM +-i[vhOW[\\c4f V3HMM?"QCHPTUU Vs?'-J1J5J>JAJAJ:BJ J8J33J8NcP<V^8dQhRS[RS[S[S[S[3,,RR/#)r event_typecontextrN)rLrrr)rrs"rrrs5 W WS W8DcN3K WW[ Wrc "Vf/p\VPPV.44pRV9dIVPR4^,pV R2pVP VPPV.44VF4pV!W4p\ P !V4'd VGRjxL K4K6 R#L \dp\RT RT 2RR7Rp?K`Rp?ii;i5i)a Fire all handlers registered for an event. Supports wildcard matching: handlers registered for "command:*" will fire for any "command:..." event. Handlers registered for a base type like "agent" won't fire for "agent:start" -- only exact matches and explicit wildcards. Args: event_type: The event identifier (e.g. "agent:start"). context: Optional dict with event-specific data. N:z:*z[hooks] Error in handler for 'z': Tr+) rrrDsplitextendasyncio iscoroutiner0r1) rrYrZhandlersbase wildcard_keyfnresultr3s &&& remitHookRegistry.emits ?G**:r:; * ##C(+D"V2;L OODNN..|R@ AB WJ0&&v.. LL/  ! W6zl#aSIQUVV WsBBC')B;,B9-B;1C'9B;; C$CC'C$$C'r r ) __name__ __module__ __qualname____firstlineno____doc__rpropertyr r4rVrf__static_attributes____classdictcell__)rs@rr r "sP, (( T TCVCVJ W W Wrr )rlr_importlib.utilrEtypingrrrrrr@hermes_cli.configrr;r r$rrrss;*66 -   ' HWHWr