+ Wj>JRt^RIt^RIt^RIt^RIHt]P !R4t]P!R4t R(t RRlt RRlt R t R R ltR R RRRRRR/RRlltRRltR)RRlltRRltRRltRRltRtRtRtR*tR R!ltR"R#ltR$R%ltR&R'ltR#)+zMessaging-platform setup wizards (Telegram, webhooks) and the ``hermes setup gateway`` flow. setup.py re-exports the public names, and tests monkeypatch prompt/print/env helpers on hermes_cli.setup, so those are imported lazily per function.N)Pathzhermes_cli.setupz^\d+:[A-Za-z0-9_-]{30,}$c0V^8dQhR\R\/#)tokenreturnstrbool)formats"NC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\setup_platforms.py __annotate__r s5555c>\\PV44#N)r _TELEGRAM_BOT_TOKEN_REmatch)rs&r _is_valid_telegram_bot_tokenrs &,,U3 44r c2V^8dQhR\R,/#rrNr)r s"r r r sOO3:Or cTVPPR8Xd VP#R#)zAReturn the active profile name when HERMES_HOME is a profile dir.profilesN)parentname) hermes_homes&r _profile_name_from_hermes_homers&*1166*D;  N$Nr c^RIHp^RIHpRp\ P !\4;_uu_4\\T!444pRRR4T!TR7# \dR#i;i +'giL+;i)zBAttempt automatic Telegram bot creation via managed QR onboarding.)get_hermes_home)auto_setup_telegram_bot_resultN) profile_name) hermes_cli.setuprhermes_cli.telegram_managed_botr ImportError contextlibsuppress Exceptionrr)rrrs r _setup_telegram_auto_resultr&sd0R $L   Y ' '5d?;L6MN  ( )| DD  ( 'sAA/ A,+A,/ A? cHV^8dQhR\R\R\R\/#)rlabelquestionenv_varsrr)r s"r r r &s( . . .s .s .t .r ca^RIHoHpHp\;QJdV3RlV4F 'gK RM RM!V3RlV44'gR#V!V R24V!VR4'*#)zTrue when any of ``env_vars`` is already set and the user does NOT want to reconfigure. Shared by the core wizards and every platform plugin's ``interactive_setup`` so the "already configured? Reconfigure? [y/N]" gate has one wording and one default. ) get_env_value print_info prompt_yes_noc34<"TF pS!V4xK R#5ir.0vr,s& r 'declines_reconfigure..-s2A}QTFz: already configured)r r,r-r.any)r(r)r*r-r.r,s&&* @r declines_reconfigurer8&sP JI 32233322 2 2%,-.Xu- --r passwordF success_msgskip_msg transformc |V^8dQhR\R\R\R\R,R\R,R\/#)renv_varr)r9r:Nr;rr)r s"r r r 3sC3#DWZ]aWa 4ZCFr c^RIHpHpHpHp V!WR7p V 'd;T !Y'd V!V 4MT 4V'dV!VP V R74V #V'd V!V4V #)zPrompt, persist the (optionally transformed) answer when non-empty, and report either way. ``success_msg`` may reference ``{value}``. Returns the raw answer ("" when skipped). ) print_success print_warningpromptsave_env_valuer9)value)r r@rArBrCr ) r>r)r9r:r;r<r@rArBrCrEs &&$$$$ r save_promptedrF3s] VU 8 /E wI % 05I  +,,5,9 : L h Lr c@V^8dQhR\R\R\RR/#)rr>usersr:rNr)r s"r r r Ds(S34r cV^RIHpHpV!WPRR44V!V4R#)z1Strip spaces, persist the allowlist, and confirm.)r@rC N)r r@rCreplace)r>rHr:r@rCs&&& r _save_allowlistrMDs >7MM#r23+r c nV^8dQhR\R\R\R\R\R,R\/#)rr>r)r:open_msgpresetNrr)r s"r r r Ks>""s"c""s"\_bf\f"ru"r c^RIHpHpVf V!V4MTpV'd\WV4MV!V4VP RR4#)zXPersist ``preset`` (or the prompted answer) as an allowlist, warning when it stays open.)r-rBrJrK)r r-rBrMrL)r>r)r:rOrPr-rBrHs&&&&& r _prompt_allowlistrRKs;3 &F8 FE  48 ==b !!r c@V^8dQhR\R\R\RR/#)rr>rEdefaultrNr)r s"r r r Vs. G G GC G# G$ Gr c^RIHpHpHpV'gR#V!V\ \ V444V!RV 24R# \ dT!RT 24R#i;i)zOPersist ``value`` as an int port; warn (keeping ``default``) when it isn't one.)r@rArCNzWebhook port set to z#Invalid port number, using default )r r@rArCrint ValueError)r>rErTr@rArCs&&& r _save_portrXVsWMM GwCJ0,UG45 G;G9EFGs&>AAc2V^8dQhR\R,/#rr)r s"r r r bsEEC$JEr c^RIHpHpHpV!R4V!RRR7pV'd\ V4'd T;'gR#V!R4K:)) print_errorr-rBz'Create a bot via @BotFather on TelegramTzTelegram bot tokenrDNznInvalid token format. Expected: : (e.g., 123456789:ABCdefGHI-jklMNOpqrSTUvwxYZ))r r\r-rBr)r\r-rBrs r _prompt_telegram_bot_tokenr]bsJ@@89 +d;4U;;==D D Er cV^8dQhRR/#rr0)r s"r r r ms f f4 fr c^RIHpHpHpHpV!R4'dR#V!R4V!RR4'd*V!R4V!R4pV'd\ RVR 4R#R#R#) z?Existing config kept as-is: warn when it has no user allowlist.)r,r-rBr.TELEGRAM_ALLOWED_USERSNuA⚠️ Telegram has no user allowlist - anyone can use your bot!zAdd allowed users now?Tz6 To find your Telegram user ID: message @userinfobotz"Allowed user IDs (comma-separated)zTelegram allowlist configured)r r,r-rBr.rM)r,r-rBr. allowed_userss r _telegram_allowlist_nudgerbms]QQ-..RS-t44KLCD  4mEd e 5r c 8^RIHpHpHpV!RRRRRRRRR4 R;r4V!R R R 7P 4R 8XdM\ 4pV'd)VP p\V4'g V!R 4R;r4V'g V!RR R4V'g \4pW43#)zMReturn (token, setup_result); auto flow first when chosen, else manual paste.)_infor\rBz/How would you like to create your Telegram bot?Nz [1] Automatic (recommended)u6 Scan a QR code → confirm in Telegram → done.z! No token copy-paste needed.z [2] Manualz? Create a bot via @BotFather yourself and paste the token.z Choice [1/2]1)rTz7Automatic setup returned an invalid Telegram bot token.zFalling back to manual setup...) r rdr\rBstripr&rrr])rdr\rBr setup_results r _obtain_telegram_tokenrhzs;; ;T ) B -t  KT S  E nc*002c924  &&E/66UV'++ $94 @ *,  r c T^RIHpHpHpHpHpHpHpV!R4\RRR4'd \4R#\4wrxV'gR#V!RV4V!R4V!RRRR R R4Rp \\VR R4;'gR 4p V 'dsV!R V 24V!RR4'dYV!R4p RP\PV .\!RV P#RR 4P%R44O44p \'RRRRV R7p V!RRRR4V 'd'V P%R4^,P)4MR p V 'gV!R4\+RR4R#V!RV R2R4'dV!RV 4V!R V 24R#\+RR!4R#)"z1Configure Telegram bot credentials and allowlist.)rdr- print_headerr@rBr.rCTelegramzReconfigure Telegram?TELEGRAM_BOT_TOKENNzTelegram token savedu,🔒 Security: Restrict who can use your botz! To find your Telegram user ID:z& 1. Message @userinfobot on Telegramz: 2. It will reply with your numeric ID (e.g., 123456789) owner_user_idrKz Detected your Telegram user ID: z+Allow this Telegram account to use the bot?Tz7Additional allowed user IDs (comma-separated, optional),rJr`z?Allowed user IDs (comma-separated, leave empty for open access)zATelegram allowlist configured - only listed users can use the botu@⚠️ No allowlist set - anyone who finds your bot can use it!)rPu:📬 Home Channel: where Hermes delivers cron job results,z. cross-platform messages, and notifications.z: For Telegram DMs, this is your user ID (same as above).zI You can also set this later by typing /set-home in your Telegram chat.TELEGRAM_HOME_CHANNELz*Home channel ID (leave empty to set later)zUse your user ID (z) as the home channel?zTelegram home channel set to zHHome channel ID (or leave empty to set later with /set-home in Telegram))r rdr-rjr@rBr.rCr8rbrhrgetattrjoindictfromkeysfilterrLsplitrRrfrF) rdr-rjr@rBr.rCrrgra detected_idextra first_user_ids r _setup_telegramrysvvvJ(?AUVV!#02E '/() $> - 2 FNMglOTBHHbIK8 FG F M MTUEHHT]]K3r&u}}]`bdOeOkOkloOpBq3r%stM% "cKJS`bM $L : FH5m_EF-/yzr c ^RIHpHpHpHpHpHpV!R4\RRR4'dR#\4V!R4V!R4V!R4\4V!R R4\R V!R 4R 4\R RRRRR7V!RR4\4V!R4^RI H pV!RV!4 R2RRRRRRRR4 R#)zConfigure webhook integration.)rdrjr@rArBrCWebhookszReconfigure webhooks?WEBHOOK_ENABLEDNuD⚠ Webhook and SMS platforms require exposing gateway ports to thezE internet. For security, run the gateway in a sandboxed environmentzB (Docker, VM, etc.) to limit blast radius from prompt injection.zX Full guide: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/webhooks/ WEBHOOK_PORTzWebhook port (default 8644)8644WEBHOOK_SECRETz-Global HMAC secret (shared across all routes)TzWebhook secret saveduENo secret set — you must configure per-route secrets in config.yaml)r9r:r;truezWebhooks enabled! Next steps:)display_hermes_homez 1. Define webhook routes in z /config.yamlz3 2. Point your service (GitHub, GitLab, etc.) at:z3 http://your-server:8644/webhooks/z Route configuration guide:z_ https://hermes-agent.nousresearch.com/docs/user-guide/messaging/webhooks/#configuring-routesz2 Open config in your editor: hermes config edit) r rdrjr@rArBrCr8printrXrFhermes_constantsr)rdrjr@rArBrC_dhhs r _setup_webhooksrsjjJ(?ARSS GXYYZVW G dfjk~v&CDfM"$S^b5ce$f- G12< +DF8< @ ? ? ) k  > >@r c0V^8dQhR\R\/#)rstatusrr)r s"r r r sYYYYr chVP4pVR8H;'gVPR4'*#)zAA platform counts as configured unless its status says otherwise.znot configured) partiallyzplugin disabled)lower startswith)rss& r _is_progressrs. A%%WW6V)W XXr cV^8dQhRR/#rr0)r s"r r r s j jT jr c a^RIHoHpHp\UUUu.uFZwr#pS!V4'gK\ ;QJdV3RlV4F 'gK RM RM!V3RlV44'dKXVNK\ ppppV'gR#\ 4V!RRPV4 24V!.R ORV4O5!R#uupppi) z+Platforms with a token but no home channel.)r,rdrAc34<"TF pS!V4xK R#5irr0r1s& r r4._warn_missing_home_channels..s/T)Q a0@0@)r6TFNzNo home channel set for: z, c3J"TFpRVP4 R2xK R#5i)z hermes config set z_HOME_CHANNEL N)upper)r2plats& r r4rs$ h[gSW%djjl^3M N[gs!#)z7 Without a home channel, cron jobs and cross-platformz2 messages can't be delivered to those platforms.z1 Set one later with /set-home in your chat, or:)r r,rdrA_HOME_CHANNEL_CHECKSr7rrq)rdrAr token_var home_vars missing_homer,s @r _warn_missing_home_channelsrsDD/CV/C+)  # ,/C/T)/TCCC/T)/T,T /CV  G-dii .E-FGH j i[g hjVsB< B<B<B<0B<c4V^8dQhR\R\RR/#)r any_messagingsupports_systemdrN)r )r s"r r r s! . .D .D .T .r c^RIHpHp^RIHpHpHpHpHpH p ^RI p V'dV!4'd V !R4R#V'dV!RR4'gR#V'd V!4R#V P4R8Xd V!4R#V P4R8Xd^R I H p V P4R#R# TdBp T!R 4\T 4P!4Fp \#R T 24K Rp ? R#Rp ? iTdp T!R T 24T !R4Rp ? R#Rp ? i\$dp T!R T 24Rp ? R#Rp ? ii;i) uAlready running: offer a restart only when this pass may have changed platform config — a restart interrupts any active session, so it stays behind a prompt.)r\r.)systemd_restartlaunchd_restartUserSystemdUnavailableErrorSystemScopeRequiresRootError$_system_scope_wizard_would_need_root_print_system_scope_remediationNrestartz) Restart the gateway to pick up changes?TDarwinWindows)gateway_windowsu0 Restart failed — user systemd not reachable:z z Restart failed: )r r\r.hermes_cli.gatewayrrrrrrplatformsystem hermes_clirrr splitlinesrr%)rrr\r.rrrrrr _platformrelines&& r _restart_running_gatewayrs <!@BB' 2 m,WY]^^.       8 +      9 , 2  # # %- 'FGF%%'D Btf+ ( '3 (,-' 22 .(,--.sNB4B4'B4+B44D>;6C77D>D>D D>'D>( D99D>c$V^8dQhR\/#)rconfig)rr)r s"r r r !s&&$&r c pa^RIHpHpHpHpHp^RIHpHoH pV!R4V!RRR4V!4pVU u.uF p S!V 4NK p p \W4U U u.uFwrV R, RV R , R V R 2NK p p p \V 4U U u.uFwrV R 8XgKV NK pp p V!R W4pV'g V!R4T;'gRFpV!VV,4K \;QJd$V3RlV!44F 'gK RM RM!V3RlV!444pV'd)\4V!\4V!R4\4^RIHpHp^RIHpV!4p\4V!4'd\)VV4M V!RRVR7V!\4R#uup iuup p iuup p i)z*Configure messaging platform integrations.)rdrjr-r@prompt_checklist)_all_platforms_platform_status_configure_platformzMessaging PlatformszAConnect to messaging platforms to chat with Hermes from anywhere.z&Toggle with Space, confirm with Enter.NemojirJr(z () configuredzSelect platforms to configure:zENo platforms selected. Run 'hermes setup gateway' later to configure.c3F<"TFp\S!V44xK R#5ir)r)r2prs& r r4 setup_gateway..6s!TCSa %5a%899CSs!TFzMessaging platforms configured!)_is_service_runningsupports_systemd_services)ensure_gateway_servicesetup)context interactiverr0)r rdrjr-r@rrrrrzip enumerater7r_RULErrr hermes_cli.gateway_setup_servicerr)rrdrjr-r@rrr platformsrstatusesritemsi pre_selectedselectedidxrrrrrrs& @r setup_gatewayr!suaaXX&' M 2D: I4==94 &9H=PST]Ph iPh W aW c& ;PhE i'0':U':)!f >TAA':LU @%VH Z[~~2~IcN+ CT>CSTCCCT>CSTTM 578#%RG02 G 0@A wDPu9> iUsF'$F, F2F2u━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━r))rkrl)ro)DiscordDISCORD_BOT_TOKEN)DISCORD_HOME_CHANNEL)SlackSLACK_BOT_TOKEN)SLACK_HOME_CHANNEL) BlueBubblesBLUEBUBBLES_SERVER_URL)BLUEBUBBLES_HOME_CHANNEL)QQBot QQ_APP_ID)QQBOT_HOME_CHANNELQQ_HOME_CHANNEL)__doc__r#loggingrepathlibr getLoggerloggercompilerrrrr&r8rFrMrRrXr]rbrhryrrrrrrr0r r rsK    - .$?@5O E .5dh*.:>"" GE f0&{^@@Y j .F&r