i dUdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z ddl mZmZerddlmZejeZe jd z d z Zd ZddZd?dZd@dZdAdZdZ dBd Z!dCd$Z"d%d&hZ#d%d&d&d'Z$d>d(Z%d)d)d)d)d*d)d+d+d)d*d,Z&dDd1Z'eGd2d3Z(da)d4e*d5<dEdFd9Z+dGd;Z,dS)HaHoncho client initialization and configuration. Resolution order for config file: 1. $HERMES_HOME/honcho.json (instance-local, enables isolated Hermes instances) 2. ~/.honcho/config.json (global, shared across all Honcho-enabled apps) 3. Environment variables (HONCHO_API_KEY, HONCHO_ENVIRONMENT) Resolution order for host-specific settings: 1. Explicit host block fields (always win) 2. Flat/global fields from config root 3. Defaults (host name as workspace/peer) ) annotationsN) dataclassfield)Path)get_hermes_home)Any TYPE_CHECKINGHonchoz.honchoz config.jsonhermesreturnstrctjdd}|r|S ddlm}|}|r|dvr t d|Sn#t$rYnwxYwt S)a Derive the Honcho host key from the active Hermes profile. Resolution order: 1. HERMES_HONCHO_HOST env var (explicit override) 2. Active profile name via profiles system -> ``hermes.`` 3. Fallback: ``"hermes"`` (default profile) HERMES_HONCHO_HOSTr)get_active_profile_name)defaultcustom.)osenvirongetstriphermes_cli.profilesrHOST Exception)explicitrprofiles D/home/agentuser/.hermes/hermes-agent/plugins/memory/honcho/client.pyresolve_active_hostr "sz~~2B77==??H ??????))++  'w&;;;&&W&& &      Ks!A A('A(rctdz }|r|Stjdz dz }||kr|r|StS)uoReturn the active Honcho config path. Resolution order: 1. $HERMES_HOME/honcho.json (profile-local, if it exists) 2. ~/.hermes/honcho.json (default profile — shared host blocks live here) 3. ~/.honcho/config.json (global, cross-app interop) Returns the global path if none exist (for first-time setup writes). z honcho.jsonz.hermes)rexistsrhomeGLOBAL_CONFIG_PATH) local_path default_paths rresolve_config_pathr'8sm!""]2J9;;*]:Lz!!l&9&9&;&;! autohybrid>toolsr*contextvalcRt||}|tvr|ndS)u?Normalize legacy recall mode values (e.g. 'auto' → 'hybrid').r*)_RECALL_MODE_ALIASESr_VALID_RECALL_MODESr-s r_normalize_recall_moder2Rs,  " "3 , ,C,,,33(:r(rboolcJ|t|S|t|S|S)z@Resolve a bool config field: host wins, then root, then default.)r3)host_valroot_valrs r _resolve_boolr7Xs+H~~H~~ Nr( int | Nonecj||fD]-}|) t|cS#ttf$rY)wxYw.dS)z@Parse contextTokens: host wins, then root, then None (uncapped).N)int ValueError TypeErrorr5r6r-s r_parse_context_tokensr>as`(# ? 3xx *      4s //r:c ||fD]I}|E tdtt|dcS#ttf$rYEwxYwJdS)zCParse dialecticDepth: host wins, then root, then 1. Clamped to 1-3.N)maxminr:r;r<r=s r_parse_dialectic_depthrDlsw(# ? 1c#c((A..///// *      1s*7A  A )minimallowmediumhighrBdepthlist[str] | Nonec||fD]l}|ht|trSd|d|D}t||kr(|dt||k(|cSmdS)zParse dialecticDepthLevels: optional array of reasoning levels per pass. Returns None when not configured (use proportional defaults). When configured, validates each level and truncates/pads to match depth. Nc(g|]}|tvr|ndS)rF)_VALID_REASONING_LEVELS).0lvls r z1_parse_dialectic_depth_levels..s75555r(rF) isinstancelistlenappend)r5r6rIr-levelss r_parse_dialectic_depth_levelsrVzs (#   ?z#t44?vv;F f++%% e$$$f++%%MMM 4r(valuesr float | Nonec|D]c}|t|tr|}|s1 t|}n#tt f$rYUwxYw|dkr|cSddS)z=Return the first non-empty value coerced to a positive float.Nr)rQrrfloatr<r;)rWvalueparseds r_resolve_optional_floatr]s   =  eS ! ! KKMME  5\\FF:&    H  A::MMM  4sAAAunified directional)sharedseparatecrosscRt||}|tvr|ndS)z"Normalize observation mode values.r_)_OBSERVATION_MODE_ALIASESr_VALID_OBSERVATION_MODESr1s r_normalize_observation_moderfs, # ' 'S 1 1C11133}Dr(Tuser_observe_meuser_observe_others ai_observe_meai_observe_othersF)r_r^modeobservation_obj dict | Nonedictct|td}|rt|tst|S|dpi}|dpi}|d|d|d|d|d|d|d|d d S) ajResolve per-peer observation booleans. Config forms: String shorthand: ``"observationMode": "directional"`` Granular object: ``"observation": {"user": {"observeMe": true, "observeOthers": true}, "ai": {"observeMe": true, "observeOthers": false}}`` Granular fields override preset defaults. r_userai observeMerh observeOthersrirjrkrg)_OBSERVATION_PRESETSrrQro)rlrmpreset user_blockai_blocks r_resolve_observationrys" % %d,@,O P PF *_d"C"CF|| $$V,,2J""4((.BH&>>+v>O7PQQ)~~ovF[?\]]!k6/3JKK%\\/6BU;VWW   r(cTeZdZUdZeZded<dZded<dZded<d Z ded <dZ ded <dZ d ed <dZ ded<dZ ded<dZded<dZded<dZded<dZded<dZded<dZded<dZded<d Zded!<dZd"ed#<d$Zded%<d&Zded'<d(Zded)<dZded*<d+Zded,<dZded-<dZded.<dZded/<dZded0<d1Z ded2<dZ!ded3<e"e#4Z$d5ed6<e"e#4Z%d7ed8<dZ&ded9<e' dEdFd;Z(e' dGdHd>Z)e*dId@Z+ dJdKdDZ,dS)LHonchoClientConfigz>Configuration for Honcho client, resolved for a specific host.rhostr workspace_idN str | Noneapi_key production environmentbase_urlrXtimeout peer_nameai_peerFr3enabledT save_messagesasyncz str | intwrite_frequencyr8context_tokensrFdialectic_reasoning_leveldialectic_dynamicXr:dialectic_max_charsr@dialectic_depthrJdialectic_depth_levelsamessage_max_chars'dialectic_max_input_charsr* recall_modeinit_on_session_startr_observation_moderhrirjrk per-directorysession_strategysession_peer_prefix)default_factoryzdict[str, str]sessionszdict[str, Any]rawexplicitly_configuredr c |p t}tjd}tjddpd}t tjd}||||tjdd|||t |p|S) z4Create config from environment variables (fallback).HONCHO_API_KEYHONCHO_BASE_URLrNHONCHO_TIMEOUTHONCHO_ENVIRONMENTr)r|r}rrrrrr)r rrrrr]r3)clsr}r| resolved_hostrrrs rfrom_envzHonchoClientConfig.from_envs5 3 5 5 *..!122:>>"3R88>>@@HD)"*..9I*J*JKKs% ';\JJ!,H--    r( config_path Path | Nonec|p t}|p t}|s1td|||S t j|d}nU#t j tf$r<}t d||||cYd}~Sd}~wwxYw| dpi |i}t|p| dd u}| d p| d p|} | d p| d p|} | d p3| d ptj d } | dp| dd} | dpH| dp3tj ddpd} t#| d| dtj d}| d}| d}||}n||}nt| p| }| dp| dpd} t%|}n&#t&t(f$rt+|}YnwxYw| d}||n| dd }| dp| dd}| d}||n| dd}|dHid|d| d | d| d| d|d!| d"p| d"d#| d|d$|d%|d&t-| d'| d'd(| d)p| d)pd*d+t/| d,| d,d -d.t%| d/p| d/pd0d1t1| d2| d2d3t3| d4| d4t1| d2| d25d6t%| d7p| d7pd8d9t%| d:p| d:pd;dd?t/| d@| d@d-dAt7| dBp| dBp|rdCndDt9t7| dBp| dBp|rdCndD| dEp| dE||| dFi||dGS)IzCreate config from the resolved Honcho config path. Resolution: $HERMES_HOME/honcho.json -> ~/.honcho/config.json -> env vars. When host is None, derives it from the active Hermes profile. z2No global Honcho config at %s, falling back to env)r|zutf-8)encodingz*Failed to read %s: %s, falling back to envNhostsrT workspaceaiPeerapiKeyrrrbaseUrlrrrrrequestTimeoutrwriteFrequencyr saveMessagessessionStrategyrsessionPeerPrefixFr|r}rrpeerNamerrrr contextTokensrdialecticReasoningLevelrFrdialecticDynamic)rrdialecticMaxCharsrrdialecticDepthrdialecticDepthLevels)rIrmessageMaxCharsrrdialecticMaxInputCharsrr recallModer*rinitOnSessionStartrobservationModer^r_ observationr)rrrrr)r r'r"loggerdebugrjsonloads read_textJSONDecodeErrorOSErrorwarningrr3rrrr]r:r<r;rr>r7rDrVr2rfry)rr|rrpathre host_block_explicitly_configuredrrrrrr host_enabled root_enabledrraw_wfr host_saverr host_prefixrs rfrom_global_configz%HonchoClientConfig.from_global_config5sx5 3 5 5 3133{{}} 4 LLMt T T T<<]<33 3 4*T^^W^==>>CC$g. 4 4 4 NNGq Q Q Q<<]<33 3 3 3 3 3 3 4ggg&&,"11-DD "&j!1!1!OSWWY5G5G45O NN; ' ' ww{##   NN8 $ $ wwx     NN8 $ $ 0wwx   0z~~.//  NN= ) ) 4ww}l33  GGI   wwz"" z~~/44::<<   * GGI   GG$ % % JNN+ , ,  "~~i00 wwy))  #"GG  %"GG7.h//G NN+ , , ww'((    *),VOO:& * * *!&kkOOO *NN>22 %.%: X\@]@]  NN, - - ;ww(/:: !nn%899 &2KK,e44  sS S S S "S GS $ S X S G S !nnZ00GCGGJ4G4GS GS GS (-S ,OS 1//((S "89977455'S *,122*+++S 4!$23377.//!!!5S >3/00())?S F$A566.//,Z^^>777#$C"D!##DK--//0055$23    D tsAAA-,A- session_title session_idgateway_session_keycddl}|stj}|j|}|r|S|rH|dd|d}|r|jr|jr |jd|S|S|r.|dd|d}|r|S|j dkr|r|jr|jr |jd|S|S|j dkrE| |pt|j }|jr|jr |jd|S|S|j dvr0t|j }|jr|jr |jd|S|S|j S)uResolve Honcho session name. Resolution order: 1. Manual directory override from sessions map 2. Hermes session title (from /title command) 3. Gateway session key (stable per-chat identifier from gateway platforms) 4. per-session strategy — Hermes session_id ({timestamp}_{hex}) 5. per-repo strategy — git repo root directory name 6. per-directory strategy — directory basename 7. global strategy — workspace name rNz[^a-zA-Z0-9_-]+- per-sessionzper-repo)rr)rergetcwdrrsubrrrrrrrr}) selfrrrrrmanual sanitizedbases rresolve_session_namez'HonchoClientConfig.resolve_session_names$   )++C""3''  M  !13 FFLLSQQI !+;;"n::y:::    !138KLLRRSVWWI !    M 1 1j 1' 8DN 8.77:777   J . .&&s++=tCyy~D' 2DN 2.114111K  $D D D99>D' 2DN 2.114111K  r()r N)r}rr|r~r r{)NN)r|r~rrr r{)rrr r~)NNNN) rr~rr~rr~rr~r r~)-__name__ __module__ __qualname____doc__rr|__annotations__r}rrrrrrrrrrrrrrrrrrrrrhrirjrkrrrrorrr classmethodrr staticmethodrrrr(rr{r{sHHD L    G#K####H G     I    GGM")O((((!%N%%%%&+****#"""""""""O043333#""""%*****  K#(''''*))))!O    $$$$$M"""""+++++ %%%%%$uT:::H::::%555C5555#(''''%    [ * #'v v v v [v p   \ "$(!%*. C!C!C!C!C!C!C!r(r{z Honcho | None_honcho_clientconfigHonchoClientConfig | Noner cHttS|t}|js|jst d ddlm}n#t$rtdwxYw|j}|j }|r| ddl m }|}| di}t|trd|s*| dd pd}|6t!| d | d }n#t"$rYnwxYw|r"t$d ||jn&t$d |j|j|o d|vpd|vpd|v}|rg|jpi}| dpi |ji} t/| d} | r|jnd} n|j} |j| |jd} |r|| d<||| d <|di| atS)zGet or create the Honcho client singleton. When no config is provided, attempts to load ~/.honcho/config.json first, falling back to environment variables. NzHoncho API key not found. Get your API key at https://app.honcho.dev, then run 'hermes honcho setup' or set HONCHO_API_KEY. For local instances, set HONCHO_BASE_URL instead.rr zThoncho-ai is required for Honcho integration. Install it with: pip install honcho-ai) load_confighonchorrrrequest_timeoutz8Initializing Honcho client (base_url: %s, workspace: %s)z4Initializing Honcho client (host: %s, workspace: %s) localhostz 127.0.0.1z::1rrlocal)r}rrr)rr{rrrr;rr ImportErrorrhermes_cli.configrrrQrorr]rrinfor}r|rr3r) rr resolved_base_urlresolved_timeoutr hermes_cfg honcho_cfg _is_local_raw _host_block _host_has_keyeffective_api_keykwargss rget_honcho_clientrGs! ~#6688 > &/  @    !!!!!!!     5    ~  0 8  5 5 5 5 5 5$J#"55J*d++ (W(2z2(F(F(L(L(N(N(VRV%#+'>"y11"'899(($    D n NPacicvwwww JFKY_Ylmmm"(( & + + & % % +zRxx((.B33FKDD [__X6677 .;HFNN"N+$)F /.z#,yV%%f%%N sAA)?BD D,+D,Nonec dadS)z7Reset the Honcho client singleton (useful for testing).N)rrr(rreset_honcho_clientrs NNNr()r r)r r)r-rr r)rr3r r3)r r8)r r:)rIr:r rJ)rWrr rX)rlrrmrnr ro)N)rrr r )r r)-r __future__rrrlogging dataclassesrrpathlibrhermes_constantsrtypingrr rr getLoggerrrr#r$rr r'r/r0r2r7r>rDrMrVr]rerdrfruryr{rrrrrr(rrs   #""""" ((((((((,,,,,,%%%%%%%%  8 $ $TY[[9,}<,,)444;;;;     F&$&}5'0mVcddEEEE D  T  > j!j!j!j!j!j!j! j!Z !%$$$$WWWWWtr(