idZddlmZddlZddlZddlZddlZddlmZm Z ddl m Z ddl m Z m Z ddlmZe rddlmZejeZeZeGd d ZGd d ZdS) z9Honcho-based session management for conversation history.) annotationsN) dataclassfield)datetime)Any TYPE_CHECKING)get_honcho_client)HonchoceZdZUdZded<ded<ded<ded<eeZded <eej Z d ed <eej Z d ed <ee Z d ed<ddZdddZddZdS) HonchoSessionz A conversation session backed by Honcho. Provides a local message cache that syncs to Honcho's AI-native memory system for user modeling. strkey user_peer_idassistant_peer_idhoncho_session_id)default_factorylist[dict[str, Any]]messagesr created_at updated_atdict[str, Any]metadatarolecontentkwargsrreturnNonec ||tjd|}|j|tj|_dS)z!Add a message to the local cache.)rr timestampN)rnow isoformatrappendr)selfrrrmsgs B/home/piyush/.hermes/hermes-agent/plugins/memory/honcho/session.py add_messagezHonchoSession.add_message*s^!1133     S!!!",..2 max_messagesintcxt|j|kr|j| dn|j}d|DS)z$Get message history for LLM context.Nc0g|]}|d|ddS)rrrr.0ms r% z-HonchoSession.get_history..<s(MMM6q|<<MMMr')lenr)r#r)recents r% get_historyzHonchoSession.get_history5sO4=!!L00 M<-.. ) )  NMfMMMMr'cDg|_tj|_dS)z"Clear all messages in the session.N)rrr rr#s r%clearzHonchoSession.clear>s ",..r'N)rr rr rrrr)r()r)r*rrrr)__name__ __module__ __qualname____doc____annotations__rlistrrr rrdictrr&r5r8r.r'r%r r s HHH%*U4%@%@%@H@@@@ 5>>>J>>>> 5>>>J>>>>$uT:::H:::: ) ) ) )NNNNN))))))r'r ceZdZdZ dZd[d Zed\dZd]dZd^dZd_dZ d`dZ dadZ dbd!Z dcd"Z dbd#Zdbd$Zddd%Zd`d&Zd'Zded(Z dfdgd.Zdhdid0Zdjd3Zdkd4Zdhdld5Zdmd8Zednd:Zdod<Zedpd?Zdd@dqdBZ dhdd@drdEZdsdtdFZ dudGZ!dvdIZ"dsdwdJZ# dxdydNZ$dsdzdPZ%dsd{dRZ&dsd|dTZ'd}d~dWZ(dkdXZ)ddYZ*dS)HonchoSessionManagerz Manages conversation sessions using Honcho. Runs alongside hermes' existing SQLite state and file-based memory, adding persistent cross-session user modeling via Honcho's AI-native memory. Nhoncho Honcho | Nonecontext_tokens int | Noneconfig Any | Noneruntime_user_peer_name str | Nonec||_||_||_||_i|_t j|_i|_i|_ |r|j nd}||_ d|_ i|_ t j|_|r|jnd|_|r|jnd|_|r|jnd|_|r|jnd|_|r|jnd|_|r|jnd|_|r|jnd|_|r|jnd|_|r|j nd|_!|r|j"nd|_#d |_$d |_%|dkrTtMj'|_$t j(|j)d d |_%|j%*d Sd S) a Initialize the session manager. Args: honcho: Optional Honcho client. If not provided, uses the singleton. context_tokens: Max tokens for context() calls (None = Honcho default). config: HonchoClientConfig from global config (provides peer_name, ai_peer, write_frequency, observation, etc.). runtime_user_peer_name: Gateway user identity for per-user memory scoping. asyncrlowTiX directionaliai'Nzhoncho-async-writertargetnamedaemon)+_honcho_context_tokens_config_runtime_user_peer_name_cache threadingRLock _cache_lock _peers_cache_sessions_cachewrite_frequency_write_frequency _turn_counter_context_cacheLock_prefetch_cache_lockdialectic_reasoning_level_dialectic_reasoning_leveldialectic_dynamic_dialectic_dynamicdialectic_max_chars_dialectic_max_charsobservation_mode_observation_modeuser_observe_me_user_observe_meuser_observe_others_user_observe_others ai_observe_me_ai_observe_meai_observe_others_ai_observe_othersmessage_max_chars_message_max_charsdialectic_max_input_chars_dialectic_max_input_chars _async_queue _async_threadqueueQueueThread_async_writer_loopstart)r#rCrErGrIr]s r%__init__zHonchoSessionManager.__init__Ls" - '=$02 $?,,,./16<H611 /"# 02$-N$4$4!06 AF , ,E ')/ 8F $ $D +1 9F & &c !(. @F # #= AG&Pf&<&.s!VVVqValVVVr'zEHoncho messages not chronologically ordered for session '%s', sortingc(|jp tjSN)rrmin)r1s r%zDHonchoSessionManager._get_or_create_honcho_session..sal&Bhlr')rz4Honcho session '%s' retrieved (%d existing messages)z!Honcho session '%s' created (new)z8Honcho session '%s' loaded (failed to fetch context: %s))rZr\loggerdebugrCsessionhoncho.sessionrrlrnrprr add_peersget_peer_configurationrr ExceptionwarningcontextrTrr3sortedinfo)r#rrrrr user_config ai_config server_user server_aieexisting_messagesctx timestampss r%_get_or_create_honcho_sessionz2HonchoSessionManager._get_or_create_honcho_sessions%  < <T111 GTTT+J7; < < < < < < < <1 < < < < < < < < < < < < < < < +%%j11'  8 8 8 8 8 8++0#8K*).#6I    ;7.)9TU V V V  a%<JJ )5,7,BD)-90;0JD-'3*3*>D'+7.7.FD+ f)4+D')@  a a a \^_```````` a    NNFA          //$t7K/LLC # 2 ! S):%;%;a%?%?VV4EVVV *z0B0B"B"BNN_")/)BB)))% ! M J$5 6 6  ?LLL    NNJA          ,3Z()))sn3AAA;AF' B(E43F'4 F#>FF'F##F'' G1GGCJ-- K7KKid_strc.tjdd|S)z9Sanitize an ID to match Honcho's pattern: ^[a-zA-Z0-9_-]+z[^a-zA-Z0-9_-]-)resub)r#rs r% _sanitize_idz!HonchoSessionManager._sanitize_id sv'f555r'rr c|j5||jvr4td||j|cdddS dddn #1swxYwY|jduo:t t |jddot |jdddu}|jr|s||j}n|jr,|jj r ||jj }nk| dd}t|dkr|d nd }t|dkr|dn|}|d |d |}||jr |jj nd }||}| |} | |} ||| | \} } g} | D]P}|j|krdnd}| ||j|jr|jndddQt)||||| }|j5||j|<dddn #1swxYwY|S)z Get an existing session or create a new one. Args: key: Session key (usually channel:chat_id). Returns: The session. zLocal session cache hit: %sN peer_name pin_peer_nameFT:rrdefaultzuser-rzhermes-assistant assistantuser)rrr_synced)rrrrr)rZrWrrrUboolgetattrrVrrsplitr3ai_peerrrrr"rrr!r )r#rrrpartschannelchat_idrrrrhoncho_sessionrlocal_messagesr$rrs r% get_or_createz"HonchoSessionManager.get_or_createsm  ( (dk!! :C@@@{3' ( ( ( ( ( ( ( (! ( ( ( ( ( ( ( ( ( ( ( ( ( ( (( L $ FWT\;==>> F ou==E   ' J  J,,T-IJJLL \ Jdl4 J,,T\-CDDLLIIc1%%E"%e**q..eAhhiG"%e**q..eAhhcG,,-HW-H-Hw-H-HIIL --$(L HDL 6H   !--c22,,\:: 112CDD,0,N,N y.- - ))$  C"%+1B"B"B;;D  ! !;;>>QS^55777r ##     %//#      ' '&DK  ' ' ' ' ' ' ' ' ' ' ' ' ' ' 's#1AAA I,,I03I0rrc|jsdS||j}||j}|j|j}|s||j||\}}d|jD}|sdSg}|D]@}|ddkr|n|} || |dA | ||D]}d|d<t dt||j|j5||j|j<dddn #1swxYwYdS#t"$r^} |D]}d |d<td | |j5||j|j<dddn #1swxYwYYd} ~ d Sd} ~ wwxYw) z:Internal: write unsynced messages to Honcho synchronously.Tc<g|]}|d|S)rgetr/s r%r2z7HonchoSessionManager._flush_session..ks)LLLa155;K;KLLLLr'rrrrz#Synced %d messages to Honcho for %sNFz%Failed to sync messages to Honcho: %s)rrrrr\rrrr"message add_messagesrrr3rrZrWrerror) r#rrrr_ new_messageshoncho_messagesr$rrs r%_flush_sessionz#HonchoSessionManager._flush_session]s 4,,W-ABB 11'2KLL-11'2KLL  $ B B)9n!! NAML7#3LLL  4 A AC #F v 5 599>D  " "4<<I#?#? @ @ @ @   ' ' 8 8 8# & &!%I LL>O@T@TV]Va b b b! 3 3+2 GK( 3 3 3 3 3 3 3 3 3 3 3 3 3 3 34   # ' '!&I LL@! D D D! 3 3+2 GK( 3 3 3 3 3 3 3 3 3 3 3 3 3 3 355555  saAE-E = E E  EE E F> ,F9 F( F9(F, ,F9/F, 0F99F>rc |jd}|turdSd} ||}n#t$r}d}|}Yd}~nd}~wwxYw|r_|t d|nt dddl}|d  ||}n2#t$r%}t d |Yd}~d}~wwxYw|st d nC#tj $rY(t$r%}t d |Yd}~nd}~wwxYwZ) z7Background daemon thread: drains the async write queue.TtimeoutNFz,Honcho async write failed, retrying once: %sz(Honcho async write failed, retrying oncerz3Honcho async write retry failed, dropping batch: %sz/Honcho async write retry failed, dropping batchzHoncho async writer error: %s) rwr_ASYNC_SHUTDOWNrrrrtimesleeprryEmpty)r#item first_errorsuccessr_time retry_successe2s r%r|z'HonchoSessionManager._async_writer_loops# A" A(,,Q,77?**E04 $"11$77GG $$$#G"#KKKKKK$*NN#QS^____NN#MNNN$$$$ A$($7$7$=$=MM LL!VXZ[[[HHHH%TLL!RSSS;    A A A >>(--eU-KKQrFF(---(-. F#66~FF $))%)GGM2 W$3 WF dF_8_8_ :!: :;BB3JJ1MPVVM    NN> B B B22222 sCE99 F)F$$F) user_messagecpfd}tj|dd}|dS)z Fire get_prefetch_context in a background thread, caching the result. Non-blocking. Consumed next turn via pop_context_result(). This avoids a synchronous HTTP round-trip blocking every response. ch}|r|dSdSr)get_prefetch_contextset_context_result)rr#rrs r%_runz3HonchoSessionManager.prefetch_context.._runXsF..{LIIF ='' V<<<<< = =r'zhoncho-context-prefetchTrON)rXr{r})r#rrr ts``` r%prefetch_contextz%HonchoSessionManager.prefetch_contextQsT = = = = = = =  D/HQU V V V  r'rdict[str, str]cb|sdS|j5||j|<ddddS#1swxYwYdS)z7Store a prefetched context result in a thread-safe way.N)rbr`)r#rrs r%r z'HonchoSessionManager.set_context_result`s  F  & 6 6/5D  , 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6s $((cz|j5|j|icdddS#1swxYwYdS)z Return and clear the cached context result for this session. Returns empty dict if no result is ready yet (first turn). N)rbr`r)r#rs r%pop_context_resultz'HonchoSessionManager.pop_context_resultgs  & < <&**;;; < < < < < < < < < < < < < < < < < .s&???aeeK,,???r'rz to unknownzz zQThis conversation history occurred BEFORE the Honcho memory system was activated.zQThese messages are the preceding elements of this conversation session and shouldzPbe treated as foundational context for all subsequent interactions. The user andzCassistant have already established rapport through these exchanges.z rzr?rr[z] z: z zrutf-8)r3rr"rencode) rrr time_rangelinesr$tsrrs r%r$z1HonchoSessionManager._format_migration_transcripts]@?h??? ?IX 1 ;;:b>;;;y  +  _ _ ^ Q   V V Vc(mm V V V 4j 4 4 4    6 6Cc**B7769--Dggi((.BG LL4R44444744 5 5 5 5 R _%%% 4555yy&&w///r' memory_dirc ddlm}||}|sdS|j|}|st d|dS|j|j}|st d|dS| |j }| |j }d} ddd|d fd d d |d fd dd|dfg} | D]\} } } }}|| z }|s"| d }|sMd| d|d} || |ddf|d| |dt d| ||d} #t"$r&}t d| |Yd}~d}~wwxYw| S)a Upload MEMORY.md and USER.md to Honcho as files. Used when Honcho activates on an instance that already has locally consolidated memory. Backwards compatible -- skips if files don't exist. Args: session_key: The session key to associate files with. memory_dir: Path to the memories directory (~/.hermes/memories/). Returns: True if at least one file was uploaded, False otherwise. r)PathFz;No local session cached for '%s', skipping memory migrationz This file was consolidated from local conversations BEFORE Honcho was activated. z;. Treat as foundational context for this user. z r local_memory)r! original_filer)r#rrz&Uploaded %s to Honcho for %s (%s peer)Tz!Failed to upload %s to Honcho: %sN)pathlibr8existsrWrrrr\rrrr read_textstripr%r2rrr)r#rr6r8 memory_pathrrrruploadedfilesfilename upload_name descriptionr target_kindfilepathrwrappedrs r%migrate_memory_filesz)HonchoSessionManager.migrate_memory_filess !     d:&& !!## 5+//+..  NNXZe f f f5-11'2KLL  NNY[f g g g5,,W-ABB 11'2KLL(7  !.  :   0MR% O% O HHk; ["X-H??$$ (('(::@@BBG ***  ***  O**%w~~g'>'> M$"0)1'2+ <    O O O @(ANNNNNNNN OsAF GF??Gr list[str]cl|sgSt|tr d|DSt|gS)z.Xs#777$$7CII777r')rr?r )rs r%_normalize_cardz$HonchoSessionManager._normalize_cardRsE I dD ! ! 877$777 7D {r'rrPc\||}t|dd}t|r+|| ||n |St|dd}t|r+|| ||n |SgS)zFetch a peer card directly from the peer object. This avoids relying on session.context(), which can return an empty peer_card for per-session messaging sessions even when the peer itself has a populated card. get_cardNrr)rrcallablerN)r#rrPrgetter legacy_getters r%_fetch_peer_cardz%HonchoSessionManager._fetch_peer_card[s''00z400 F   c''ASf(=(=(=(=Y_Y_YaYabb bfd33 M " " q''HZ V(D(D(D(D`m`m`o`opp p r'rrc||}d}g} i}|||d<|||d<|r |jd i|n|}t|ddpt|ddpd}|t|dd}n3#t$r&} t d|| Yd} ~ nd} ~ wwxYw|sc ||| n|pd}n3#t$r&} t d || Yd} ~ nd} ~ wwxYw|sL ||| }n3#t$r&} t d || Yd} ~ nd} ~ wwxYw||d S)z=Fetch representation + peer card directly from a peer object.rNrPrrpeer_representation peer_cardz)Direct peer.context() failed for '%s': %srz0Direct peer.representation() failed for '%s': %sz*Direct peer card fetch failed for '%s': %srrr.) rrrrNrrrrrT) r#rrrPrrrcontext_kwargsrrs r%rz(HonchoSessionManager._fetch_peer_contextms0''00 R-/N!+1x('1=~.4BV,$,00000 C-t443 5t<<  ''[$(G(GHHDD R R R LLDgq Q Q Q Q Q Q Q Q R ] ]:@:LD''v'666RVReReRgRg" ] ] ] OQXZ[\\\\\\\\ ] W W,,WV,DD W W W I7TUVVVVVVVV W#1$???sHA;B C!CC .C<< D,D''D,2E E:E55E:c|j|}|siS|j|j}|s6|||}||j}|||S |||}|d||dkr|jn|j}i}|j r|j j |d<|j r |j |d<|j rd |j |d <|jr|jd d}d |D|d <|S#t$r'} t d | icYd} ~ Sd} ~ wwxYw)zFetch full session context from Honcho including summary. Uses the session-level context() API which returns summary, peer_representation, peer_card, and messages. NrTr)r peer_targetpeer_perspectiverrrricTg|]%}t|dd|jpdddd&S)rr-rNir-)rrr/s r%r2z.sO---%Q 9==19?XZ\`]`\`Jabb---r'recent_messagesz Session context fetch failed: %s)rWrr\rrrrrrrrrVrWrrrrr) r#rrrrrrrr4rs r%get_session_contextz(HonchoSessionManager.get_session_contexts +//+.. I-11'2KLL E++GT::G!.++GG+DD D ++GT::G ((#9=!5!5WMf)C &(F{ 8$'K$7y!& C+.+B'(} :!%3=!9!9v| cdd+--#---() M    LL;Q ? ? ?IIIIII s7B3D++ E5EEEc|pd}|s|jS||}||dkr|jS||dkr|jS|S)zResolve a peer alias or explicit peer ID to a concrete Honcho peer ID. Always returns a non-empty string: either a known peer ID or a sanitized version of the caller-supplied alias/ID. rr9)r@rrr)r#rr candidate normalizeds r%rz%HonchoSessionManager._resolve_peer_ids ^V**,,  (' '&&y11 **622 2 2' ' **400 0 0, ,r'tuple[str, str | None]c|||}||jkr|j|jfS|jr |j|fS|dfS)zHResolve observer and target peer IDs for context/search/profile queries.N)rrrr)r#rrrs r%_resolve_observer_targetz-HonchoSessionManager._resolve_observer_targets\ ..w== W6 6 6,g.GG G  " =,n< <t##r'c|j|}|sgS |||\}}|||S#t$r'}t d|gcYd}~Sd}~wwxYw)u Fetch a peer card — a curated list of key facts. Fast, no LLM reasoning. Returns raw structured facts Honcho has inferred about the target peer (name, role, preferences, patterns). Empty list if unavailable. rz)Failed to fetch peer card from Honcho: %sN)rWrrerTrrr)r#rrrobserver_peer_idrrs r% get_peer_cardz"HonchoSessionManager.get_peer_cards+//+.. I /3/L/LWVZ/[/[ , n(()9.(QQ Q    LLDa H H HIIIIII s/A BA<6B<B  max_tokensr*c|j|}|sdS |||\}}||||}g} |dr| |d|dpg} | r2| dd| Dd| S#t $r&} td| Yd } ~ dSd } ~ wwxYw) ue Semantic search over Honcho session context. Returns raw excerpts ranked by relevance to the query. No LLM reasoning — cheaper and faster than dialectic_query. Good for factual lookups where the model will do its own synthesis. Args: session_key: Session to search against. query: Search query for semantic matching. max_tokens: Token budget for returned content. peer: Peer alias or explicit peer ID to search about. Returns: Relevant context excerpts as a string, or empty string if none. rrrrrc3 K|] }d|V dS)z- Nr.)r0fs r% z6HonchoSessionManager.search_context..)s(&>&>AxAxx&>&>&>&>&>&>r'z z Honcho search_context failed: %sN) rWrrerr"rrrr) r#rrrjrrrgrPrrrrs r%search_contextz#HonchoSessionManager.search_contexts+.+//+.. 2 '+'D'DWd'S'S $ f** "+C E#$ 4 S!12333v;$"D @ TYY&>&>&>&>&>>>???;;u%% %    LL;Q ? ? ?22222 sB(C C9C44C9rch|r|sdS|j|}|std|dS |||}|td||dS||jkr5||j}||j}na|j r0||j}||}n*||}||}| ||j dgt d|||dddS#t$r&} td | Yd} ~ dSd} ~ wwxYw) u$Write a conclusion about a target peer back to Honcho. Conclusions are facts a peer observes about another peer or itself — preferences, corrections, clarifications, and project context. They feed into the target peer's card and representation. Args: session_key: Session to associate the conclusion with. content: The conclusion text. peer: Peer alias or explicit peer ID. "user" is the default alias. Returns: True on success, False on failure. Fz/No session cached for '%s', skipping conclusionNz7Could not resolve conclusion peer '%s' for session '%s')rrz&Created conclusion about %s for %s: %sPTzFailed to create conclusion: %s)r@rWrrrrrrconclusions_ofrrcreaterrrr) r#rrrrrrconclusions_scoperrs r%create_conclusionz&HonchoSessionManager.create_conclusion/s gmmoo 5+//+..  NNLk Z Z Z5 !227DAAN%XZ^`klllu!:::!%!9!9':S!T!T$2$A$A'B[$\$\!!( O!%!9!9':S!T!T$2$A$A.$Q$Q!!"66~FF $/$>$>~$N$N!  $ $"==??%7''&    KK@.R]_fgjhjgj_k l l l4    LL:A > > >55555 s4F C6F F1 F,,F1 conclusion_idc||j|}|sdS |||}||jkr5||j}||j}na|jr0||j}||}n*||}||}||t d||dS#t$r'} t d|| Yd} ~ dSd} ~ wwxYw)a1Delete a conclusion by ID. Use only for PII removal. Args: session_key: Session key for peer resolution. conclusion_id: The conclusion ID to delete. peer: Peer alias or explicit peer ID. Returns: True on success, False on failure. FzDeleted conclusion %s for %sTz"Failed to delete conclusion %s: %sN) rWrrrrrrrrrrrrr) r#rrvrrrobserverscoperrs r%delete_conclusionz&HonchoSessionManager.delete_conclusion`sH+//+.. 5 !227DAAN!:::33G4MNN //0IJJ( C33G4MNN //??"66~FF #22>BB LL ' ' ' KK6 { S S S4    LL=}a P P P55555 sC(D D;D66D;list[str] | Nonec|j|}|sdS |||}|td||dS||}||}td|t||S#t$r&}t d|Yd}~dSd}~wwxYw)aUpdate a peer's card. Args: session_key: Session key for peer resolution. card: New peer card as list of fact strings. peer: Peer alias or explicit peer ID. Returns: Updated card on success, None on failure. Nz=Could not resolve peer '%s' for set_peer_card in session '%s'z#Updated peer card for %s (%d facts)zFailed to set peer card: %s) rWrrrrrset_cardrr3rr) r#rrrrrpeer_objrrs r% set_peer_cardz"HonchoSessionManager.set_peer_cards+//+.. 4 ++GT::G^`dfqrrrt//88H&&t,,F KK=wD R R RM    LL6 : : :44444 s4B+AB++ C5CCmanualr!c|r|sdS|j|}|std|dS||j}|j|j}|std|dS d|d|d}| | |gt d||dS#t$r&}t d |Yd }~dSd }~wwxYw) a6 Seed the AI peer's Honcho representation from text content. Useful for priming AI identity from SOUL.md, exported chats, or any structured description. The content is sent as an assistant peer message so Honcho's reasoning model can incorporate it. Args: session_key: The session key to associate with. content: The identity/persona content to seed. source: Metadata tag for the source (e.g. "soul_md", "export"). Returns: True on success, False on failure. Fz,No session cached for '%s', skipping AI seedz3No Honcho session cached for '%s', skipping AI seedz z z z$Seeded AI identity from '%s' into %sTzFailed to seed AI identity: %sN)r@rWrrrrrr\rrrrrr) r#rrr!rrrrIrs r%seed_ai_identityz%HonchoSessionManager.seed_ai_identitysc  gmmoo 5+//+..  NNI; W W W511'2KLL-11'2KLL  NNPR] ^ ^ ^5 '!''==??'''   ' ')?)?)H)H(I J J J KK> T T T4    LL91 = = =55555 s+A D D=D88D=cB|j|}|sdddS ||j|j}|dpdd|ddS#t $r*}t d|dddcYd}~Sd}~wwxYw) z Fetch the AI peer's current Honcho representation. Returns: Dict with 'representation' and 'card' keys, empty strings if unavailable. rrXrrrrz%Failed to fetch AI representation: %sN)rWrrrrrrr)r#rrrrs r%get_ai_representationz*HonchoSessionManager.get_ai_representations+//+.. 6&("55 5 6**7+DWMf*ggC"%&6"7"=2 #f+..  6 6 6 LL@! D D D&("55 5 5 5 5 5 5 6sAA** B4BBBcHd|jDS)zList all cached sessions.cg|]N}|j|j|jt |jdOS))rrr message_count)rrr!rr3r)r0ss r%r2z6HonchoSessionManager.list_sessions..sc    ul4466l4466!$QZ      r')rWrr7s r% list_sessionsz"HonchoSessionManager.list_sessionss3  [''))    r')NNNN)rCrDrErFrGrHrIrJ)rr )rr rr)rr rrrrrr)rr rr )rr rr )rr rrr9)rr rr)rr rr)rr )Nr) rr rr rrJrr rr r)rr rrJrr)rr rrrr)rr rr)rr rrJrr)rr rrrr)rr rrrr))rr r6r rr)rrrrK)rr rPrJrrK)rr rrJrPrJrr)r)rr rr rr)rr rrJrr )rr rrJrrc)rr rr rrK)rir) rr rr rjr*rr rr )rr rr rr rr)rr rvr rr rr)rr rrKrr rr{)r)rr rr r!r rr)rr)+r:r;r<r=r~propertyrCrrrrrr|rrrrr_REASONING_LEVELSrrr r rr r( staticmethodr$rJrNrTrr_rrerhrorurzrrrrr.r'r%rBrBDs!%%)!-1 G'G'G'G'G'RX  \*\*\*\*|6666MMMM^%%%%N%A%A%A%AN----000000@D//// '+?????B     6666<<<<55555n''''R000\0rsB??"""""" ((((((((%%%%%%%%::::::  8 $ $&(( ()()()()()()() ()Vc c c c c c c c c c r'