PL j|UdZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z m Z mZddlmZmZmZmZmZddlmZmZddlmZmZddlmZmZdd lmZm Z ej!e"Z#e e$j%j%&Z'dd l(m)Z*m+Z,m-Z.m/Z0m1Z2gd Z3hd Z4d e5fdZ6dhdhdZ7e e8ee8fe9d<de8de8d e5fdZ:dZ;d em?Z@de@jADZ?dddddgddd d!d"gd#d$d%d&gd'd(d)d*d+d!d,d-d.gdd(d/d0gd1d2d3d4d*d5d6d7d8d.gd9d(d:d;dd?d.gd@d(dAdBdCgdDdDdEdFdBdGgdHdHdEgdIdJdKdLdMdddNdOgddPdQdRgdSdTdUdVdOdRdWdXgdYgdZd[d\ddd]gdd^d_gd`dadbd*dcd_ddded.gd`dfgdIdgdhgdIdidjdkdldmddngd2dodpd*dqdrdpdsd.gdtgdZdudvdwddxgdyddzd{gd|d} d~d%dgdd|dddddddddgdddgdIdddddddXddddgdgdIddddgddgdIddddddgddogdd ZBdgdgdZCdddde e8deDde5fdZEdde5d e5fdZFdde8de5d e5fdZGde8fdZHd e e8fdZIddeJde e e8d e e8ee8ffdZKdde5d e5fdZLdddeJde8de5d ee8fdZMdeJde8dee8fdZNdde8deJd e5fdZOdde8dePdeDd eDfdĄZQdaRe e e8eDfe9d<d e e8eDffdƄZSdde8dee8de8d ee8fdʄZTde8deJfd˄ZUd ePeJfd̄ZVd ePeJfd̈́ZWd ePeJfd΄ZXd ePeJfdτZYdeJdeJd ePeJfdфZZdd҄iZ[eJe9d<de8d e5fdԄZ\de8deJd e5fdՄZ]de8deJdeJfdքZ^deJdeJd e5fd؄Z_dePdeJd eDfdڄZ`dۄZad`dbd^eadܜiZbde8deJdeJd e8fdZcde8deJd dfdZdde8fdZede8deJd dfdZfde8deJd dfdZgde8fdZhde8deJd dfdZide8deJd dfdZjdeJdeJfdZkde8fdZldeJfdZmde8deJd e5fdZnde8deJdeJfdZodeJdeJfdZpde8fdZqdde5deJfdZrdeJfdZsdeJde8de e8de8fdZtdeJde e8de8d ee8fdZudder'r"r7r6r&r%r8r5returncn ddlm}|dS#t$rYnwxYw ddlm}t |dpdrdSn#t$rYnwxYwtt tj dpdS)uCheap, side-effect-free check for usable xAI credentials. Used to auto-enable the ``x_search`` toolset when the user has either completed xAI Grok OAuth (SuperGrok subscription) or set ``XAI_API_KEY``. Does NOT hit the network — only inspects the local auth store and environment. The tool's runtime ``check_fn`` still gates schema registration if creds later expire or get revoked. r)_read_xai_oauth_tokensTr XAI_API_KEY) hermes_cli.authr= Exceptiontools.xai_httpr strstripboolosenvironget)r=_xai_get_env_values ;/home/kuhnn/.hermes/hermes-agent/hermes_cli/tools_config.py_xai_credentials_presentrLds ::::::   t       FFFFFF !!-006B 7 7 = = ? ? 4       BJNN=117R88>>@@ A AAs !!2A A'&A'r7)r7r8_TOOLSET_PLATFORM_RESTRICTIONSts_keyplatformcFt|}|dup||vS)zReturn True if ``ts_key`` is configurable on ``platform``. Toolsets without a restriction entry are allowed everywhere (the default). N)rMrI)rNrOalloweds rK_toolset_allowed_for_platformrRs+ -0088G d? 1h'11ctt}d|D} ddlm}m}||D]=}|d|vr ||d||>n#t$rYnwxYw|S)uReturn CONFIGURABLE_TOOLSETS + any plugin-provided toolsets. Plugin toolsets are appended at the end so they appear after the built-in toolsets in the TUI checklist. A plugin whose toolset key already appears in ``CONFIGURABLE_TOOLSETS`` is skipped — bundled plugins (e.g. ``plugins/spotify``) share their toolset key with the built-in entry, and we want the built-in label/description to win. Without the dedupe, ``hermes tools`` → "reconfigure existing" would list the same toolset twice. ch|]\}}}| SrV.0rN_s rK z7_get_effective_configurable_toolsets..s . . .|vq!F . . .rSrdiscover_pluginsget_plugin_toolsets)listCONFIGURABLE_TOOLSETShermes_cli.pluginsr\r]addappendrB)resultseenr\r]entrys rK$_get_effective_configurable_toolsetsrfs' ( (F . .v . . .D  LLLLLLLL((** ! !EQx4 HHU1X    MM%  !      MsAA== B  B c ddlm}m}|d|DS#t$rt cYSwxYw)z3Return the set of toolset keys provided by plugins.rr[ch|]\}}}| SrVrVrWs rKrZz+_get_plugin_toolset_keys..sAAA<61aAAArS)r`r\r]rBsetr[s rK_get_plugin_toolset_keysrjstLLLLLLLLAA+>+>+@+@AAAA uu s%(AA) PLATFORMSc4i|]\}}||j|jdS)labeldefault_toolsetrm)rXkinfos rK rrs;   40DEE   rSzText-to-Speechu🔊zNous Subscription subscriptionz.Managed OpenAI TTS billed to your subscriptionopenaiTr)VOICE_TOOLS_OPENAI_KEYOPENAI_API_KEY)namebadgetagenv_vars tts_providerrequires_nous_authmanaged_nous_featureoverride_env_varszMicrosoft Edge TTSu★ recommended · freezGood quality, no API key needededge)rwrxryrzr{z OpenAI TTSpaidzHigh quality voiceszOpenAI API keyz$https://platform.openai.com/api-keys)keyrurlzxAI TTSu2Grok voices — uses xAI Grok OAuth or XAI_API_KEYxaixai_grok)rwryrzr{ post_setup ElevenLabszMost natural voicesELEVENLABS_API_KEYzElevenLabs API keyz+https://elevenlabs.io/app/settings/api-keys elevenlabszGoogle Gemini TTSpreviewz,30 prebuilt voices, controllable via promptsGEMINI_API_KEYzGemini API keyz&https://aistudio.google.com/app/apikeygemini KittenTTSu local · freez.Lightweight local ONNX TTS (~25MB), no API key kittentts)rwrxryrzr{rPiperz0Local neural TTS, 44 languages (voices ~20-90MB)piper)rwicon providersWeb Search & ExtractzSelect Search ProviderucA free DuckDuckGo search skill is also included — skip this if you don't need a premium provider.u🔍z-Managed Firecrawl billed to your subscription firecrawlrFIRECRAWL_API_KEYFIRECRAWL_API_URL)rwrxry web_backendrzr|r}r~zFirecrawl Self-Hostedufree · self-hostedz(Run your own Firecrawl instance (Docker)z9Your Firecrawl instance URL (e.g., http://localhost:3002))rr)rwrxryrrz)rw setup_title setup_noterrImage Generationu🎨z8Managed FAL image generation billed to your subscriptionr#FAL_KEYfal)rwrxryrzr|r}r~imagegen_backendzFAL.aiz@Pick from flux-2-klein, flux-2-pro, gpt-image, nano-banana, etc.z FAL API keyzhttps://fal.ai/dashboard/keys)rwrxryrzrVideo Generationu🎬zX (Twitter) SearchzSelect xAI Credential SourceuHermes routes X searches through xAI's built-in x_search Responses tool. Both credential sources hit the same https://api.x.ai/v1/responses endpoint — pick whichever you already have. SuperGrok OAuth is preferred when both are set (uses your subscription quota instead of API spend).u🐦z'xAI Grok OAuth (SuperGrok Subscription)u6Browser login at accounts.x.ai — no API key required)rwrxryrzrz xAI API keyz&Direct xAI API billing via XAI_API_KEYr?zhttps://console.x.ai/)rwrxryrzBrowser Automationu🌐z%Nous Subscription (Browser Use cloud)z/Managed Browser Use billed to your subscriptionz browser-userBROWSER_USE_API_KEY agent_browser) rwrxryrzbrowser_providerr|r}r~rz Local Browserz$Headless Chromium, no API key neededlocal)rwrxryrzrrCamofoxu free · localz)Anti-detection browser (Firefox/Camoufox) CAMOFOX_URLzCamofox server URLzhttp://localhost:9377z)https://github.com/jo-inc/camofox-browser)rrdefaultrcamofoxz Smart Homeu🏠zHome AssistantzREST API integration HASS_TOKENz&Home Assistant Long-Lived Access TokenHASS_URLzHome Assistant URLzhttp://homeassistant.local:8123)rrr)rwryrzSpotifyu🎵zSpotify Web APIu%PKCE OAuth — opens the setup wizardr6)rwryrzrzComputer Use (macOS)u🖱️darwinzcua-driver (background)u ★ recommended · free · localunmacOS background computer-use via SkyLight SPIs — does NOT steal your cursor or focus. Works with any model. cua_driver)rwr platform_gater) r)rr#r%r&rr5r6r:)OPENROUTER_API_KEYzhttps://openrouter.ai/keys)r r',)timeoutcapture_outputargsrrc $ttjjj}itjdt |i}tjd}|rI tj |ddg||d||}|j dkr|Sn#tj tf$rYnwxYwtjddg} tj |d gzddd }|j dkrtd n#tj tf$rr tj tjdd ddgddddnE#tjtj f$r'} tj|ddd| cYd} ~ cYSd} ~ wwxYwYnwxYwtj |dg|z|d| S)uInstall Python packages from a post-setup hook. Strategy (in order): 1. ``uv pip install`` if uv is on PATH — fast, doesn't need pip in the venv. 2. ``python -m pip install`` — works on stdlib venvs. 3. ``python -m ensurepip --upgrade`` then retry pip — covers ``uv venv`` which creates a venv WITHOUT pip. Why this exists: the Windows installer creates the venv via ``uv venv``, which doesn't seed pip. Post-setup hooks that shelled out to ``[sys.executable, '-m', 'pip', 'install', ...]`` failed with ``No module named pip`` on every fresh install. uv-first sidesteps that. Returns the ``subprocess.CompletedProcess`` from whichever tier succeeded (or the last failure for the caller to inspect). VIRTUAL_ENVuvpipinstallT)rtextrenvrz-m --versionrrrzpip not in venv ensurepipz --upgradez --default-pipx)rrrcheckr@z(pip not available and ensurepip failed: ) returncodestdoutstderrN)rsys executableparentrGrHrDshutilwhich subprocessrunrTimeoutExpiredFileNotFoundErrorCalledProcessErrorCompletedProcess) rrr venv_rootuv_envuv_binrcpip_cmdprobees rK _pip_installrs<,S^$$+2I : :M3y>> : :F \$  F  ^ 1D1-D'F  A%% &)+<=    D ~tU+G {m #dB     q #$566 6 !  %'8 9     N{KQ#$4     -z/HI   .AbE!EE              >9$t$$%D'   sT*BBB26C))E1(D)(E1)E+E&E+E1&E++E10E1Fupgradec<ddl}ddl}ddl}|dkr|rdSt ddS|jd}|sB|s@|jds t dt d dStd S|r|s |jdd gd d dj }td|pdn#t$rtdYnwxYwt dt dt dd S|jdst dt|S|rA |jdd gd d dj }n#t$rd}YnwxYwd}tdd}|rs|rq |jdd gd d dj }|r||krtd|d|n|rt d|n#t$rYnwxYw|S)uInstall or refresh the cua-driver binary used by Computer Use. The upstream installer always pulls the latest release tag, so re-running it is the canonical way to upgrade. We expose two modes: * ``upgrade=False`` — original post-setup behaviour: skip if already installed, install otherwise. Used by the toolset enable flow where we don't want to surprise the user with a network fetch. * ``upgrade=True`` — always re-run the installer (or call ``cua-driver update`` if the binary supports it). Used by ``hermes update`` and by ``hermes computer-use install --upgrade``. Returns True iff cua-driver is installed (or successfully refreshed) when the function returns. macOS-only — silently returns False on other platforms. rNDarwinFz6 Computer Use (cua-driver) is macOS-only; skipping. cua-drivercurlu( curl not found — install manually:zG https://github.com/trycua/cua/blob/main/libs/cua-driver/README.md Installing)rnrTrz" cua-driver already installed: zunknown versionz! cua-driver already installed.z, Grant macOS permissions if not done yet:: System Settings > Privacy & Security > Accessibility= System Settings > Privacy & Security > Screen Recordingu1 curl not found — cannot refresh cua-driver.r@ Refreshing)rnverbosez cua-driver upgraded: u → z cua-driver up to date: )rOrrsystem_print_warningr _print_info_run_cua_driver_installerrrrE_print_successrBrF) r_platrrbinaryversionbeforeokafters rKinstall_cua_driverr)s"MMM ||~~!!  5OPPPu V\, ' 'F ='=v|F##  E F F F a b b b5(|<<<< g  @$jn{+#$UUWW  ^@\K\^^ _ _ _ _ @ @ @ > ? ? ? ? ? @BCCCPQQQSTTTt 6<  JKKKF||  #Z^{+#$UUWW F   FFF  "u E E EB f  "JN{+#$UUWW  C&O6OOOOPPPP CA%AABBB    D  Is8ACC10C1-F FF,AH HHrrnrcddl}ddl}d}|rtd|dntd|d |j|dd }|jdkr_|jd rO|rKt d td td tdtddStd|dtd|dS#|j $r)td|dYdSt$r2}td|d|Yd}~dSd}~wwxYw)zRun the upstream cua-driver install.sh. Returns True on success. The script is idempotent: it always downloads the latest release, so re-running it on an already-installed system performs an upgrade. rNzq/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)" z. cua-driver (macOS background computer-use)...z cua-driver...Tr)shellrrz cua-driver installed.u. IMPORTANT — grant macOS permissions now:rrz2 Both must allow the terminal / Hermes process.z cua-driver z# did not complete. Re-run manually: Fz timed out. Re-run manually.z failed: ) rrrrrrrrlowerrrB)rnrrr install_cmdrcrs rKrrs MMM 0 2P5PPPQQQQ05000111 4EEE   ! !lfl<&@&@ ! R:;;;LMMMXYYY[\\\PQQQ4[[[[\\\*[**+++u  $TTTTUUUuu DDDDDEEEuuuuus$A;C+27C++/E E&'EEpost_setup_keyc ddl}|dvrwtdz dz }|jd}|jd}|s|rt dddl}|j|d d gd d tt }|jdkrtd nddl m }td|d|j r1t d|j ddn%|stddS|dkrdS ddlm}m} n*#t$$r} td| Yd} ~ dSd} ~ wwxYw|rtddS| r/tdt dt ddS|stddSt dddl}tdz dz dz } t&jdkr+| d} | r| } | rt| d d gn|d!dd d g} |j| d d ttd"#}|jdkrtd$ddlm}d|_n{td%|j p|jpd&d'd}|D]}t d|ddt d(dSdS#|j$r"td)t d(YdSt$$r,} td*| t d(Yd} ~ dSd} ~ wwxYw|d+kr[tdz d,z d-z }|jd}|s|rt d.t d/ddl} |j|d d0d1d2d3gtt4}|jdkrtd5ntd6n8#t$$r+} td7| t d8Yd} ~ nd} ~ wwxYw|r/t d9t d:t d;dS|jds td<t d=dSdS|d>krt7d?@dS|dAkr t9dAtdBdS#t:$rYnwxYwt dCdD} t=dE|dFdGgdHI}|jdkr.tdJt dKt dLnWtdMt d|j pd&ddHt dN|dOdSdS#|j$r&tdPt dN|dOYdSwxYw|dQkr" t9dQtdRn#t:$rt dS t=gdTdHI}|jdkrtdUnTtdVt d|j pd&ddHt dWYdSn0#|j$r#tdXt dWYYdSwxYwYnwxYwt dYt dZt d[dS|d\kr t9d\td]n#t:$rt d^ t=gd_dHI}|jdkrtd`nTtdat d|j pd&ddHt dbYdSn0#|j$r#tdct dbYYdSwxYwYnwxYwt ddt dedS|dfkrddglm } ddhl!m"}n9#t$$r,} tdi| t djYd} ~ dSd} ~ wwxYwt dk ||dddd?dltdmdS#tF$r,} tdn| t doYd} ~ dSd} ~ wt$$r,} tdp| t djYd} ~ dSd} ~ wwxYw|dqkri ddrl!m$}tK|&ds}n#t$$rd?}YnwxYwtOdt}|rtdudS|rtdvdSt dw ddxl(m)}m*}m+}ddyl,m-}n9#t$$r,} tdz| t d{Yd} ~ dSd} ~ wwxYw|d|gd}d~}|dkr,|rtddStddS|dkr=|dd }|r|dt|tddStddSt ddSdS)zBRun post-setup hooks for tools that need extra installation steps.rN> browserbaser node_modulesz agent-browsernpmnpxz8 Installing Node.js dependencies for browser tools...rz--silentT)rrcwdz" Node.js dependencies installeddisplay_hermes_homez* npm install failed - run manually: cd z/hermes-agent && npm installrzV Node.js not found - browser tools require: npm install (in hermes-agent directory)r)_chromium_installed_running_in_dockerz% Could not check Chromium status: z& Chromium browser already installedz5 Chromium is missing but you're running in Docker.z6 Pull the latest image to get the bundled Chromium:z: docker pull ghcr.io/nousresearch/hermes-agent:latestzT npx not found - install Chromium manually: npx agent-browser install --with-depsz5 Installing Chromium (~170MB one-time download)...z.binwin32z.cmdz --with-depsz-yiX)rrrrz Chromium installedz Chromium install failed:r@z7 Run manually: npx agent-browser install --with-depsz' Chromium install timed out (>10min)z Chromium install failed: rz@askjozcamofox-browserz) Installing Camofox browser package...uW First run downloads the Camoufox engine (~300MB) — this can take several minutes.z@askjo/camofox-browser@^1.5.2z --no-fundz --no-auditz--progress=false)rz Camofox installeduK npm install failed — run manually: npm install @askjo/camofox-browserz Camofox install failed: z4 Run manually: npm install @askjo/camofox-browserz Start the Camofox server:z npx @askjo/camofox-browserzV Or use Docker: docker run -p 9377:9377 -e CAMOFOX_PORT=9377 jo-inc/camofox-browserz2 Node.js not found. Install Camofox via Docker:zI docker run -p 9377:9377 -e CAMOFOX_PORT=9377 jo-inc/camofox-browserrF)rrz" kittentts is already installedz6 Installing kittentts (~25-80MB model, CPU-only)...z^https://github.com/KittenML/KittenTTS/releases/download/0.8.1/kittentts-0.8.1-py3-none-any.whl-U soundfile--quietr)rz kittentts installedz> Voices: Jasper, Bella, Luna, Bruno, Rosie, Hugo, Kiki, LeozO Models: KittenML/kitten-tts-nano-0.8-int8 (25MB), micro (41MB), mini (80MB)z kittentts install failed:z% Run manually: uv pip install -U 'z ' soundfilez' kittentts install timed out (>5min)rz" piper-tts is already installedzI Installing piper-tts (~14MB wheel, voices downloaded on first use)...)rz piper-ttsrz piper-tts installedz piper-tts install failed:z- Run manually: uv pip install -U piper-ttsz' piper-tts install timed out (>5min)zE Default voice: en_US-lessac-medium (downloaded on first TTS call)zU Full voice list: https://github.com/OHF-Voice/piper1-gpl/blob/main/docs/VOICES.mdzE Switch voices by setting tts.piper.voice in ~/.hermes/config.yamlddgsz ddgs is already installedz2 Installing ddgs (DuckDuckGo search package)...)rrrz ddgs installedz ddgs install failed:z( Run manually: uv pip install -U ddgsz" ddgs install timed out (>5min)zE No API key required. DuckDuckGo enforces server-side rate limits.z? Pair with an extract provider if you also need web_extract.r6)SimpleNamespace)login_spotify_commandz! Could not load Spotify auth: z% Run manually: hermes auth spotifyz Starting Spotify login...) client_id redirect_uriscope no_browserrz Spotify authenticatedz$ Spotify login did not complete: z" Run later: hermes auth spotifyz Spotify login failed: r)get_xai_oauth_auth_status logged_inr?zI xAI will use your xAI Grok OAuth (SuperGrok Subscription) credentialsz* xAI will use your existing XAI_API_KEYz& xAI needs credentials. Choose one:)_run_xai_oauth_login_from_setup prompt_choicer)r z" Could not load setup helpers: z? Run later: hermes auth add xai-oauth (or set XAI_API_KEY)z( How do you want xAI to authenticate?)uFSign in with xAI Grok OAuth (SuperGrok Subscription) — browser loginz#Paste an xAI API key (console.x.ai)u8Skip — configure later via `hermes auth add xai-oauth`)choicesru6 Logged in — xAI will use these OAuth credentialszO xAI Grok OAuth login did not complete. Run later: hermes auth add xai-oauthrz xAI API keypasswordz XAI_API_KEY savedz= No API key provided. Run later: hermes auth add xai-oauthz> xAI will remain inactive until credentials are configured.).r PROJECT_ROOTrexistsrrrrDrrhermes_constantsrrrrEtools.browser_toolrrrBrrO with_suffix browser_tool_cached_chromium_installedr splitlinesrr __import__ ImportErrorrtypesrrAr SystemExitr rFrIr hermes_cli.setupr r rhermes_cli.configr )rrrnpm_binnpx_binrrcrrrexclocal_ab local_ab_winr_bttailline camofox_dir_npm_bin wheel_urlrrr oauth_logged_inexisting_api_keyr r  _setup_promptr idxapi_keys rK_run_post_setupr/sMMM999#n4F &,u%%&,u%%""$$   R S S S     $Z^)Z0#$C 4E4EF A%%CDDDD@@@@@@L_L_LaLaAAA=H F)<)<)>)>tt)D F FGGG$$&&  s t t t F _ , , F              H3HH I I I FFFFF      C D D D F      G    H    L    F  f    FKLLL .069OK <7 " "#//77L""$$ ('   LS]]I} 5 54)]K   S#Z^#$C 4E4EsF A%%788810000015..=>>> <<"CCEEPPRRSUSVSVW 77D 5dsd 5 56666UVVVVV /.( S S S D E E E Q R R R R R R S S S @3@@ A A A Q R R R R R R R R R S 9 $ $"^3h>ARR 6<&&!!##   C D D D q r r r      'y*I ,0BDL)) $))"#:;;;;"=   CcCCDDDJ       e 7 8 8 8 : ; ; ; p q q q q qe$$ e O P P P c d d d d d e e < ' '5)))))) ; & &  { # # # ? @ @ @ F    D LMMM 5  X!4K"KUXYYYF A%%8999\]]]mnnnn>???Jfm&9r%@%@%B%B4C4%HJJKKKZIZZZ[[[[[ on ( X X X D E E E V VVV W W W W W W X 7 " "  w    ? @ @ @ @    c d d d %&D&D&DcRRR$))"#<===="#BCCC N&-*=2)D)D)F)Ftt)L N NOOO OPPPFF > ,   HIIIKLLL  >=   [\\\klll[\\\\\ 6 ! !  v    : ; ; ; ;    L M M M %&?&?&?MMM$))"#78888"#=>>> N&-*=2)D)D)F)Ftt)L N NOOO JKKKFF 9 ,   CDDDFGGG  98   [\\\UVVVVV 9 $ $ *)))))  = = = = = = =    DsDD E E E ? @ @ @ FFFFF  3444 A ! !//T $###    6 7 7 7 7 7 > > > G#GG H H H < = = = = = = = = = A A A === > > > ? @ @ @ @ @ @ @ @ @ A : % % $ A A A A A A"#<#<#>#>#B#B;#O#OPPOO $ $ $#OOO $(77   [    F   G H H H F<===            9 8 8 8 8 8 8    EEE F F F Y Z Z Z FFFFF  m 6     !88..00 L;AXX#m$5EEEG }g666677777S X Y Y Y Y YC & %sI,D55 E?EECL(M> M>!M99M>!AP66 Q+!Q&&Q+T## T0/T0B#W,,,XX'Y\ A?[#"\#(\ \\\\]//`? A?`  `? (`94`?8`99`?>`?/a66 b,!b''b,?(c)) e3!d e'!ee0f ff&g77 h-!h((h-ctdg}tdr|dtdr|dtdr|dtdr|d td r|d |S) zBReturn platform keys that are configured (have tokens or are CLI).cliTELEGRAM_BOT_TOKENtelegramDISCORD_BOT_TOKENr7SLACK_BOT_TOKENslackWHATSAPP_ENABLEDwhatsapp QQ_APP_IDqqbot)r rb)enableds rK_get_enabled_platformsr<sgG)**#z"""())"y!!!&'' w'((#z"""[!! w NrSconfig platformscZ|t}i}|D]}t||||<|S)zReturn a summary of enabled toolsets per platform. When ``platforms`` is None, this uses ``_get_enabled_platforms`` to auto-detect platforms. Tests can pass an explicit list to avoid relying on environment variables. )r<_get_platform_tools)r=r>summarypkeys rK_platform_toolset_summaryrCsC*,, #%G::+FD99 NrSrc||St|tr|St|tr|dkSt|tr2|}|dvrdS|dvrdS|S)z=Parse bool-like config values used by tool/platform settings.Nr>1onyestrueT>0noofffalseF) isinstancerFintrDrEr)valuerlowereds rK_parse_enabled_flagrQ s }% %z%++--%%'' 0 0 04 1 1 15 NrSinclude_default_mcp_serversrSc8 &'(ddlm}m}|dpi}|}|t |t s-t }|r |d}nd}|g}d|D}dtD&t(d t D't&fd |D} | r0&fd |D} t} |D].} | &vs| (vr | |vr| || /| rt} tD][\}}}t|st||}|r*|| r| |\tt }|vrt"vr|d |vr)t'jd r|d | |z} | | z} nZt}|D] } | || !t} tD][\}}}t|st||}|r*||r| |\tdo t+}|r| dtt }|vrt"vr|d |vr)t'jd r|d |rd|vr|d| |z} t }|r|dnd}t||}t}&D] }| ||!t}| D] }| ||!&(z'z}|d|Dz}|tt hz z}|D]\}}||vr |dr t||}|r||sP||rf||s*| || |(r{|di}t|g}(D]?}||vr| ||t vr&||vr| |@&'(fd|D}|dpi} d| D}!d|vr+t}"| ||!z dhz n||!z}"| ||!z |r2|"sd|vr| |"n+| |!n| |"|dpi}#|#dpg}$|$rd|$D}%| |%z} | S)zBResolve which individual toolset names are enabled for a platform.r)resolve_toolsetTOOLSETSplatform_toolsetsNrohermes-c,g|]}t|SrVrDrXtss rK z'_get_platform_tools..3s555SWW555rSch|]\}}}| SrVrVrWs rKrZz&_get_platform_tools..5JJJLFAqJJJrSch|] }|d SrorVrXps rKrZz&_get_platform_tools..7NNNaQ01NNNrSc3 K|]}|vV dSNrV)rXr\configurable_keyss rK z&_get_platform_tools..>s)NN"b$55NNNNNNrSc<h|]}|vt||SrVrR)rXr\rgrOs rKrZz&_get_platform_tools..As?   &&&+HX+V+V& &&&rSr5rr&c<h|]}|d|S)rX) startswith)rXrps rKrZz&_get_platform_tools..s) < < <1ALL$;$; .sH  & & & n $ $ + + +  , + +rS mcp_serversch|]N\}}t|tt|ddd?t |OS)r;Tr)rMdictrQrIrD)rXrw server_cfgs rKrZz&_get_platform_tools..sg D* j$ ' ' y$ ? ? N N N  D rSno_mcpagentdisabled_toolsetsc,h|]}t|SrVrZr[s rKrZz&_get_platform_tools..s<<32222222 #677=2%))(33MJ}d$C$CMM(++  ."#45JJ.8--J# 65}555MJJ4IJJJ-//NNN9;K;K;M;MNNNNNNN NNNNN[(     &   %%$ = =G+++w./H/Hh&&  " "??7#;#; < < < <  )uuH 5 ) ) 14VXFFv6677) 1 1/ B B)LL(((344K;&&8;Y+Y+Y""8,,,+--")L2I2I-""?333  #H  ( $ < %>   z * * *K'x((J3=W*.//CWXCWCWK !=!=>>!$??"))//"*=*=>>>>eeG"00v..//// ~ -0E ED < < < < <>  ::j ! !  v..// x001GHH     7 8 8    )) %   ( ( ( NN8 $ $ $ *JJ6;;  x!.s9 (X 6 6 rSch|]\}}}| SrVrVrWs rKrZz'_save_platform_tools..r_rSch|] }|d SrarVrbs rKrZz'_save_platform_tools..rdrSrtc,g|]}t|SrVrZr[s rKr]z(_save_platform_tools.."s===RR===rSc$h|] }|v|v | SrVrV)rXrergrps rKrZz'_save_platform_tools..&s: ) ) )e;P.P.P .P.P.PrSrwrnN) setdefaultr_rjrkr|rrMr^discardsortedr )r=rOr plugin_keysexisting_toolsetspreserved_entriesrgrps ` @@rK_save_platform_toolsrs  )2... ) KJ4IJJJ*,,K$ ON9;K;K;M;MNNN (;XrRRR ' . .==+<===,h'''-33GJ[3[,\,\F )H126664:;4G4G&'1rSc@|t}|dkr* ddlm}|\}}}|duS#t$rYdSwxYw|dvr;t |}|j|}|r|js|jrdSt|}|rLt||D]9} | dg} | sdStd | DrdS:dSt|g} | sdStd | DS) z6Check if a toolset's required API keys are configured.Nr r)resolve_vision_provider_clientF>r)rrr#Trzc3@K|]}t|dVdSrNr>)rXrs rKrhz$_toolset_has_keys..Ws.==q=5**======rSc3:K|]\}}t|VdSrfr>)rXvarrYs rKrhz$_toolset_has_keys.._s.==fc1}S!!======rS) r agent.auxiliary_clientrrBrfeaturesrI availablemanaged_by_nousTOOL_CATEGORIES_visible_providersallTOOLSET_ENV_REQUIREMENTS) rNr=r _providerclient_modelrfeaturecatproviderrz requirementss rK_toolset_has_keysr<s ~   M M M M M M(F(F(H(H %Ivv% %   55 7771&99#''//  ) W-D 4   f % %C *377  H||J33H tt==H===== tt u,//;;L t == === = ==s 0 >>questionrc,ddlm}|||||S)z?Single-select menu (arrow keys). Delegates to curses_radiolist.r)curses_radiolist)selectedcancel_returns)hermes_cli.curses_uir)rrrrs rK_prompt_choicerds/555555  HgPW X X XXrS_tool_token_cachec"ttS ddl}|d}n3#t$r&tdiatcYSwxYw ddl}ddlm}n3#t$r&tdiatcYSwxYwi}| D]U}| |}|r.Eq!Q (H 5 5 Aq rSr@z [no API key] ()c*h|]\}\}}}|v |SrVrV)rXirNrYr;s rKrZz,_prompt_toolset_checklist..s8a&!Q W     rSNcg|]\}}}| SrVrVrWs rKr]z-_prompt_toolset_checklist..s888lfa6888rSchosenr;ct}|D]&}||'tfd|D}|dkr d|dz ddSd|dS)Nc3DK|]}|dVdS)rNrI)rXrw tool_tokenss rKrhz?_prompt_toolset_checklist..status_fn..s1GGT a00GGGGGGrSizEst. tool context: ~z.1fzk tokensz tokens)rir~sum)r all_toolsr-totalrUrts_keyss rK status_fnz,_prompt_toolset_checklist..status_fns UUI @ @  !>!>????GGGGYGGGGGE}}HedlHHHHH8%888 8rSz Tools for )rrc,h|]}|dSrrV)rXr effectives rKrZz,_prompt_toolset_checklist..s! , , ,IaLO , , ,rS)rrr{rUrrfrrrIrrb enumeraterirD)rr;rOr effective_alllabelsrNts_labelts_descsuffix pre_selectedrrrrUrrs `` @@@@rK_prompt_toolset_checklistrs555555((((((())K8::M#0I F%.::!' (( &o.A.A&.I.I &MeMiMijpMqMq &%F 88g88889999#,Y#7#7L I 988i888 9c 9c 9 9 9 9 9 9 9 9 %^%%# F - , , ,V , , ,,rSct|}|rt|||dSt|dS)zConfigure a toolset - provider selection + API keys. Uses TOOL_CATEGORIES for provider-aware config, falls back to simple env var prompts for toolsets not in TOOL_CATEGORIES. N)rrI_configure_tool_category_configure_simple_requirements)rNr=rs rK_configure_toolsetrsM   f % %C / f55555 'v.....rScN ddlm}ddlm}||}n#t$rgcYSwxYwg}|D]}t |dddkr |}n#t$rY:wxYwt|tsT| d|j | dd| d d| d g|j d }| d r |d |d <| ||S) uVBuild picker-row dicts from plugin-registered image gen providers. Each returned dict looks like a regular ``TOOL_CATEGORIES`` provider row but carries an ``image_gen_plugin_name`` marker so downstream code (config writing, model picker) knows to route through the plugin registry instead of the in-tree FAL backend. FAL is skipped — it's already exposed by the hardcoded ``TOOL_CATEGORIES["image_gen"]`` entries. When FAL gets ported to a plugin in a follow-up PR, the hardcoded entries go away and this function surfaces it alongside OpenAI automatically. rlist_providers_ensure_plugins_discoveredrwNrrxr@ryrz)rwrxryrzimage_gen_plugin_namer) agent.image_gen_registryr r`r rBgetattrget_setup_schemarMrurI display_namerwrbr r rrowsrrrows rK_plugin_image_gen_providersrs;;;;;;AAAAAA""$$$"N$$  D 8VT * *e 3 3  ..00FF    H &$''  JJvx'<==ZZ,,::eR(( :r22%-]    ::l # # 5 &| 4C  C Ks # 22A'' A43A4c" ddlm}ddlm}||}n#t$rgcYSwxYwg}|D]} |}n#t$rY$wxYwt |ts>|d|j |dd|dd|dg|j d }|d r |d |d <| ||S) u`Build picker-row dicts from plugin-registered video gen providers. Mirrors ``_plugin_image_gen_providers`` exactly — every video backend is a plugin, so this function is the *only* source of provider rows for the Video Generation category. The hardcoded ``TOOL_CATEGORIES`` entry for ``video_gen`` keeps an empty providers list. rr r rwrxr@ryrz)rwrxryrzvideo_gen_plugin_namer) agent.video_gen_registryr r`r rBrrMrurIrrwrbrs rK_plugin_video_gen_providersr sg;;;;;;AAAAAA""$$$"N$$  D ..00FF    H &$''  JJvx'<==ZZ,,::eR(( :r22%-]    ::l # # 5 &| 4C  C Ks # 22A AAcB ddlm}ddlm}||}n#t$rgcYSwxYwg}|D]}t |dd}|s |}n#t$rY8wxYwt|tsR| d|j | dd| dd| d g||d }| d r |d |d <| ||S) a\Build picker-row dicts from plugin-registered web search providers. Each returned dict is a regular ``TOOL_CATEGORIES`` provider row. It populates both ``web_backend`` (legacy field consumed by setup + selection helpers) and ``web_search_plugin_name`` (informational marker) so the picker behaves identically whether a provider is hardcoded or plugin-registered. After PR #25182, all seven web providers (brave-free, ddgs, searxng, exa, parallel, tavily, firecrawl) are plugins; this helper is the sole source of provider rows for the Web Search & Extract category. rr r rwNrxr@ryrz)rwrxryrzrweb_search_plugin_namer) agent.web_search_registryr r`r rBrrrMrurIrrb)_list_web_providersr rrrrwrrs rK_plugin_web_search_providersr=sSSSSSSAAAAAA""$$$''))  Dx..   ..00FF    H &$''  JJvx'<==ZZ,,::eR(( :r22&*    ::l # # 5 &| 4C  C K # 22A%% A21A2cB ddlm}ddlm}||}n#t$rgcYSwxYwg}|D]}t |dd}|s |}n#t$rY8wxYwt|tsR| d|j | dd| dd| d g||d }| d r |d |d <| ||S) a1Build picker-row dicts from plugin-registered cloud browser providers. Each returned dict mirrors the legacy ``TOOL_CATEGORIES["browser"]`` schema (``name`` / ``badge`` / ``tag`` / ``env_vars`` / ``browser_provider`` / ``post_setup``) so the picker behaves identically whether a provider was hardcoded or plugin-registered. Populates ``browser_provider`` (the legacy config key written to ``browser.cloud_provider``) and a ``browser_plugin_name`` marker so setup / write paths can route through the registry when they want to. rr r rwNrxr@ryrz)rwrxryrzrbrowser_plugin_namer) agent.browser_registryr r`r rBrrrMrurIrrb)_list_browser_providersr rrrrwrrs rK_plugin_browser_providersr$usTTTTTTAAAAAA""$$$++--  Dx..   ..00FF    H &$''  JJvx'<==ZZ,,::eR(( :r22 $#'    ::l # # 5 &| 4C  C Krrct|}g}|dgD]X}|drts&|dr|jsC||Y|ddkr!|t |ddkr!|t|ddkr!|t|ddkr!|t|S) zBReturn provider entries visible for the current auth/config state.rr}r|rwrrrr) rrIrnous_auth_presentrbextendrrrr$)rr=rvisiblers rKrrsW-f55HGGGK,,!! <<. / / 8R8T8T   <<, - - h6P  x     wwv,,,244555 wwv,,,244555 wwv000355666 wwv...022333 NrScDttjdS)Nr)rFrrrVrSrKr*s$v|L99::rS_POST_SETUP_INSTALLEDct|}|dS t|S#t$rYdSwxYw)zAReturn True when the post_setup install side-effect is satisfied.NT)r+rIrFrB)r predicates rK_post_setup_already_installedr.s]%)).99ItIIKK   tts7 AAct|}|st|| St||D]+}|d}|rt |sdS,|dkr0|di}t |t  pd|vS|dkr0|di}t |t  pd|vS|dkr0|di}t |t  pd|vS|d krotrd S d d lm }d d l m } | |D]*} | rd S#t$rY'wxYwn#t$rYnwxYwdS|dkr_ d d lm }d d l m } | |D]*} | rd S#t$rY'wxYwn#t$rYnwxYwdSt|| S)zBReturn True when enabling this toolset should open provider setup.rTr)rrbackendrcloud_providerr#Frr r r%)rrIrrr.rMrurrr r`r  is_availablerBr) rNr=rrrtts_cfgweb_cfg browser_cfgr r s rK#_toolset_needs_configuration_promptr6s   f % %C 5$VV4444 'sF33\\,//  ;JGG 44 **UB''gt,,,I '0II **UB''gt,,,H 0HH jjB// k4000W4DK4WW  ! " " 5  ? ? ? ? ? ? E E E E E E & & ( ( (*N,,  ,,..%$uu% H       D t   ? ? ? ? ? ? E E E E E E & & ( ( (*N,,  ,,..%$uu% H       D t 00 00sx#"E/EE/E/ E+(E/*E++E// E<;E<"G+G?GG G GGG G! G!c |dd}|d}t||}|dr|d}tj|krht t d|d|dd|d d tjjdtjjd td d St|d kr|d}t t td|d|d|ddtj |drtd|d|drtd|dt||d St |dd}t td|d|d|dtj |drtd|dt g} |D]} | dr d| ddnd} | dr d| dnd} d} | dg}|rtd|Drt| |rd} n|sd} nd} | | d| | | | d t#||}t%d|d!| |}|t|krtd"|d St|||d S)#z2Configure a tool category with provider selection.rr@rwrequires_python z requires Python r.rz + (current: rz3 Upgrade Python and reinstall to enable this tool.N ---   () ---ryrrzChoose a providerz - z ---rx [] — rzc3@K|]}t|dVdSrr>rXvs rKrhz+_configure_tool_category..V."M"Mq=5#:#:"M"M"M"M"M"MrS [active] [configured]u(Skip — keep defaults / configure later:z Skipped )rIrr version_infoprint _print_errormajorminorrrrr CYAN_configure_providerr_is_provider_activerb_detect_active_provider_indexr)rNrr=rrwrreqrtitleprovider_choicesrcrxry configuredrz default_idx provider_idxs rKrr+s 7762  D v;D"3//I ww !!#$  c ! ! GGG EdEESVEEc!fEERURbRhEEknk{lBEEE F F F M N N N F 9~~Q<  eCTCCDCCHV,<CCCV[QQRRR <<   0 .Xe_.. / / / 77<  2 0S.00 1 1 1Hf-----  ':;; e8T88D88U888&+FFGGG 77<  2 0S.00 1 1 1  L LA*+%%..@&7&&&&bE()e <$!E($$$"CJuuZ,,H 1s"M"MH"M"M"MMM 1&q&111!,JJ!1!#JJ!0J  # #qy$J%$J$Jj$J$J K K K K  JKKK4IvFF %m5mmm5E{SS  3y>> ) ) +T++ , , , FIl3V<<<<Check if a provider entry matches the currently active config.r r#rrr%r}NF>Nr@r use_gatewayrtr{r)rrr1rrr0rr)rIrMrurrrrr) rr= plugin_name image_cfgvideo_plugin_name video_cfgmanaged_featurerrconfigured_providercurrents rKrPrPos,,677KXJJ{B// )T**Wy}}Z/H/HK/WW %<==^JJ{B// )T**]y}}Z/H/HL]/]]ll#9::O'1&99#''88 ?5 k ) ) ;33I)T** !&/mmJ&?&?#&.??? 5==//;OT]TaTaboTpTpzEAEAEA; 5* * << ' ' 'SFE:66(>:RR   ) )fi1ABBG*Vx8J/Kw/V V << & & RfeY77G*Qw(=:Q/Q Q&&||N##Nvuj11Xn5MMMX%%&)-=>>*+w66||M""2&%33(=111||&''  JJ{B// )T** 5'mmJ77 ' (E 1 Q#'88 Q#IMM-$@$@%PPPP 5rSrct|D]N\}}t||r|cS|dg}|rtd|Dr|cSOdS)z8Return the index of the currently active provider, or 0.rzc3@K|]}t|dVdSrr>rCs rKrhz0_detect_active_provider_index..s.FFM!E(33FFFFFFrSr)rrPrIr)rr=rrcrzs rKrQrQs)$$1 q& ) ) HHH55R((  FFXFFFFF HHH 1rScddlm}m}||fS)z5Lazy-load the FAL model catalog from the tool module.r FAL_MODELS DEFAULT_MODEL)tools.image_generation_toolrerfrds rK_fal_model_catalogrhs%EEEEEEEE } $$rS)display config_key catalog_fnmodel_idmetawidthsc |d|dd|ddd|dd|ddd|dd|ddS)zIFormat a single picker row with column-aligned speed / strengths / price.<modelr9speedr@ strengthspricer)rlrmrns rK_format_imagegen_model_rowrus  #fWo #* # # 88GR  ##)'? #7 # # 88K $ $ #'-k': #? # # 88GR  # #rS backend_namec t|}|sdS|d\}sdS|d}||i}t|tsi}|||<|dp|vr|t }gfd|Dz}td|Dtfd|Dd tfd |Dd d }td dd|dd dd|dd dd|dd} tt| tj g} |D]9} t| | |} | kr| dz } | | :td|dd| d } || }||d<td|dS)uPrompt the user to pick a model for the given imagegen backend. Writes selection to ``config[backend_config_key]["model"]``. Safe to call even when stdin is not a TTY — curses_radiolist falls back to keeping the current selection. Nrkrjrqc g|] }|k| SrVrVrXm current_models rKr]z-_configure_imagegen_model..# L L Lqm9K9K9K9K9KrSc34K|]}t|VdSrfrrXrzs rKrhz,_configure_imagegen_model..(//SVV//////rSc3jK|]-}t|ddV.dSrrr@NrrIrXrzcatalogs rKrhz,_configure_imagegen_model..=JJ1c'!*.."5566JJJJJJrSrtc3jK|]-}t|ddV.dSrsr@Nrrs rKrhz,_configure_imagegen_model..=RR1#gajnn["==>>RRRRRRrSrrqrrrsr9ModelrpSpeedrr Strengthsrs Price ← currently in use Choose ri model: Model set to: )IMAGEGEN_BACKENDSrIrrMrur^keysmaxrJrr rNrurbrr)rvr=r0 default_modelcfg_keycur_cfg model_idsorderedrnheaderrmidrr-rrr{s @@rK_configure_imagegen_modelrs ##L11G 2W\244G] l#G,,G gt $ $"!wKK((9MMG##% W\\^^$$Io L L L LI L L LLG//Y/////JJJJ JJJTUVVVRRRR RRR\]^^^F  GGG W vg +    G_ )     , 1     % $ $%%% D(gclFCC -   + +C C /GI&///    C S\FGG.f../////rSrZc ddlm}ddlm}|||}n#t$ridfcYSwxYw|idfS |pg}|}n#t$ridfcYSwxYwd|D}||fS)uaReturn ``(catalog_dict, default_model_id)`` for a plugin provider. ``catalog_dict`` is shaped like the legacy ``FAL_MODELS`` table — ``{model_id: {"display", "speed", "strengths", "price", ...}}`` — so the existing picker code paths work without change. Returns ``({}, None)`` if the provider isn't registered or has no models. r get_providerr NcRi|]$}t|td|v|d|%SidrMrurs rKrrz-_plugin_image_gen_catalog..32OOOaZ4-@-@OTQYYqwYYYrS)rrr`r rB list_modelsrrZrr rmodelsrrs rK_plugin_image_gen_catalogrs999999AAAAAA""$$$< ,, 4x4x%%''-2((** 4xOO6OOOG G !$55*A**A;:A;c  t|\ } sdS|di}t|tsi}||d<|dp| vr|t }gfd|Dz}td|Dt fd|Ddt fd |Dd d }td d d|dd dd|dd dd|dd}tt|tj g}|D]9} t| | |} | kr| dz } | | :td|d|d } || } | |d<td| dS)zPrompt the user to pick a model for a plugin-registered backend. Writes selection to ``image_gen.model``. Mirrors :func:`_configure_imagegen_model` but sources its catalog from the plugin registry instead of :data:`IMAGEGEN_BACKENDS`. Nr#rqc g|] }|k| SrVrVrys rKr]z8_configure_imagegen_model_for_plugin..Kr|rSc34K|]}t|VdSrfr~rs rKrhz7_configure_imagegen_model_for_plugin..NrrSc3jK|]-}t|ddV.dSrrrs rKrhz7_configure_imagegen_model_for_plugin..OrrSrrtc3jK|]-}t|ddV.dSrrrs rKrhz7_configure_imagegen_model_for_plugin..PrrSrrr9rrprrrrrsrrrrr)rrrMrurIr^rrrJrr rNrurbrr)rZr=rrrrrnrrrrr-rrr{s @@rK$_configure_imagegen_model_for_pluginr7sq7{CCG]  R00G gt $ $&%{KK((9MMG##% W\\^^$$Io L L L LI L L LLG//Y/////JJJJ JJJTUVVVRRRR RRR\]^^^F  GGG W vg +    G_ )     , 1     % $ $%%% D(gclFCC -   + +C C (K(((    C S\FGG.f../////rSc|di}t|tsi}||d<||d<d|d<td|t ||dS)z.rrS)rrr`r rBrrrs rK_plugin_video_gen_catalogr}s 999999AAAAAA""$$$< ,, 4x4x%%''-2((** 4xOO6OOOG G rc 6t|\}sdS|di}t|tsi}||d<|dp|vr|t }gfd|Dz}td|Dtfd|Ddtfd |Dd d }td d d|dd dd|dd dd|dd}tt|tj g}|D]} | } d | d|dd | ddd|dd | ddd|dd | dd} | kr| dz } | | td|d|d } || } | |d<td| dS)zPrompt for a video gen model from a plugin's catalog. Mirrors :func:`_configure_imagegen_model_for_plugin`. Writes the selection to ``video_gen.model``. Nr%rqc g|] }|k| SrVrVrys rKr]z8_configure_videogen_model_for_plugin..r|rSc34K|]}t|VdSrfr~rs rKrhz7_configure_videogen_model_for_plugin..rrSc3jK|]-}t|ddV.dSrrrs rKrhz7_configure_videogen_model_for_plugin..rrSrrtc3jK|]-}t|ddV.dSrrrs rKrhz7_configure_videogen_model_for_plugin..rrSrrr9rrprrrrrsrr@rtrrrr)rrrMrurIr^rrrJrr rNrbrr)rZr=rrrrrnrrrrmrr-rrr{s @@rK$_configure_videogen_model_for_pluginrs  7{CCG]  R00G gt $ $&%{KK((9MMG##% W\\^^$$Io L L L LI L L LLG//Y/////JJJJ JJJTUVVVRRRR RRR\]^^^F  GGG W vg +    G_ )     , 1     % $ $%%% D  s| ' 'vg ' + ' 'xx$$ ''-g ' ; ' 'xx R(( '+1++> ' C ' 'xx$$ ' ' -   + +C C (K(((    C S\FGG.f../////rSc|di}t|tsi}||d<||d<d|d<td|t ||dS)zr)rrTrFrr9rw - no configuration needed!B Requests for this tool will be billed to your Nous subscription.r rrr#>Nr@rrrz: already configuredrr@ Get yours at: rrrr Saved Skippedz configured!)rIrr&rrrFrrrrMrur/rrrrr _promptr )rr=rzr^rr3bpr5r4cat_keyrsectionrZ video_pluginr0rall_configuredrexistingr default_valrOs rKrOrOs;||J++Hll#9::O||())1&99)  b c c c F||N##7##E2..&~6 !%o!6!6 X%% ( )'' 266 ==,3K( ) 8 9 9 9 9  E,.K( ) CrCC D D D%)/%:%: M"||M""K##E2..%m4 !%o!6!6 I0GIIJJJ ?2KKK@D/2..}== ,1133  LGS377;3333 **W--gt,,3]1K1K3-2GM* 4  << % % 4 H\2 3 3 3IHV,IIIJJJ  ^ \ ] ] ]ll#:;;   -k6 B B B F ||$;<<   -lF C C C F,,122  , %gv 6 6 6'' R88G'4(( ,W[[-D-DL]-]-]&+ #N'' U,,  ' @E @@@ A A A A''%$$C 64s44555'')R00K W FswwxU'D'D F F TT FswwxU'D'D F FQUVVV 's5z5111{++++}---!&||L!!0n0.///,:HV,:::;;;ll#:;;   -k6 B B B F||$;<<   -lF C C C F,,122  , %gv 6 6 6'' R88G'4(( ,W[[-D-DL]-]-]&+ ###!,, , , , ,-]-]rScdkrtdrdStttdtjgd}t d|d}|dkrzt dtd d }|rG|r3td |td ntdn |dkrtdpd}t|dk}|rdnd}t|d }|r|rtd|t}|didi} || d<t||rtddtd ntddSt g} | sdSd| D} | sdSt%fdt'D} tttd| dtj| D]\} }|rt d|td| d }|rF|r2t| |td utddS) zMSimple fallback for toolsets that just need env vars (no provider selection).r Nz8 Vision / Image Analysis requires a multimodal backend:)uOpenRouter — uses GeminiuBOpenAI-compatible endpoint — base URL, API key, and vision modelSkipz Configure vision backendrz( Get key at: https://openrouter.ai/keysz OPENROUTER_API_KEYTrrrrrz& OPENAI_BASE_URL (blank for OpenAI)zhttps://api.openai.com/v1zapi.openai.comz OPENAI_API_KEYz API keyrv auxiliarybase_urlAUXILIARY_VISION_MODELz gpt-4o-minic:g|]\}}t|||fSrVr>)rXrrs rKr]z2_configure_simple_requirements.. s-QQQhc3mC>P>PQSzQQQrSc30K|]\}}}|k |VdSrfrVrXrprrYrNs rKrhz1_configure_simple_requirements.. 5\\71aPQU[P[P[QP[P[P[P[\\rSr9z requires configuration: Get key at: r)rrJrr YELLOWrrrrEr rrrr rr rrInextrf)rNrr-rOris_native_openai key_labelr._cfg_auxrmissingrrrs` rKrr_ s>  X & &  F  eNPVP]^^___    97AFF !88 B C C C4tDDDE . .3U[[]]CCC{++++}---- AXXGHHNNPPoToH0::>NN 0@S,,mIi$777G .7==?? ./AAA"}}{B77BB8RPP#+Z D!!!#L"#;]KKK{++++}---+//;;L QQ,QQQG \\\\&J&L&L\\\^deeH GGG %7X777 G GHHH**S  0 ... / / / s t444  *U[[]] * 3 . . . ; ' ' ' ' = ) ) ) )**rScg}tD]u\}}}t|}t|}|s|r7t ||st ||r|||fv|stddSd|D}|dtd|t|dz }|t|krdS||\}}t|}|rt|||nt|t|dS)z. s222Eu222rSCancelz+ Which tool would you like to reconfigure?r) rfrrIrr _toolset_enabled_for_reconfigurerbrrr%_configure_tool_category_for_reconfig _reconfigure_simple_requirementsr ) r= configurablerNrrYrreqsrr-s rK_reconfigure_toolr svLCEE88!!!&))'++F33  8$ 8 00 84TU[]c4d4d 8##VX$6777 9:::22\222G NN8 FQTU\Q]Q]`aQa b bC c,#C(FH   f % %C 1-fc6BBBB(000rSctD]>}t||s t||d}n#t$rY3wxYw||vrdS?dS)zReturn True if a configurable toolset is enabled anywhere. Reconfigure must include enabled-but-unconfigured categories so users can finish provider/API-key setup without disabling and re-enabling the toolset. FrRT)rkrRr@rB)rNr=rOr;s rKrr s   ,VX>>   ),1GG     H  W  44  5s / <<c |dd}|d}t||}t|dkr_|d}ttt d|d|d|dd t jt||dSttt d|d|d t jtg}|D]}|d r d |d d nd} |dr d|dnd} d} |dg} | rtd| Drt||rd} n| sd} nd} | |d| | | t||} td|| }t|||dS)zBReconfigure a tool category - provider selection + API key update.rr@rwrrr;r<r=r>z - Choose a provider ---rxr?r@ryrArzc3@K|]}t|dVdSrr>rCs rKrhz8_configure_tool_category_for_reconfig.. rErSrFrGz Select provider:N) rIrrrJrr rN_reconfigure_providerrrPrbrQr)rNrr=rrwrrrTrcrxryrUrzrVrWs rKrr s 7762  D v;D"3//I 9~~Q<  eCTCCDCCHV,<CCCV[QQRRRh/////  eBTBBDBBBFKPPQQQ  L LA*+%%..@&7&&&&bE()e <$!E($$$"CJuuZ,,H 1s"M"MH"M"M"MMM 1&q&111!,JJ!1!#JJ!0J  # #qy$J%$J$Jj$J$J K K K K3IvFF %&:>>>>rSc  |dg}|d}|dr't|}|jstddS|drK|di}|d|d<t ||d <t d |dd |vrd|d }|d i}|d krd |d<t dn|r||d<t d|t ||d <|drK|di}|d|d<t ||d <t d|d|r<|dvr8||i} t| tsi} | ||<d| d <n|s}t D]c\} } || dgvrF|| } t| tr| d rd| d <nd|s |drt|dt d|dd|rtd|d} | rt| |dS|d} | rt| |dS|d }|rKt|||d!kr5|d"i}t|tr d!|d<d|d <dS|D] }t!|d#}|r$td|d#d$|dd%d&|d'd(}|rtd)||d*d(}t#d+|d,|d#d-| .}|rL|r8t'|d#|t d/td0 |drt|d|d} | rt| |dS|d} | rt| |dS|d }|rMt|||d!kr9|d"i}t|trd!|d<d|d <dSdSdSdS)1z)Reconfigure a provider - update API keys.rzr}r|rNr{r)rrYz TTS provider set to: rrrr1rrrrr0r>r)rrTrFrr9rwrrr rrrr#r: configured (...)rr@rrrr (Enter to keep current)r Updated Kept current)rIrr&rrrFrrMrurrr/rrrrr rrEr )rr=rzr^rr3rr5r4rrrrZrr0rrrrrrOs rKrr s ||J++Hll#9::O||())1&99)  b c c c F||N##M##E2..&~6 !%o!6!6 K.1IKKLLLX%% ( )'' 266 ==,3K( ) 8 9 9 9 9  E,.K( ) CrCC D D D%)/%:%: M"||M""K##E2..%m4 !%o!6!6 I0GIIJJJ ?2KKK##OR88'4(( .G&-F? #!%  +1133  LGS377;3333 **W--gt,,3]1K1K3-2GM* 4  << % % 4 H\2 3 3 3IHV,IIIJJJ  ^ \ ] ] ]ll#:;;   -k6 B B B F||$;<<   -lF C C C F,,122  3 %gv 6 6 6% ++K<<gt,,3*/GJ'-2GM* , , U,,  K ISZIIx|III J J JggeR    2 0300 1 1 1ggi,, VswwxU<<VVVepapqqq  ,U[[]] , 3u:u{{}} 5 5 5 = ) ) ) ) * + + + +||L!!0.///,,677K)+v>>><< 788L),???ll-..G/!'6222 e  '' R88G'4(( /&+ #). &&& //   / /rSc vtg}|sdStfdtD}t t t d|dt j|D]\}}t|}|rtd|d|ddd|rtd|td |d d }|rF| r2t|| td tddS)z(Reconfigure simple env var requirements.Nc30K|]\}}}|k |VdSrfrVrs rKrhz3_reconfigure_simple_requirements..t rrSr9rHrrrrrrTrrr)rrIrrfrJrr rNr rrrEr r)rNrrrrrrOs` rKrrn sl+//;;L \\\\&J&L&L\\\^deeH GGG % X   &+ . ./// , ,S %%  D BSBB! BBB C C C  0 ... / / /tjtt d?tjtdS)@a Entry point for `hermes tools` and `hermes setup tools`. Args: first_install: When True (set by the setup wizard on fresh installs), skip the platform menu, go straight to the CLI checklist, and prompt for API keys on all enabled tools that need them. config: Optional config dict to use. When called from the setup wizard, the wizard passes its own dict so that platform_toolsets are written into it and survive the wizard's final save_config(). NrAFu⚕ Tool Summaryr9rnr/rc30K|]\}}}|k |VdSrfrVrs rKrhz tools_command.. 5!i!i1a]^bh]h]h!]h]h]h]h!i!irSu ✓ z (none enabled)u⚕ Hermes Tool Configurationz' Enable or disable tools per platform.z; Tools that need API keys will be configured when enabled.zM Guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/toolsrRc30K|]\}}}|k |VdSrfrVrXrprrYr\s rKrhz tools_command.. 5!e!e1a]^bd]d]d!]d]d]d]d!e!erSz + c30K|]\}}}|k |VdSrfrVrs rKrhz tools_command.. rrSz - )rc30K|]\}}}|k |VdSrfrVrs rKrhz tools_command.. s.!X!X1aAQWKK!KKKK!X!XrSu ✓ z': using your Nous subscription defaultscg|]<}t|st|r|v:|=SrV)rrIr)rXrNauto_configureds rKr]z!tools_command.. s]!#''//3K3O3OPV3W3W/11111rSz Configuring z tool(s):c30K|]\}}}|k |VdSrfrVrs rKrhz tools_command.. rrSu • z1 You can skip any tool you don't need right now.u ✓ Saved z tool configurationz Configure z enabled)rz Configure all platforms (global)z2Reconfigure an existing tool's provider or API keyrrzConfigure MCP server toolsDonerrTzSelect an option:rtz All platformsrHc30K|]\}}}|k |VdSrfrVrs rKrhz tools_command... 5)m)m1aefjlelel!elelelel)m)mrSz + c30K|]\}}}|k |VdSrfrVrs rKrhz tools_command..1 r rSz - u+ ✓ Saved configuration for all platformsz No changesc30K|]\}}}|k |VdSrfrVrs rKrhz tools_command..T rrSc30K|]\}}}|k |VdSrfrVrs rKrhz tools_command..X rrSz configurationz No changes to rz Tool configuration saved to z /config.yamlz: Changes take effect on next 'hermes' or gateway restart.)(r r<rJrrrfrr rNBOLDrCrkrIriDIMrrGREENr@rrREDrrr_rrrr rbrFrr _configure_mcp_tools_interactiverrr6rrr)$rrr=enabled_platformsrrArBpinfor;countrncurrent_enabledchecklist_preselected new_enabledaddedremoved to_configureplatform_choices platform_keysr`_has_mcp _global_idx _reconfig_idx_mcp_idx _done_idxr- all_currentpkprev pinfo_innerci new_countrrr\rNs$ @@@rK tools_commandr+ s ~.00 GGGtY&&8::;; e& V[AABBB +F4EFF% ? ?DdOEkk$..GLLE %-U7^--v{;;eDZ%DZDZRWDZDZDZ\b\f>g>gg h h h ?$WooCCF !i!i!i!i3W3Y3Y!i!i!ikqrrE% 25 2 2FLAABBBBCe0&*==>>>>  %/fk J JKKK %96: F FGGG %Mvz Z Z[[[ %_agak l lmmm GGG9%6 6 DdOE1&$\abbbO%46K$K !4E'NDY[_``K/1E% 3G ? --??B !e!e!e!e3W3Y3Y!e!e!egijjE%u ==>>>> = //==B !e!e!e!e3W3Y3Y!e!e!egijjE%u ;;<<<<9!,O*++ h$_55hhF !X!X!X!X3H!X!X!XZ`aaE% W W W WY_Yeffgggg %+K%8%8L  7eIS->->III6=YYZZZ*AAF !i!i!i!i3W3Y3Y!i!i!ikqrrE% 25 2 2FJ??@@@@eOQWQ[\\]]]*77F&vv6666 { ; ; ;     %JuW~JJJFLYY Z Z Z GGGGM!##$%fdPUVVVG 8::;; XU7^ X X X X X X XYYYT"""" =A BCCCPQQQFJJ}--..H> <===F###),M(:(:Q(>(>#m$$$BK &&s=/A/AA/E/E!!1MM&.6 !!BHh!5A6Ia]02BANNN )    -   f % % % GGG  (?? ,V 4 4 4 GGG  +  %%K# b b262[`aaaa 3O[QQKk))'BBB.vrW\]]]D'$.E"[0G"+B-KGGe$@W)=$@$@$@&*MMNNN"(--IIB$()m)m)m)m;_;a;a)m)m)moq$r$rE!%(8(8(8&,"G"GHHHH"(//GGB$()m)m)m)m;_;a;a)m)m)moq$r$rE!%(8(8(8&*"E"EFFFF"(--CC+//77C;S;W;WX^;_;_CB66RRC 266 B B B([AAAAF###eI6<XXYYY' 66ppFB #$7`e$f$f$f g gI D F FGGE+o " g8N+o+oS\+o+o_d+o+o+o$R((p eNFJ77888 GGG S!$.fdX]^^^0gPP / ) )/1E% 3G ? --??B !e!e!e!e3W3Y3Y!e!e!egijjE%u ==>>>> = //==B !e!e!e!e3W3Y3Y!e!e!egijjE%u ;;<<<<!-- ; ;#''//;3K3O3OPV3W3W;:66JJ;*66::: { ; ; ;     %EuW~EEEv|TT U U U U %;5>;;VZHH I I I +FDV[\\\]] 8::;; \U7^ \ \ \ \E \ \ \Ca]F GGG444444 %T1D1D1F1FTTTV\V` a abbb %Lfj Y YZZZ GGGGGrSc  ddlm}|dpi}|stddSd|D}|stddSt t t dtjt t d t|d d |tj  dd l m }|n*#t$r}td |Yd}~dSd}~wwxYws t!dtddSfd|D}|r|D]}t!d|dt#dD}t t d|dtdtjt d} D]k\} } | std| d|| i} | dpi} | dpg}| dpg}g}| D]Z\}}t|dkr |dddzn|}|r||d|d E||[t+}d!| Dt-D]R\}}|r||vr||!|r||vr||=||S|d"| dt| d#|||$|krtd| d%fd&t1tD}|| i} | di} |r|| d<| ddn,| dd| ddt}t| |z }t7d| d'|d(|d)d*} m| rFt9|t t t d+tjdSt t d,tj dS)-zProbe MCP servers for available tools and let user toggle them on/off. Connects to each configured MCP server, discovers tools, then shows a per-server curses checklist. Writes changes back as ``tools.exclude`` entries in config.yaml. rrrrzNo MCP servers configured.NcHg|]\}}|dddv| S)r;T>FrIrJrKrLr)rXrprDs rKr]z4_configure_mcp_tools_interactive.. s@a 55D ! !)K K K K K KrSzAll MCP servers are disabled.z' Discovering tools from MCP servers...z Connecting to z server(s): , )probe_mcp_server_toolszFailed to probe MCP servers: z-Could not discover tools from any MCP server.zKCheck that server commands/URLs are correct and dependencies are installed.cg|]}|v| SrVrV)rXn server_toolss rKr]z4_configure_mcp_tools_interactive.. s# @ @ @A!<*?*?a*?*?*?rSz Could not connect to ''c34K|]}t|VdSrfr~)rXtoolss rKrhz3_configure_mcp_tools_interactive.. s(DDUc%jjDDDDDDrSz Found z tool(s) across z server(s)Fr9z: no tools foundr5includeexcludeFz...rrcg|] }|d SrrVrXts rKr]z4_configure_mcp_tools_interactive.. s***qad***rSz MCP Server: z tools))rz : no changesc(g|]}|v|SrVrV)rXrr tool_namess rKr]z4_configure_mcp_tools_interactive.. s#XXXQWz!}rS: z enabled, z disabledTu" ✓ MCP tool configuration savedz No changes to MCP tools)rrrIrrrJrr rrjoinrtools.mcp_toolr/rBrKrrr|rrbrirrarangerpoprr )r=rrr enabled_namesr/r!failedrw total_tools any_changes server_namer5srv_cfg tools_cfg include_list exclude_listr tool_name description desc_shortrr new_exclude enabled_countdisabled_countrr2r=s @@@rKrrx s655555**]++1rK 0111!''))M 3444 GGG %96= I IJJJ %]3}#5#5]]499]C[C[]]_e_i j jkkk999999--// :S::;;; FGGGabbbA @ @ @ @ @ @F ? ? ?D =d=== > > > >DDl.A.A.C.CDDDDDK %U;UUL8I8IUUUW]Wc d deee GGGK*0022CC U  :[::: ; ; ; //+r22KK((.B  }}Y//52  }}Y//52 &+ ) ) "I{585E5E5J5JSbS)E11P[J ) <; > >3u:: > > >  '     \ ! ! 6[666 7 7 7 YXXXXeC OO.D.DXXX ((b99&&w33  +#.Ii MM)T * * * * MM)T * * * MM)T * * *F Um3 R R R R R R R R    >F  e8&,GGHHHHH e/<<=====s(C99 D DD ractionct||d}|dkr|t|z }n|t|z}t|||dS)z/Add or remove built-in toolsets for a platform.FrRdisableN)r@rir)r=rOrrRr;updateds rK_apply_toolset_changerV s`!&(PUVVVG C ...C ...733333rStargetsc t}|dpi}|D]}|dd\} ||vr||5||di}t |dpg}|dkr |vr| n fd|D}||d<|S)zAdd or remove specific MCP tools from a server's exclude list. Returns the set of server names that were not found in config. rrrHrr5r7rTc g|] }|k| SrVrV)rXr;rLs rKr]z%_apply_mcp_change.. s<<.! rrSch|]\}}}| SrVrVrWs rKrZz$_print_tools_list..% sEEE|vq!FEEErSzBuilt-in toolsets (z):u ✓ enabledu ✗ disabledr9c(g|]\}}}|v ||fSrVrV)rXrprrY builtin_keyss rKr]z%_print_tools_list..0 s-OOOAq,9N9Nq!f9N9N9NrSzPlugin toolsets (z MCP servers:r5r7r6z [include only: r.r@z [excluded: zall tools enabledN) rfr_rJrr rrrrrIrr?r)rrrrOrrrNrnrYstatusplugin_entriessrv_namerHrIr7r6rbs ` @rK_print_tools_listrf s8::M#0IFE/DEEEL , , , ,---%CCq  % % 8>BR8R8R% v|444^VZ88  A6AAVAAuUFJ'?'?AABBBBPOOOIOOONG  .(...///+ G GMFE.\ s:::QS\\q\\\rScg|]}d|v| SrirVr:s rKr]z0tools_disable_enable_command..] s2221rSch|]\}}}| SrVrVrWs rKrZz/tools_disable_enable_command.._ sGGGAfGGGrScg|]}|v| SrVrVrXr;valid_toolsetss rKr]z0tools_disable_enable_command..` s#NNNaa~6M6M6M6M6MrSzUnknown toolset 'r3cg|]}|v| SrVrVrms rKr]z0tools_disable_enable_command..d s#MMMn9L9L19L9L9LrSc4g|]}t||SrVrj)rXr;rOs rKr]z0tools_disable_enable_command..g s9,Q99 rSz Toolset 'z ' is not available on platform 'z ' (only: rcg|]}|v| SrVrV)rXr;restricted_targetss rKr]z0tools_disable_enable_command..r s$UUUBT9T9T19T9T9TrSz MCP server 'z' not found in configc^g|])}|vd|vs|ddv'|*S)rHr)rZ)rXr;r[unknown_toolsetss rKr]z0tools_disable_enable_command.. sP $ $ $#Q,,!''#,,q/Q_:_:_ :_:_:_rSrTDisabledEnabledr>) tools_actionrr rkrKr?rfr@rInamesr_rjrrMrirVr]r r)rrRr=rWtoolset_targets mcp_targetsrwrQsrv successfulverbr[rOrrrtrns @@@@@rKtools_disable_enable_commandr~H s=  FtZ//H ]]Fy  T(TTdii >R>RTTUUU -fh\abbb **]339r8 E E EG::':::O22g222KGG1FGGGJbJdJddNNNNN?NNNN$ 6 6D 4T444 5 5 5 5MMMMoMMM"V&  D;??EENOOG 0D00(00))G,,000    VUUUoUUUIfhHHH"uuND*6;GG! D DC BBBB C C C CJ;#y00zzi$99$))J"7"799:::::;;rS)F)rTrf)Tr)r1)NFN)x__doc__jsonrloggingrGrrrpathlibrtypingrrrrrrr r r r hermes_cli.colorsr rhermes_cli.nous_subscriptionrrtools.tool_backend_helpersrrutilsrr getLogger__name__r__file__rresolverhermes_cli.cli_outputrrKrrrrrrrrr_rrFrLrMrD__annotations__rRrfrirjhermes_cli.platformsrk_PLATFORMS_REGISTRYrrrrNrrrr/r<rurCrQr@rrr^rrrrrrrrr$rr+r.r6rrPrQrhrrurrrrrrrrOrrrrrrr+rrVr]rfr~rVrSrKrs     ,,,,,,,,,,,,,+++++++YXXXXXXX44444444  8 $ $tH~~$+3355 VzyyB$BBBBB{[77S#c(] 3 2#2222224#BAAAAA  ,&,..    !,'G (&*(-&>@P%Q  -28 &   %,4@PYAA!)  "K %(   %,0'      '!2;L +   {RRnJJIJ AAA s)AA AAAAHTTTTTTTn$$S$$$RV$$$$NZCZZZZH S      d xS 7J VZ[^`cdg`h[hVi     *)- eee ee"& e  X eeeeP555CPSH5555p#>#>c#>4#>4#>#>#>#>PYYSY4Y#YcYYYY/38DcN+222'tCH~''''T1-1-c1-CH1-PS1-`cdg`h1-1-1-1-l /s /D / / / /+T$Z++++\#T$Z####`-d4j----p,4:,,,,^%D%$%4:%%%%l::t$ # $    =1=1T=1d=1=1=1=1@A=SA=tA=TA=A=A=A=H:$::::::z  T  4  C     2%%% !(  D$3;0C;0;0$;0;0;0;0|3640c40440D40404040n >3 > > > > > >3290c90490D90909090x >3 > > > > > >~,$~,~,~,~,~,B<*3<*<*<*<*~dDS$4,"?#"?D"?$"?"?"?"?Jp/Dp/$p/p/p/p/f,S,,,,4j j Dj $j j j j `}>T}>}>}>}>F4$4#4d3i4Y\4444dT#YC2'U'U'U$'U#'U'U'U'UT=;=;=;=;=;rS