ei_hUdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z d9d Zd:d;dZddZd?dZd?dZd@dZd:dAdZdBd ZdCdDd%ZdEd&Zdd(ZdFd*Z d ( KK ' ' 't uus3A?AA?? B  B Nonec dt}t}|dkrd|dnd}|di|i}|ddurt d|d d Sd|d<|d s|dit i}d D]"}||}| ||vr|||<#|d p|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!) rrrrrrrrrrrr rr"zHoncho enabled.zPeer 'z' ready.z'Peer creation deferred (no connection). Saved to  ) r$ _host_keyr(r%printr splitr)r* _config_path) argsr+r=labelblockr,r0r1r2rCs r3 cmd_enablerX^sn ..C ;;D H,,LLLLL"E NN7B ' ' 2 24 < hermes.rNz z profile(s) synced.z* All profiles already have Honcho config.rMz) profile(s) already configured (skipped).) hermes_cli.profilesr]rDrRr$r%r rr&r'namer4) rUr]profileser+rr,r-createdskippedps r3cmd_syncrfs 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}|sdS|dit i}t |dptjd}|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\rrrr^rN) r_r]rDr$r%r rr&r'r`r4)r]rar+r,r-rcres r3sync_honcho_profiles_quietris  555555 =?? qq ..C qGGGR((,,T266M3778$$H 7G(H(HIIG qG  6Y    #AF + +  qLG Ns  !!_profile_overridecntr!tdvrtStdtStS)zKReturn the active Honcho host key, derived from the current Hermes profile.)r^customr)rjr rr5r3rQrQs<-  5 5 5K,,*,,,   r5rctS)zLReturn the active Honcho config path for reading (instance-local or global).)r rmr5r3rTrTs   r5c$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.jsonrrmr5r3_local_config_pathrps   } ,,r5dictct}|r9 tj|dS#t $rYnwxYwiS)Nutf-8encoding)rTexistsjsonloads read_textrD)paths r3r$r$sc >>D {{}} :dnngn>>?? ?    D  Is'A AAr+rz Path | Nonec|p t}|jdd|t j|dddzddS) NT)parentsexist_okF)indent ensure_asciirPrsrt)rpparentmkdir write_textrwdumps)r+rzs r3r)r) so  '%''DKdT222OO 3qu555<r5c|dpitpid}|p5|ddptjddS)z2Resolve API key with host -> root -> env fallback.rrrLr)r%rQr&r')r+r6s r3_resolve_api_keyrsm!!'R,,Y[[99?RDDXNNH  Tswwx,, T ?OQS0T0TTr5FrVr^secretc|rd|dnd}tjd||dtj|rjtjrddl}|d}natj}n0tj}|p|pdS)N []rLrM: r)prompt) sysstdoutwriteflushstdinisattygetpassreadlinestrip)rVr^rsuffixrr1s r3_promptrs ' /_'____RFJ+%++++,,,J + 9     / NNN///,,CC)$$&&,,..CCi  ""((**  !7=b!r5c 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)yr^ryesz8 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 ImportErrorrRrlower subprocessrunr executable returncodestderrr)ranswerrresults r3_ensure_sdk_installedr)s,  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)baseUrlrArLN)r%).0hr+s r3 zcmd_setup..^s^$$  cggi  =CGGJ$7$7=2>$$$$$$r5) localhostz 127.0.0.1z::1localcloudzCloud or local?r)rlrArrLzBase 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!rIz 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)nonerzno 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 cadencerNrrlowz 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$rprTrRrvrr(rQanyrrpopr%lenr&getenvr rg ValueError TypeErrorrr)hermes_cli.configrrrDr>r:r;rr?resolve_session_name workspace_idr2rCobservation_modewrite_frequency recall_modesession_strategy)-rU 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_tokensr1current_dialectic new_dialecticcurrent_reasoning new_reasoning current_strat new_stratrr hermes_configrbr:r;rrEr+s- @r3 cmd_setuprGs ..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_namer^)rjr_rrDrs r3_active_profile_namer.sX!  ??????&&((( 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\rr^r) r_r]rDrrQr$r%r appendr`)r]rar+rresultsr,rers r3_all_profile_host_configsr9s ;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. r9r<z Config error: rPrLrrrrrr^rrz 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) tokensrawrrNz 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_allrrrRr$rTrpr>r:r;r?rQrDr@rrr=r#rrhomervrCr2rrrcontext_tokensr%reasoning_level_capreasoning_heuristicdialectic_reasoning_leveluser_observe_meuser_observe_others ai_observe_meai_observe_othersrrA_show_peer_cards)rUshow_allrr+ active_pathrr:r;rErbr@rprofile profile_label global_pathrdialectic_cadence reasoning_cap heuristic_onrFreasons r3 cmd_statusr:UstUE**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 morerepresentationrLrz AI peer representation: z: No peer data yet (accumulates after first conversation)z Peer data unavailable: rP) plugins.memory.honcho.sessionr=r get_or_create get_peer_cardrRrget_ai_representationr%rD) rErFr=mgr session_keycardfactai_repai_textdisplayrbs r3r0r0s3FFFFFF""&>>>//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 (r#u───────────────────────────────────────────────────────rMProfile<14 Hostz<22Enabledz<9RecallWrite*──────────────uB──────────────────────u─────────r#NrrFrnorrrrz *rLz * active profile ) rr$rrRrr%rr&r') rowsr+activer`r=rWr# has_creds enabled_strrecallrmarkers r3r&r&s $ & &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 #$$$$$r5c 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──────────────────────────────────────────────────rMrPrQrRz User peerz<16zAI peerrWu0────────────────u6──────────────────r (not set)r!N)rr$rRrr%)rUrYr+r`r=rWrais r3 cmd_peersrbs0 $ & &D ..C >s4yy > > > KLLL z Or edit z directly. Nz Honcho session mappings (r#ru ←rLrMz<30rR) r$r%rRrTr&getcwdrsorteditems)rUr+rdcwdrzr`r^s r3 cmd_sessionsris ..Cwwz2&&H  3444 @AAA 7<>>777888 )++C :H : : :Z GHHHX^^--.... d3;;B ,4,,,d,F,,---- GGGGGr5c|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: rdz Mapped u → rP) session_namerir&rerrRresubr$r(r))rUrhrlrm sanitizedr+s r3cmd_maprp s  T )++C$**,,L  1222 III(#|<<BB3GGIL   9i99::: ..C*6CNN:r""3'# 6c 6 6l 6 6 677777r5ct}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.FrNra reasoningrrr r`r!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 rIrJrKrLTrMz User peer -> z AI peer -> z Invalid reasoning level ' '. Options: zDialectic reasoning level -> rOrP) r$r%r%rQrRjoinrr(r)rT)rUr+changed user_nameai_namerrREASONING_LEVELSrrIrralvl max_charsr=rVs r3cmd_peerr~&s ..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.../////00r5c 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 ──────────────────────────────────────── <-rLrMz<10z7 Set with: hermes honcho mode [hybrid|context|tools] z Invalid mode 'rvrurPrIrJrKzRecall mode -> rtr# r$r%r%rQrRrgrwr(r)) rUMODESr+mode_argcurrentmdescr^r=rVs r3cmd_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 FGGGGGr5c 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 rtr#r) rU STRATEGIESr+ strat_argrrrr^r=rVs r3 cmd_strategyrsUW49 J ..Cj$//I WWW   # ( (b 9 9 = =>O P P ww())   8999!'')) 0 0GAt7llUUF .q....f.. / / / / cddd "" UYUUDIIj Tzdialectic cap -> z charsrOrP)r$r%rQr%rRr(r)rT) rUr+rrIrr ctx_tokensd_charsd_levelr=rVrxs r3 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.../////00r5ct}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. NfileshowFrr9r<r<r>z Honcho connection failed: rPz User peer (rr#rrMz: No user peer card yet. Send a few messages to build one.z AI peer (rArJz 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: rsrtz 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$rrRr%r>r:r;rDr=r?rQrrErDrFr2rGrCr%pathlibr expanduserrvryrr`seed_ai_identity)rUr+ file_pathrr:r;r=rErFrHrIrb user_cardrKrLrrecontentroks r3 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?rrrrLzE 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:rCz 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: ruc3$K|] }|jV dSNr`rfs r3rzcmd_migrate..rs$#?#?qAF#?#?#?#?#?#?r5zC 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?rr<r>c3>K|]}t|jVdSr)r rrs r3rzcmd_migrate..s*)L)LA#ah--)L)L)L)L)L)Lr5FTz# 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 r3rzcmd_migrate..s$#@#@qAF#@#@#@#@#@#@r5z/ Seed AI identity from all detected files now?rsrtrseededfailedrz6 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&rer'rvrr$rrrRrrrrr%rwr>r:r;rrDr=r?rrErmigrate_memory_filesrDryrrr`)rUrrh openclaw_homeuser_file_namesagent_file_names user_files agent_filesr`drer+r-rrrr:r;rr=rErFrHrIdirs_with_files any_uploadedrbrrstatuss r3 cmd_migraters  $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_providerrrpeersrdmaprBrrtokensidentitymigrateenabledisablesyncz Unknown honcho command: zk Available: status, sessions, map, peer, mode, strategy, tokens, identity, migrate, enable, disable, sync )r%rjrRhermes_cli.memory_setuprr:rbrirpr~rrrrrrXrZrf)rUrnrs r3rrs' &6== $($ / /C g~~ HIII 4555>>>>>>8$$$ 4 4 $  T     T 4  T  D 4  D  0300111 |}}}}}r5cT|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 profilesrdz"List known Honcho session mappingsrzGMap current directory to a Honcho session name (no arg = list mappings)rl?NzMSession name to associate with this directory. Omit to list current mappings.)nargsr^rrBz7Show 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_parserrg set_defaultsr) subparsersubs status_parser map_parser peer_parser mode_parserstrategy_parser tokens_parseridentity_parsers r3 register_clir,sF1A J  # #)9 # : :DOO F OOI$M +U OOG"LOMMMOOJ%IOJJJ ]!Jc4 \ //N"KXv!  OO Q OOH#IOJJJOOI$KOLLLOOF!NOOOO /////r5)r r r rr)r6r7r r)r rG)r rg)r r )r r)r rq)r+rqrzr{r rG)r+rqr r )NF)rVr r^r7rrr r )r r)r r)/__doc__ __future__rrwr&rrrhermes_constantsrr>rr r r4r*rXrZrfrirj__annotations__rQrTrpr$r)rrrrrrr:r0r&rbrirpr~rrrrrrrrmr5r3rsY #""""" ,,,,,,WWWWWWWWWW5555p*(,(,(,(,V,,,,"+ + + + \:!%$$$$!!!!!!!! ----UUUU " " " " "