iLtUdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z ddlmZd:d Zd;ddZdaded<d?dZd@dZd@dZdAdZd;dBd ZdCd!ZdDdEd&ZdFd'Zd=d(Z d?d)Z!dGd+Z"d=d,Z#d=d-Z$d=d.Z%d=d/Z&d=d0Z'd=d1Z(d=d2Z)d=d3Z*d=d4Z+d=d5Z,d=d6Z-d=d7Z.d=d8Z/d=d9Z0dS)HzoCLI commands for Honcho integration management. Handles: hermes honcho setup | status | sessions | map | peer ) annotationsNPathget_hermes_home)resolve_active_hostresolve_config_pathHOST)cfg_get profile_namestrreturnboolct}|sdS|di}|ti}t|dptjd}|s|sdStd|}||vrdSi}dD]}||}||||<|dp|d} | r| |d<||d <|d p|d pt|d <|d d |d <||di|<t|t|d S) a[Auto-clone Honcho config for a new profile from the default host block. Called during profile creation. If Honcho is configured on the default host, creates a new host block for the profile with inherited settings and auto-derived workspace/aiPeer. Returns True if a host block was created, False if Honcho isn't configured. FhostsapiKeyHONCHO_API_KEY.) recallModewriteFrequencysessionStrategysessionPeerPrefix contextTokensdialecticReasoningLeveldialecticDynamicdialecticMaxCharsmessageMaxCharsdialecticMaxInputChars saveMessages observationNpeerNameaiPeer workspaceenabledT) _read_configgetr rosenviron setdefault _write_config_ensure_peer_exists) r cfgr default_blockhas_keynew_host new_blockkeyval peer_names >/home/ubuntu/.hermes/hermes-agent/plugins/memory/honcho/cli.pyclone_honcho_for_profiler5s ..C u GGGR EIIdB''M3778$$H 7G(H(HIIG u''''H5uII!!$$ ? IcN!!*--D1D1DI* ) * 'Ih*..{;;[sww{?S?S[W[Ik(,,Y==Ii,5CNN7B)#!!! 4host_key str | Nonec  ddlm}m}||}|jr|js |jsdS||}||j|j r||j dS#t$rYdSwxYw)zCreate the AI peer in Honcho if it doesn't already exist. Idempotent -- safe to call multiple times. Returns True if the peer was created or already exists, False on failure. rHonchoClientConfigget_honcho_clienthostFT) plugins.memory.honcho.clientr;r<from_global_configr$api_keybase_urlpeerai_peerr3 Exception)r7r;r<hcfgclients r4r+r+Js VVVVVVVV!44(4CC| DL DM 5""4(( DL!!! > ( KK ' ' 't uus3A?AA?? B  B Nonec 4t}t}|dkrd|dnd}|di|i}|ddurt d|d d Sd|d<|d st |dt i }d D]"}||}| ||vr|||<#|dp|d}|r d|vr||d<d|vr|dddn|} |d | |d|dp|dpt t|t d|dt|r+t d|d|d |dnt d|dt dtdd S)z%Enable Honcho for the active profile.hermes[] rr$T zHoncho is already enabled. Nr"default) rrrrrrrrrrr r!rr#zHoncho enabled.zPeer 'z' ready.z'Peer creation deferred (no connection). Saved to  ) r% _host_keyr)r&printr r splitr*r+ _config_path) argsr,r>labelblockr-r1r2r3rDs r4 cmd_enabler[_sa ..C ;;D H,,LLLLL"E NN7B ' ' 2 24 < rYrZs r4 cmd_disabler]s ..C ;;D H,,LLLLL"E C$ 3 3 3E EIIi((E11 75777888E)# &u & & &''' *  * * *+++++r6c ddlm}|}n+#t$r}td|dYd}~dSd}~wwxYwt }|stddS|di}|t i}t|dptj d }|s|std dSd}d} |D]L} | j d krt| j r%td | j d | j |dz }G| dz } M|rtd|dntd| rtd| dtdS)zSync Honcho config to all existing profiles. Scans all Hermes profiles and creates host blocks for any that don't have one yet. Inherits settings from the default host block. r list_profilesz Could not list profiles: rSNz; No Honcho config found. Run 'hermes honcho setup' first. rrrzM Honcho not configured on default profile. Run 'hermes honcho setup' first. rPz + z -> hermes.rQz z profile(s) synced.z* All profiles already have Honcho config.rNz) profile(s) already configured (skipped).) hermes_cli.profilesr`rErUr%r&r rr'r(namer5) rXr`profileser,rr-r.createdskippedps r4cmd_syncrhs 555555 =??  1A111222 ..C  LMMM GGGR EIIdB''M3778$$H 7G(H(HIIG  ^___GG  6Y    #AF + +  444AF44 5 5 5 qLGG qLGG< 1W1112222 :;;;G E7EEEFFF GGGGGs ;6;intc ddlm}|}n#t$rYdSwxYwt}|sdSt |dt i}t |dptj d}|s|sdSd}|D]'}|j dkrt|j r|dz }(|S) zSync Honcho host blocks for all profiles. Returns count of newly created blocks. Called from `hermes update` -- no output, no exceptions. rr_rrOrrrPrQ) rar`rEr%r r rr&r'r(rbr5)r`rcr,r-r.rergs r4sync_honcho_profiles_quietrks 555555 =?? qq ..C qC$;;;M3778$$H 7G(H(HIIG qG  6Y    #AF + +  qLG Ns  !!_profile_overridecntr!tdvrtStdtStS)zKReturn the active Honcho host key, derived from the current Hermes profile.)rPcustomr)rlr rr6r4rTrTs<-  5 5 5K,,*,,,   r6rctS)zLReturn the active Honcho config path for reading (instance-local or global).)r ror6r4rWrWs   r6c$tdz S)aReturn the instance-local Honcho config path for writing. Always returns $HERMES_HOME/honcho.json so each profile/instance gets its own config file. The global ~/.honcho/config.json is only used as a read fallback (via resolve_config_path) for cross-app interop. z honcho.jsonrror6r4_local_config_pathrrs   } ,,r6dictct}|r9 tj|dS#t $rYnwxYwiS)Nutf-8encoding)rWexistsjsonloads read_textrE)paths r4r%r%sc >>D {{}} :dnngn>>?? ?    D  Is'A AAr,r| Path | Nonec|p t}|jdd|t j|dddzddS) NT)parentsexist_okF)indent ensure_asciirSrurv)rrparentmkdir write_textrydumps)r,r|s r4r*r* so  '%''DKdT222OO 3qu555<r6c|dpitpid}|p5|ddptjdd}|s|dp4|dptjddpdrdd lm} |}n#ttf$rd }YnwxYw|r|j d vr |j rd S }|d vr1tfddDr sd S|S)u5Resolve API key with host -> root -> env fallback. For self-hosted instances configured with ``baseUrl`` instead of an API key, returns ``"local"`` so that credential guards throughout the CLI don't reject a valid configuration. The ``baseUrl`` is scheme-validated (http/https only) so that a typo like ``baseUrl: true`` can't silently pass the guard. Schemeless strings that look like host:port (legacy config shapes, e.g. ``localhost:8000``) still pass — the Honcho SDK will reject them itself with a clearer error than ours. rrrMrbaseUrlrBHONCHO_BASE_URLr)urlparseN)httphttpslocal)truefalsenonenullc3 K|]}|vV dSNro).0crBs r4 z#_resolve_api_key..0s@HH"#X HHHHHHr6z.:)r&rTr'r(strip urllib.parser TypeError ValueErrorschemenetlocloweranyisdigit)r,r7r1rparsedloweredrBs @r4_resolve_api_keyrs!!'R,,Y[[99?RDDXNNH  Scggh++ Srz~~>NPR/S/SC 779%%e)<)<e O`bd@e@eN))++   - - - - - - !(++z*     &-+<<<<wnn&&G???CHHHH'+HHHEE?&&((@w Js0 C<<DDFrYrPsecretc|rd|dnd}tjd||dtj|rjtjrddl}|d}natj}n0tj}|p|pdS)N []rMrN: r)prompt) sysstdoutwriteflushstdinisattygetpassreadliner)rYrPrsuffixrr2s r4_promptr7s ' /_'____RFJ+%++++,,,J + 9     / NNN///,,CC)$$&&,,..CCi  ""((**  !7=b!r6c ddl}dS#t$rYnwxYwtdtdd}|dvrtd d Sddl}td d |tjd dddgdd}|j dkrtddStd|j tdd S)zNCheck honcho-ai is importable; offer to install if not. Returns True if ready.rNTz honcho-ai is not installed.z"Install it now? (honcho-ai>=2.0.1)yrOryesz8 Skipping install. Run: pip install 'honcho-ai>=2.0.1' Fz Installing honcho-ai...)rz-mpipinstallzhoncho-ai>=2.0.1)capture_outputtextz Installed. z Install failed: z/ Run manually: pip install 'honcho-ai>=2.0.1' ) honcho ImportErrorrUrr subprocessrunr executable returncodestderrr)ranswerrresults r4_ensure_sdk_installedrGs,  t       )*** 93 G G GF ||~~\)) IJJJu %T2222 ^^ ui1CD F A t ;FM$7$7$9$9;;<<< @AAAus  c0,t,t}t}tdtdtd|||kr'|rtd|dtt sdS,di}|ti}tdtd td t,fd d Drd nd}td|}| dv}, dd|rx, dpd}td|pd} | r| ,d<, dd} | rtdtdntdn, dd, dd} t| dkr d| ddn| rdnd} td | td!d"#} | r| ,d<, ds td$td%dS| d&p, d&d} td'| ptjd(d)}|r||d&<| d*p, d*d+}td,|}|r||d*<| d-p, d-d+}td.|}|r||d-<| d/p, d/d0}td1td2td3td4|}|d5vr||d/<nd0|d/<t!| d6p, d6d7}td8td9td:td;td<td=|} t#||d6<n"#t$t&f$r|d>vr|nd7|d6<YnwxYw| d?p, d?d@}|dAvrd@n|}tdBtdCtdDtdEtdF|}|dAvr||d?<| dGp, dG}|rt!|ndH}tdItdJtdKtdL|}| dMvr| dGdnL|dkrn3 t#|}|dNkr||dG<n#t$t&f$rYnwxYwt!| dOp, dOpdP}tdQtdRtdStdTtdU|} t#|}|dVkr||dO<n#t$t&f$rdW|dO<YnwxYw| dXp, dXpdY} tdZtd[td\td]td^td_td`tda| }!|!dbvr|!|dX<ndY|dX<| dcp, dcdd}"tdetdftdgtdhtditdj|"}#|#dkvr|#|dc<d"|dl<|dmd"t+,tdn| dNdolm}$m}%|$}&dp|&dqidr<|%|&tdsn8#t2$r+}'tdt|'tduYd}'~'nd}'~'wwxYwtdvdd"w dNdxlm}(m})m}*|*|(ty}+|)|+tdzn*#t2$r}'td{|'Yd}'~'dSd}'~'wwxYwtd|td}|+td~|+j td|+j!td|+j"td|+j#td|+j$td|+j%td|+j&tdtdtdtdtdtdtdtdtdtdtdtddS)z Interactive Honcho setup wizard.u Honcho memory setup ────────────────────────────────────────z6 Honcho gives Hermes persistent cross-session memory.z Config: z# (seeding from existing config at )Nrz Deployment:z* cloud -- Honcho cloud (api.honcho.dev)z& local -- self-hosted Honcho serverc3tK|]2}|dpdpdvV3dS)rrBrMN)r&)rhr,s r4rzcmd_setup..|s^$$  cggi  =CGGJ$7$7=2>$$$$$$r6) localhostz 127.0.0.1z::1rcloudzCloud or local?rO)rlrBrrMzBase URLzhttp://localhost:8000rz9 API key present in config (kept for cloud/hybrid use).z1 Local connections will skip auth automatically.z' No API key set. Local no-auth ready....setnot setz Current API key: z,Honcho API key (leave blank to keep current)T)rz= No API key configured. Get yours at https://app.honcho.devz7 Run 'hermes honcho setup' again once you have a key. r!zYour name (user peer)USERuserr"rJz AI peer namer#z Workspace IDobservationMode directionalz Observation mode:zS directional -- all observations on, each AI peer builds its own view (default)zL unified -- shared pool, user observes self, AI observes others onlyzObservation mode)unifiedrrasyncz Write frequency:z= async -- background thread, no token cost (recommended)z* turn -- sync write after every turnz. session -- batch write at session end onlyz+ N -- write every N turns (e.g. 5)zWrite frequency)rturnsessionrhybridrcontexttoolsz Recall mode:zG hybrid -- auto-injected context + Honcho tools available (default)z> context -- auto-injected context only, Honcho tools hiddenz: tools -- Honcho tools only, no auto-injected contextz Recall moderuncappedzA Context injection per turn (hybrid/context recall modes only):z" uncapped -- no limit (default)z0 N -- token limit per turn (e.g. 1200)zContext tokens)rrzno limitrdialecticCadence2z Dialectic cadence:zJ How often Honcho rebuilds its user model (LLM call on Honcho backend).z7 1 = every turn, 2 = every other turn, 3+ = sparser.z Recommended: 1-5.zDialectic cadencerQrrlowz Dialectic reasoning level:zL Depth Honcho uses when synthesizing user context on auto-injected calls.z% minimal -- quick factual lookupsz3 low -- straightforward questions (default)z& medium -- multi-aspect synthesisz+ high -- complex behavioral patternsz- max -- thorough audit-level analysiszReasoning levelminimalrmediumhighmaxr per-sessionz Session strategy:zP per-session -- each run starts clean, Honcho injects context automaticallyzQ per-directory -- reuses session per dir, prior context auto-injected each runz3 per-repo -- one session per git repositoryz: global -- single session across all directorieszSession strategy)rper-repo per-directoryglobalr$rz Config written to ) load_config save_configrmemoryproviderz0 Memory provider set to 'honcho' in config.yamlz( Could not auto-enable in config.yaml: z/ Run: hermes config set memory.provider honchoz Testing connection... endrr;r<reset_honcho_clientr=OKzFAILED Error: z Honcho is ready.z Session: z Workspace: z User: AI peer: z Observe: z Frequency: z Recall: z Sessions: z" Honcho tools available in chat:zP honcho_context -- session context: summary, representation, card, messagesz4 honcho_search -- semantic search over historyz, honcho_profile -- peer card, key factszA honcho_reasoning -- ask Honcho a question, synthesized answerz5 honcho_conclude -- persist a user fact to memoryz Other commands:z0 hermes honcho status -- show full configz> hermes honcho mode -- change recall/observation modezB hermes honcho tokens -- tune context and dialectic budgetsz1 hermes honcho peer -- update peer nameszE hermes honcho map -- map this directory to a session name )'r%rrrWrUrxrr)rTrrrpopr&lenr'getenvr rirrrr*hermes_cli.configrrrEr?r;r<rr@resolve_session_name workspace_idr3rDobservation_modewrite_frequency recall_modesession_strategy)-rX write_path read_pathr hermes_hostcurrent_deploydeployis_local current_urlnew_url current_keymaskednew_key current_peernew_peer current_ainew_aicurrent_workspace new_workspace current_obsnew_obs current_wfnew_wf _raw_recallcurrent_recall new_recallcurrent_ctx_tokenscurrent_displaynew_ctx_tokensr2current_dialectic new_dialecticcurrent_reasoning new_reasoning current_strat new_stratrr hermes_configrdr;r<rrFr,s- @r4 cmd_setupr!es ..C#%%JI 0111 BCCC #z # #$$$J9#3#3#5#5 @I@@@AAA GGG " " NN7B ' 'E""9;;33K / 6777 2333 #$$$$2$$$!!WW & ? ? ?F||~~/HGGJggi((.B *k.T=TUUU  %$C N ggh++  > O P P P E F F F F < = = = =  4   ggh++ -0-=-=-A-A){233')))Q\Hkbk .f..///HQUVVV  $#CMwwx    R S S S L M M M F??:..I#''*b2I2IL. 8a RXZ`HaHabbbH+"* J**Icggh.I.IJ ^Z 8 8 8F ' & H# 44V X8V8VN4EFFFM1#0 K //"344a@QS`8a8aK !""" _``` XYYY(+>>>G,,,)0 %&&)6 %&[__%566\#''BRT[:\:\]]J !!! IJJJ 6777 :;;; 7888 & ; ; ;Ff(+F $%%  "fff28??e377K]C^C^ebeff "### VWWW CDDD !"""/9JKKKM,-   !88.1K* +  ",,,*+ &''', 122  77, - -    *+++ XYYY 1222 ?@@@ 2333 7888 9:::-7HIIIMCCC1> -..16 -. OO$566c#''BSUb:c:cM !""" \]]] ]^^^ ?@@@ FGGG*MBBBIJJJ)2 %&!K >4000# /: / /000A>>>>>>>># =E   2..z: M""" @AAAA AAA <<<=== ?@@@@@@@@A  $"D9999kkkkkkkkkk!44)++4FF$ d  %!%%&&& !!! 7$3355 7 7888 -$+ - -... *$. * *+++ ($, ( ())) 1$/ 1 1222 0$. 0 0111 ,$* , ,--- 1$/ 1 1222 /000 \]]] @AAA 8999 MNNN ABBB     <=== JKKK NOOO =>>> RSSSSSsh>RR0/R0X++X?>X? [$$[=<[=Ac c=!c88c=Ae$$ f .ff cbtrtS ddlm}|S#t$rYdSwxYw)zKReturn the active Hermes profile name (respects --target-profile override).rget_active_profile_namerP)rlrar$rEr#s r4_active_profile_namer%LsX!  ??????&&((( yys  ..list[tuple[str, str, dict]]c  ddlm}|}n.#t$r!tt ifgcYSwxYwt }|di}g}|ti}|dt|f|D]P}|j dkrtd|j }||j |||ifQ|S)zReturn (profile_name, host_key, host_block) for every known profile. Reads honcho.json once and maps each profile to its host block. rr_rrPr) rar`rEr%rTr%r&r appendrb)r`rcr,rresultsr-rgrs r4_all_profile_host_configsr*Ws ;555555 =?? ;;;%''b9::::; ..C GGGR EGIIdB''M NNIt]3444 66 6Y     af  599Q#3#345555 Ns (>>c t|dd}|rtdS ddl}n #t$rt dYdSwxYwt }t }t}|s#t d|t ddS ddlm }m }| t }n+#t$r} t d | d Yd} ~ dSd} ~ wwxYw|jpd } t| d kr d| ddn| rdnd} t!} | dkr d|jdnd } t d| d dz| dkrt d| t d|jt d|jt d| t d|jt)jdz dz }t d|||krt d|d ||krt d!n'|rt d"|d#t d$|jt d%|jpdt d&|t d'|jt d(|jt d)|jpd*d+t|d,dpi}|d-pd.}t d/|d0|d.krd1nd |d2p|j}|jrd3nd4}t d5|j d6|d7|t d8|j!d9|j"d:|j#d9|j$d; t d<|j%|jrx|js|j&rjt d=d d>? ||}tO||t d@dS#t$r} t dA| dBYd} ~ dSd} ~ wwxYw|jsdCndD}t dE|dBdS)Fz1Show current Honcho config and connection status.allFNrz7 honcho-ai is not installed. Run: hermes honcho setup z No Honcho config found at z* Run 'hermes honcho setup' to configure. r:r=z Config error: rSrMrrrrrrPrrz Honcho statusx────────────────────────────────────────z Profile: z Host: z Enabled: z API key: z Workspace: z.honchoz config.jsonz Config: z Write to: z (profile-local)u? Fallback: (none — using global ~/.honcho/config.json)z Fallback: z (exists, cross-app interop)z AI peer: z User peer: z Session key: z Session strat: z Recall mode: z Context budget: z (uncapped) tokensrawrrQz Dialectic cad: every z turnsreasoningLevelCaponoffz Reasoning: base=z, cap=z , heuristic=z Observation: user(me=z,others=z) ai(me=rz Write freq: z Connection... TrrzFAILED () disabledzno API key or base URLz Not connected ()(getattr_cmd_status_allrrrUr%rWrrr?r;r<r@rTrErArr%r>r$rrhomerxrDr3rrrcontext_tokensr&reasoning_level_capreasoning_heuristicdialectic_reasoning_leveluser_observe_meuser_observe_others ai_observe_meai_observe_othersrrB_show_peer_cards)rXshow_allrr, active_pathrr;r<rFrdrArprofile profile_label global_pathr/dialectic_cadence reasoning_cap heuristic_onrGreasons r4 cmd_statusrKsstUE**H  HIII ..C..K#%%J  :[::;;; ;<<<VVVVVVVV!44)++4FF  &&&&'''l bG%(\\A%5%5 !7233< ! ! !W<[EER[F"$$G)0I)=)=%%%%%2M -M - - - :;;;) ,7,,--- *ty * *+++ -t| - -... 'v ' '((( 2t0 2 2333)++ )M9K ,{ , ,---[   @:@@@AAAk!! PQQQQ     O M;MMMNNN -t| - -... 44L sD$B s s- s seq s sttt ]t'; ] ]TE] ] ]gkgy ] ]DHDZ ] ] ]^^^ 5t3 5 5666 | 1 1 1 "$7777 %&&t,,F T6 * * * $KKKKK % % % #Q### $ $ $ $ $ $ $ $ $ %$(<M5M /F///00000s?*AA*C C-C((C-*P P0P++P0c ddlm}|||}|}||||}|rut dt |d|ddD]}t d|t |dkr#t d t |dz d ||}|d d }|rC|dd t |d krdnd z} t dt d| |s|st dt dS#t$r} t d| dYd} ~ dSd} ~ wwxYw)zFetch and display peer cards for the active profile. Uses get_or_create to ensure the session exists with peers configured. This is idempotent -- if the session already exists on the server it's just retrieved, not duplicated. rHonchoSessionManagerrconfigz User peer card (z facts):N z - z ... and z morerepresentationrMrz AI peer representation: z: No peer data yet (accumulates after first conversation)z Peer data unavailable: rS) plugins.memory.honcho.sessionrNr get_or_create get_peer_cardrUrget_ai_representationr&rE) rFrGrNmgr session_keycardfactai_repai_textdisplayrds r4rArAs3FFFFFF""&>>>//11  +&&&  --  < <T<<< = = =SbS  ' 'otoo&&&&4yy2~~:SYY^:::;;;**;77**-r22  $dsdmG s0B0BuuKG 0 1 1 1 """ # # # QG Q O P P P  333 1A1112222222223sEE F'FFc Nt}t}t}tdt |ddztdddddd dd d dd d dd tdddddddddd |D]\}}}|d|d}|Gt |dptjd}|r|nd}|rdnd}|dp|dd} |dp|dd} ||krdnd} td|| zdd|d d|d d| d d| tddS)z0Show Honcho config overview across all profiles.z Honcho profiles (r4u───────────────────────────────────────────────────────rNProfile<14 Hostz<22Enabledz<9RecallWrite*──────────────uB──────────────────────u─────────r$NrrFrnorrrrz *rMz * active profile ) r*r%r%rUrr&rr'r() rowsr,activerbr>rZr$ has_creds enabled_strrecallrmarkers r4r7r7s $ & &D ..C ! # #F .D . . . ;<<< Ry R R Rv R R RI R R R8 R R R R RSSS Lz L LJ L L L LY L L L LMMM! X XdE))Iswwy'9'9:: ?SWWX..R"*..AQ2R2RSSI#(3iieG&0eeD <((KCGGL(,K,K *++Qsww7G/Q/QR V4&=VVVtVVV+VVV6VVVuVVWWWW #$$$$$r6c t}t}tdt|ddztdddddd dd tdd dd dd |D]x\}}}|dp|dpd}|dp|dp|}td|dd|d d|ytdS)z)Show peer identities across all profiles.z Honcho peer identities (z profiles) u──────────────────────────────────────────────────rNrarbrcz User peerz<16zAI peerrhu0────────────────u6──────────────────r! (not set)r"N)r*r%rUrr&)rXrjr,rbr>rZrais r4 cmd_peersrss0 $ & &D ..C >s4yy > > > KLLL z Or edit z directly. Nz Honcho session mappings (r4r-u ←rMrNz<30rc) r%r&rUrWr'getcwdrsorteditems)rXr,rucwdr|rbros r4 cmd_sessionsrzs ..Cwwz2&&H  3444 @AAA 7<>>777888 )++C :H : : :Z GHHHX^^--.... d3;;B ,4,,,d,F,,---- GGGGGr6c|jst|dStj}|j}|st ddSddl}|dd|d}||krt d||}t}|| di|<t|t d|d |d dS) z/Map current directory to a Honcho session name.Nz Session name cannot be empty. rz[^a-zA-Z0-9_-]-z Session name sanitized to: ruz Mapped u → rS) session_namerzr'rvrrUresubr%r)r*)rXryr}r~ sanitizedr,s r4cmd_mapr+s  T )++C$**,,L  1222 III(#|<<BB3GGIL   9i99::: ..C*6CNN:r""3'# 6c 6 6l 6 6 677777r6ct}d}t|dd}t|dd}t|dd}d}||||di}|ti}|dp|dpd } |d p"|d p t} |d p|d pd } |d p|d pd} t dt d| t dt d| t dt dt t d| dd|dt d| ddSt} | dkrd| dnd}|h||di| id<d}t d |d!||h||di| id <d}t d |d"||r||vr*t d#|d$d|dS||di| id <d}t d |d%||r0t|t d&td'dSdS)(z8Show or update peer names and dialectic reasoning level.FrNrr reasoningrrr!rqr"rrrXu Honcho peers ────────────────────────────────────────z User peer: zF Your identity in Honcho. Messages you send build this peer's card.z AI peer: zJ Hermes' identity in Honcho. Seed with 'hermes honcho identity '.zD Dialectic calls ask this peer questions to warm session context.z Dialectic reasoning:  (, rz Dialectic cap: z chars rJrKrLrMTrNz User peer -> z AI peer -> z Invalid reasoning level ' '. Options: zDialectic reasoning level -> rRrS) r%r6r&rTrUjoinrr)r*rW)rXr,changed user_nameai_namerREASONING_LEVELSrrJrrrlvl max_charsr>rYs r4cmd_peerrDs ..CGfd++IdD$''Gk400IBW_1B$$9;;++zz*%%K)<)<K  ZZ ! ! ESWWX%6%6 E)++jj233bsww?X7Y7Yb]bJJ233Zsww?R7S7SZWZ  -... &&&''' VWWW $$$%%% Z[[[ TUUU  OOO;K1L1LOOOPPP <<<<=== ;;D H,,LLLLL"EGPGXGXw##..tR88D :5::y'8'8::;;;EL]]__w##..tR88B 8588w}}88999 , , , d ddtyyQaGbGbdd e e e FV_w##..tR889RS B5BByBBCCC0c .LNN.../////00r6c dddd}t}t|dd}||dpitidp|dpd }t d |D]'\}}||krd nd }t d |dd ||(t ddS||vr+t d|dd|ddSt}|dkrd|dnd } ||di|id<t|t d | d|d||ddS)zShow or set the recall mode.z8auto-injected context + Honcho tools available (default)z/auto-injected context only, Honcho tools hiddenz+Honcho tools only, no auto-injected contextrmodeNrrru Honcho recall mode ──────────────────────────────────────── <-rMrNz<10z7 Set with: hermes honcho mode [hybrid|context|tools] z Invalid mode 'rrrSrJrKrLzRecall mode -> rr4 r%r6r&rTrUrxrr)r*) rXMODESr,mode_argcurrentmdescror>rYs r4cmd_moder|sMD>  E ..CtVT**H WWW   # ( (b 9 9 = =l K K ww|$$   3444{{}} 0 0GAt7llUUF .q....f.. / / / / JKKKu KKKtyy7G7GKKKLLL ;;D H,,LLLLL"EEMCNN7B**444\B# Fu F FX F F%/ F F FGGGGGr6c ddddd}t}t|dd}||dpitid p|d pd }t d |D]'\}}||krd nd }t d|dd||(t ddS||vr+t d|dd|ddSt}|dkrd|dnd } ||di|id <t|t d| d|d||ddS)z!Show or set the session strategy.z;each run starts clean, Honcho injects context automaticallyz rr4r) rX STRATEGIESr, strat_argrr0rror>rYs r4 cmd_strategyrsUW49 J ..Cj$//I WWW   # ( (b 9 9 = =>O P P ww())   8999!'')) 0 0GAt7llUUF .q....f.. / / / / cddd "" UYUUDIIj Tzdialectic cap -> z charsrRrS)r%r&rTr6rUr)r*rW) rXr,rrJrr ctx_tokensd_charsd_levelr>rYrs r4 cmd_tokensrs ..C GGGR E YYy{{B ' 'FdIt,,Gk400I9,ZZ00bCGGO4L4LbPb **011XSWW=P5Q5QXUX**677f377C\;];]faf /000  2z222333 STTT STTT  DwDD7DDEEE OPPP UVVV TUUU RSSS RSSS ;;D H,,LLLLL"EGLSw##..tR88I 5555G55666PYw##..tR889LM =5==I===>>>0c .LNN.../////00r6ct}t|stddSt|dd}t|dd} ddlm}m}ddlm}| t }||}||| } | } | | n+#t$r} td | d Yd} ~ dSd} ~ wwxYw|r| | } td |jpdddz| r| D]} td| ntd| | }td|jddz|drt|dnI|drt|dntdtdtdS|smtdtd|jpdtd|jttdtddSddlm}||}|std|d dS|d }|std!|d dS|j}| | ||"}|r5td#|jd$| d%td&|jd'dStd(dS))z8Seed AI peer identity or show both peer representations.z: No API key configured. Run 'hermes honcho setup' first. NfileshowFrr:rMr=rOz Honcho connection failed: rSz User peer (rr4r-rNz: No user peer card yet. Send a few messages to build one.z AI peer (rRr[z No representation built yet.z2 Run 'hermes honcho identity ' to seed one.u Honcho identity management ────────────────────────────────────────z User peer: ruK hermes honcho identity --show — show both peer representationsuW hermes honcho identity — seed AI peer from SOUL.md or any .md/.txt rz File not found: rurvz File is empty: sourcez Seeded AI peer identity from z into session ''z$ Honcho will incorporate this into z's representation over time. z3 Failed to seed identity. Check logs for details. )r%rrUr6r?r;r<rUrNr@rTrrVrErWr3rXrDr&pathlibr expanduserrxr{rrbseed_ai_identity)rXr, file_pathrr;r<rNrFrGrYrZrd user_cardr\r]rrgcontentroks r4 cmd_identityrs  ..C C  KLLLfd++I 4 ' 'D VVVVVVVVFFFFFF!44)++4FF""4((""&>>>//11  +&&&&  2Q222333 %%k22  >dn9 >>>KLLL  P! # #k4kk"""" # N O O O**;77 -DL--- :;;; ::& ' ' H &)* + + + + ZZ   H &. ! ! ! ! 2 3 3 3 F G G G   ;<<< ;dn9 ;;<<< ,dl,,---  [\\\ hiii Y""$$A 88:: (1((()))kk7k++1133G  '!'''((( VF  k76  B BB F UUU{UUUVVV aT\aaabbbbb DEEEEEsA1C C,C''C,cRddlm}|tj}|jdz }ddg}gd}g}g}|D];}||fD]4} | |z } | r| |vr|| 5<|D];}||fD]4} | |z } | r| |vr|| 5nI#t8$r}td?|Yd}~n(d}~wwxYwntd@ntdAttdBttdCtdDtdEttdFtdGtdHtdIt|rtd.d/dJ|Dt| r/tdKd}| dvr dd7lm}m}m}dd8lm}||}||}|||9}|}|||D]i}|dLM}|r=||||j N}|rdOndP}td$|j dQ|jno#t8$r}td?|Yd}~nNd}~wwxYwnEtdR|D]}tdS|ntdTtdUttdVttdWtdXtdYtdZttd[td\td]td^ttd_td`tdatdbttdctddtdetdftdgtdhttditdjtdktdlttdmt| stdntdonZtdptdqtdrtdstdttdutdS)vuIStep-by-step migration guide: OpenClaw native memory → Hermes + Honcho.rrz .openclawzUSER.mdz MEMORY.md)zSOUL.mdz IDENTITY.mdz AGENTS.mdzTOOLS.mdz BOOTSTRAP.mdu Honcho migration: OpenClaw native memory → Hermes ──────────────────────────────────────────────────zA OpenClaw's native memory stores context in local markdown fileszE (USER.md, MEMORY.md, SOUL.md, ...) and injects them via QMD search.zH Honcho replaces that with a cloud-backed, LLM-observable memory layer:zF context is retrieved semantically, injected automatically each turn,zD and enriched by a dialectic reasoning layer that builds over time.zStep 1 Create a Honcho accountrrrrNrz% Honcho API key already configured: z Skip to Step 2.zF Honcho is a cloud memory service that gives Hermes persistent memoryz1 across sessions. You need an API key to use it.z/ 1. Get your API key at https://app.honcho.devz 2. Run: hermes honcho setupz! Paste the key when prompted.z Run 'hermes honcho setup' now?rrOrrMzE Run 'hermes honcho setup' when ready, then re-run this walkthrough.z&Step 2 Detected OpenClaw memory filesz User memory (u* file(s)) — will go to Honcho user peer:rTz Agent identity (u( file(s)) — will go to Honcho AI peer:z? No OpenClaw native memory files found in cwd or ~/.openclaw/.z@ If your files are elsewhere, copy them here before continuing,z? or seed them manually: hermes honcho identity u6Step 3 Migrate user memory files → Honcho user peerzE USER.md and MEMORY.md contain facts about you that the agent shouldzH remember across sessions. Honcho will store these under your user peerzD and inject relevant excerpts into the system prompt automatically.z Found: rc3$K|] }|jV dSrrbrfs r4rzcmd_migrate..s$#?#?qAF#?#?#?#?#?#?r6zC These are picked up automatically the first time you run 'hermes'z6 with Honcho configured and no prior session history.z> (Hermes calls migrate_memory_files() on first session init.)z= If you want to migrate them now without starting a session:uA hermes honcho migrate — this step handles it interactivelyz) Upload user memory files to Honcho now?rrMrOc3>K|]}t|jVdSr)r rrs r4rzcmd_migrate..s*)L)LA#ah--)L)L)L)L)L)Lr6FTz# Uploaded user memory files from: z< Nothing uploaded (files may already be migrated or empty).z Failed: z9 Run 'hermes honcho setup' first, then re-run this step.z9 No user memory files detected. Nothing to migrate here.u1Step 4 Seed AI identity files → Honcho AI peerzD SOUL.md, IDENTITY.md, AGENTS.md, TOOLS.md, BOOTSTRAP.md define thezD agent's character, capabilities, and behavioral rules. In OpenClawz: these are injected via file search at prompt-build time.zC In Hermes, they are seeded once into Honcho's AI peer through thezD observation pipeline. Honcho builds a representation from them andzF from every subsequent assistant message (observe_me=True). Over timezD the representation reflects actual behavior, not just declaration.c3$K|] }|jV dSrrrs r4rzcmd_migrate..s$#@#@qAF#@#@#@#@#@#@r6z/ Seed AI identity from all detected files now?rurvrseededfailedrz6 Run 'hermes honcho setup' first, then seed manually:z hermes honcho identity z# No agent identity files detected.z= To seed manually: hermes honcho identity z/Step 5 What changes vs. OpenClaw native memoryz StoragezL OpenClaw: markdown files on disk, searched via QMD at prompt-build time.zI Hermes: cloud-backed Honcho peers. Files can stay on disk as sourcez= of truth; Honcho holds the live representation.z Context injectionzH OpenClaw: file excerpts injected synchronously before each LLM call.zK Hermes: Honcho context fetched async at turn end, injected next turn.zL First turn has no Honcho context; subsequent turns are loaded.z Memory growthz7 OpenClaw: you edit files manually to update memory.zG Hermes: Honcho observes every message and updates representationszG automatically. Files become the seed, not the live store.z; Honcho tools (available to the agent during conversation)uQ honcho_context — session context: summary, representation, card, messagesu@ honcho_search — semantic search over stored contextu4 honcho_profile — fast peer card snapshotuF honcho_reasoning — ask Honcho a question, synthesized answeruC honcho_conclude — write a conclusion/fact back to memoryz Session naminguA OpenClaw: no persistent session concept — files are global.uF Hermes: per-session by default — each run gets its own sessionzB Map a custom name: hermes honcho map zStep 6 Next stepsuF 1. hermes honcho setup — configure API key (required)uA 2. hermes honcho migrate — re-run this walkthroughuB 1. hermes honcho status — verify Honcho connectionu9 2. hermes — start a sessionzF (user memory files auto-uploaded on first turn if not done above)uG 3. hermes honcho identity --show — verify AI peer representationuL 4. hermes honcho tokens — tune context and dialectic budgetsuD 5. hermes honcho mode — view or change memory mode)!rrr'rvr8rxr(r%rrrUrrrr!r&rr?r;r<rrUrNr@rrVrmigrate_memory_filesrEr{rrrb)rXrry openclaw_homeuser_file_namesagent_file_names user_files agent_filesrbdrgr,r.rrrr;r<rrNrFrGrYrZdirs_with_files any_uploadedrdrrstatuss r4 cmd_migrater7s  $ry{{  CDIKK+-M!+.OZZZJ K%%}% % %ADAxxzz %az11!!!$$$ %!&&}% & &ADAxxzz &a{22""1%%% & ..C#C(())G PQQQ GGG MNNN QRRR TUUU RSSS PQQQ GGG +,,, GGG[/23x=/A/AA/E/E+s8}RSS)+++5 >f>>??? !"""" VWWW ABBB  ?@@@ ./// 1222 ;SIII <<>>\ ) ) dOOO..C3778R0011GG GGG Y Z Z Z GGG 2333 GGG Q[ Q  " _C OO___ ` ` ` " "jQjj!!!!  " as;'7'7aaa b b b  " "jQjj!!!! OPPP PQQQ OPPP GGG BCCC GGG QRRR TUUU PQQQ GGG*K A$))#?#?J#?#?#???AABBB  STTT FGGG NOOO  MNNN W WA U V V V V  OHRUVVVF||~~--, SRRRRR'')))-@@BBD..t44F..fTJJJC"&";";"="=K%%k222&))L)L)L)L)L&L&LO#(L,0033KCC0+/L#^`DIIoD^D^``aaaa\]]] ,,,*q**++++++++,3.8 M N N N N IJJJ GGG =>>> GGG PQQQ PQQQ FGGG GGG OPPP PQQQ RSSS PQQQ GGG"O B$))#@#@K#@#@#@@@BBCCC   9NX[\\\F||~~--, SRRRRR'')))-@@BBD..t44F..fTJJJC"&";";"="=K%%k222(=="#++w+"?"?"E"E"G"G"=!$!5!5k7STSY!5!Z!ZB13%AXXF!";";";6";";<<< = !,,,*q**++++++++,+.0 J K K K  9 97A778888 9 3444 MNNN GGG ;<<< GGG + XYYY UVVV IJJJ GGG     TUUU WXXX XYYY GGG  CDDD STTT STTT GGG GHHH ]^^^ LMMM @AAA RSSS OPPP GGG  MNNN RSSS NOOO GGG  GGG  V VWWW QRRRR RSSS IJJJ VWWW WXXX \]]] TUUU GGGGGs27CV V< V77V<;C_ _=!_88_=cvt|ddat|dd}|dkr1tdtdddlm}|d dS|t |dS|d krt |dS|d krt |dS|d krt|dS|d krt|dS|dkrt|dS|dkrt|dS|dkrt|dS|dkrt|dS|dkrt|dS|dkrt|dS|dkrt|dS|dkrt!|dS|dkrt#|dStd|tddS)zRoute honcho subcommands.target_profileNhoncho_commandsetupz7 Honcho is configured via the memory provider system.z# Running 'hermes memory setup'... r)cmd_setup_providerrrpeersrumaprCrrtokensidentitymigrateenabledisablesyncz Unknown honcho command: zk Available: status, sessions, map, peer, mode, strategy, tokens, identity, migrate, enable, disable, sync )r6rlrUhermes_cli.memory_setuprrKrsrzrrrrrrrr[r]rh)rXrrs r4rrs' &6== $($ / /C g~~ HIII 4555>>>>>>8$$$ 4 4 $  T     T 4  T  D 4  D  0300111 |}}}}}r6cT|dddd|d}|dd |d d }|d dd|dd |dd |dd }|dddd|dd }|ddd |d!dd" |d#d$d%d&'|d(d) }|d(dd*d+d,-|d.d/ }|d.dd0d1d2-|d3d4 }|d5td6d78|d9td6d:8|d;d< }|d=ddd>|d?dd@|dAdB |dCdD |dEdF |dGdH |t IdS)JzBuild the ``hermes honcho`` argparse subcommand tree. Called by the plugin CLI registration system during argparse setup. The *subparser* is the parser for ``hermes honcho``. z--target-profileNAMErz;Target a specific profile's Honcho config without switching)metavardesthelpr)rrz7Initial Honcho setup (redirects to hermes memory setup))rrz0Show current Honcho config and connection statusz--all store_truez(Show config overview across all profiles)actionrrz(Show peer identities across all profilesruz"List known Honcho session mappingsrzGMap current directory to a Honcho session name (no arg = list mappings)r}?NzMSession name to associate with this directory. Omit to list current mappings.)nargsrPrrCz7Show or update peer names and dialectic reasoning levelz--userzSet user peer name)rrz--aizSet AI peer namez --reasoningLEVELrzCSet default dialectic reasoning level (minimal/low/medium/high/max))rchoicesrrz.Show or set recall mode (hybrid/context/tools)MODErz@Recall mode to set (hybrid/context/tools). Omit to show current.)rrrrrzHShow or set session strategy (per-session/per-directory/per-repo/global)STRATEGYrz.Session strategy to set. Omit to show current.rz2Show or set token budget for context and dialecticz --contextNz9Max tokens Honcho returns from session.context() per turn)typerrz --dialecticz:Max chars of dialectic result to inject into system promptrz9Seed or show the AI peer's Honcho identity representationrz=Path to file to seed from (e.g. SOUL.md). Omit to show usage.z--showz/Show current AI peer representation from HonchorzBStep-by-step migration guide from openclaw-honcho to Hermes Honchorz$Enable Honcho for the active profilerz%Disable Honcho for the active profilerz+Sync Honcho config to all existing profiles)func) add_argumentadd_subparsers add_parserri set_defaultsr) subparsersubs status_parser map_parser peer_parser mode_parserstrategy_parser tokens_parseridentity_parsers r4 register_clirJsF1A J  # #)9 # : :DOO F OOI$M +U OOG"LOMMMOOJ%IOJJJ ]!Jc4 \ //N"KXv!  OO Q OOH#IOJJJOOI$KOLLLOOF!NOOOO /////r6)r r rrr)r7r8rr)rrH)rri)rr )rr)rrs)r,rsr|r}rrH)r,rsrr )NF)rYr rPr8rrrr )rr)rr&)1__doc__ __future__rryr'rrrhermes_constantsrr?rr r rr r5r+r[r]rhrkrl__annotations__rTrWrrr%r*rrrr!r%r*rKrAr7rsrzrrrrrrrrrror6r4rsh #""""" ,,,,,,WWWWWWWWWW%%%%%%5555p*(,(,(,(,V,,,,"+ + + + \:!%$$$$!!!!!!!! ----    F " " " " "