[jdZddlmZddlmZddlmZmZmZm Z ddl Z e j e Z edGdd ZddZ dddZdS)uUProfile-based routing for the gateway with hierarchical matching. Allows a single Hermes instance to route specific Discord guilds/channels/threads to different profiles — each with their own model, tools, memory, and persona. Matching priority (most specific first): 1. platform + chat_id + thread_id (exact thread) — specificity 14 2. platform + chat_id (channel route) — specificity 6 3. platform + guild_id (guild/server route) — specificity 2 4. No match → default profile Parent-chain matching: For Discord threads and forum posts, ``parent_chat_id`` carries the direct parent (the channel for a thread, the forum channel for a post). Routes keyed on a channel match both direct messages and messages in any thread/post whose parent is that channel. Configuration (config.yaml): gateway: profile_routes: - name: server-default platform: discord guild_id: "YOUR_GUILD_ID" profile: server-profile - name: special-channel platform: discord guild_id: "YOUR_GUILD_ID" chat_id: "YOUR_CHANNEL_ID" profile: channel-profile - name: thread-route platform: discord chat_id: "YOUR_CHANNEL_ID" thread_id: "YOUR_THREAD_ID" profile: thread-profile ) annotations) dataclass)AnyDictListOptionalNT)frozenceZdZUdZded<ded<ded<dZded<dZded <dZded <d Zd ed <e ddZ dddZ dS) ProfileRoutez>A single routing rule that maps a platform scope to a profile.strnameplatformprofileN Optional[str]guild_idchat_id thread_idTboolenabledreturnintcRd}|jr|dz }|jr|dz }|jr|dz }|S)z#Higher value = more specific match.r)rrr)selfss 9/home/ice/.hermes/hermes-agent/gateway/profile_routing.py specificityzProfileRoute.specificity>sG  =  FA <  FA >  FAparent_chat_idc|jsdS|j|krdS|jr |j|krdS|jr|j|kr |j|krdS|jr |j|krdSdS)a$Return True if this route matches the given source fields. All configured discriminators are matched conjunctively (AND): every discriminator that the route declares must hold. ``chat_id`` supports hierarchical matching for Discord forums/threads: - Direct channel match: chat_id == route.chat_id - Thread in channel: parent_chat_id == route.chat_id A route declaring both ``guild_id`` and ``chat_id`` requires both to match (a chat match alone does not satisfy a guild constraint). FT)rrrrr)rrrrrr!s rmatcheszProfileRoute.matchesJs$| 5 =H $ $5 > dn 995 < DLG33 8V8V5 = T]h665tr )rrNNNN) rr rrrrrrr!rrr) __name__ __module__ __qualname____doc____annotations__rrrrpropertyrr#r rr r 2sHH IIIMMMLLL"H""""!G!!!!#I####G    X #'!%#'(, r r rawOptional[List[Dict[str, Any]]]rList[ProfileRoute]c"|sgSg}|D]D}t|ts|dd}|dd}|dd}|r|std|{ ddlm}m}||}||n3#ttf$rtd||YwxYw| t||||d |d |d |d d F| dd t dt||S)zParse profile_routes from config.yaml into ProfileRoute objects. Returns routes sorted by specificity (most specific first). r rrz6Skipping profile route %s: missing platform or profiler)normalize_profile_namevalidate_profile_namez2Skipping profile route %s: invalid profile name %rrrrrT)r rrrrrrc|jS)N)r)rs rz&parse_profile_routes..samr )keyreversez.Loaded %d profile routes (most-specific-first)) isinstancedictgetloggerwarninghermes_cli.profilesr1r2 ValueError ImportErrorappendr sortdebuglen)r,routesentryr rrr1r2s rparse_profile_routesrFis  !#F" " %&&  yy$$99Z,,))Ir** w  NNH             -,W55G ! !' * * * *K(    NNOQUW^ _ _ _ H   !:.. ),,))K00 )T22     KK++TK::: LLA3v;;OOO MsB$$-CCrDrr rrrrr!Optional[ProfileRoute]cL|D] }||||||r|cS!dS)z5Return the best-matching route, or None for no match.)rrrr!N)r#)rDrrrrr!routes rmatch_profile_routerJsF ==HgQZky= z z LLL  4r )r,r-rr.r$)rDr.rr rrrrrrr!rrrG)r( __future__r dataclassesrtypingrrrrlogging getLoggerr%r;r rFrJr+r rrPs%%N#"""""!!!!!!,,,,,,,,,,,,  8 $ $ $33333333l....h#!#$(       r