FjddZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z ddlmZddlmZddlmZejeZejd dXd ZGddeZd ZdYdZdddZdZd[dZd\dZd]d Z d^d"Z!d_d%Z"d`d&Z#dad'Z$dbd(Z%dcd)Z&ddd,Z' dedfd/Z(dgd0Z)dgd1Z*dhd3Z+did5Z,dhd6Z-djd8Z.dgd9Z/dgd:Z0dkd;Z1dld=Z2dmd>Z3dnd@Z4dndAZ5dodBZ6dodCZ7dgdDZ8dgdEZ9dpdFZ:dpdGZ;dmdHZdqdLZ?drdMZ@dsdNZAdtdOZBdudQZCdvdRZDdwdUZEdvdVZFdmdWZGdS)xuq``hermes plugins`` CLI subcommand — install, update, remove, and list plugins. Plugins are installed from Git repositories into ``~/.hermes/plugins/``. Supports full URLs and ``owner/repo`` shorthand (resolves to GitHub). After install, if the plugin ships an ``after-install.md`` file it is rendered with Rich Markdown. Otherwise a default confirmation is shown. ) annotationsN)Path)AnyOptional)get_hermes_home)cfg_get)masked_secret_prompt)maxsizereturn Optional[str]c 8tjd}|r|StjdkrBtjdd}tjdd}tjdd}tj|d d d tj|d d d tj|d d d tj|d d d g}|rY|tj|d d d d tj|d d d d fngd}|D]'}|r#tj |r|cS(dS)zResolve a git binary for subprocess use when ``PATH`` may be minimal. Matches other Hermes subprocess resolution: :func:`shutil.which` first, then common Git for Windows install paths and POSIX defaults. gitnt ProgramFileszC:\Program FileszProgramFiles(x86)zC:\Program Files (x86) LOCALAPPDATAGitcmdzgit.exebinPrograms)z /usr/bin/gitz/usr/local/bin/gitz/bin/gitN) shutilwhichosnameenvirongetpathjoinextendisfile)foundprogprog_x86local candidatescs 5/usr/local/lib/hermes-agent/hermes_cli/plugins_cmd.py_resolve_git_executabler)ss L  E   w$z~~n.ABB:>>"57PQQ ~r22 GLLueY 7 7 GLLueY 7 7 GLL5% ; ; GLL5% ; ;      GLL E5)LLGLL E5)LL   HGG   "" HHH 4ceZdZdZdS)PluginOperationErrorzHRecoverable plugin install/update failure (CLI exits; HTTP maps to 4xx).N)__name__ __module__ __qualname____doc__r*r(r,r,?sRRRRr*r,rcVtdz }|dd|S)z9Return the user plugins directory, creating it if needed.pluginsT)parentsexist_ok)rmkdir)r3s r( _plugins_dirr7Is-)+G MM$M... Nr*F allow_subdirrstr plugins_dirr9boolc|std|r&|d}|std|dvrtd|d|rdnd}|D]}||vrtd|d|d ||z }|}||krtd|d  ||n!#t$rtd|d wxYw|S) aValidate a plugin name and return the safe target path inside *plugins_dir*. Raises ``ValueError`` if the name contains path-traversal sequences or would resolve outside the plugins directory. ``allow_subdir=True`` permits a single forward slash inside *name* so category-namespaced plugin keys like ``observability/langfuse`` or ``image_gen/openai`` (the registry keys emitted by ``_discover_all_plugins``) can be looked up. ``..`` and backslash are still rejected, leading and trailing slashes are stripped, and the resolved target must still live inside *plugins_dir*. Install paths leave this at the default ``False`` because a freshly-cloned plugin always lands top-level under ``~/.hermes/plugins//``. zPlugin name must not be empty./>...zInvalid plugin name 'z3': must not reference the plugins directory itself.)\r@)r>rAr@z': must not contain 'z'.z,': resolves to the plugins directory itself.z*': resolves outside the plugins directory.) ValueErrorstripresolve relative_to)rr;r9 bad_charsbadtargetplugins_resolveds r(_sanitize_plugin_namerJPs|( ;9:::?zz# ?=>> > { ]D ] ] ]   !-C 2CIYY $;;WTWWPSWWWXX X D ) ) + +F"**,, !!! VD V V V    +,,,,     TD T T T    Ms ;CC/ identifierc|dr|S|dd}t|dkr|\}}d|d|dSt d|d)uTurn an identifier into a cloneable Git URL. Accepted formats: - Full URL: https://github.com/owner/repo.git - Full URL: git@github.com:owner/repo.git - Full URL: ssh://git@github.com/owner/repo.git - Shorthand: owner/repo → https://github.com/owner/repo.git NOTE: ``http://`` and ``file://`` schemes are accepted but will trigger a security warning at install time. )zhttps://http://zgit@zssh://file://r>zhttps://github.com/.gitzInvalid plugin identifier: 'z)'. Use a Git URL or owner/repo shorthand.) startswithrCsplitlenrB)rKpartsownerrepos r(_resolve_git_urlrWsQRR   S ! ! ' ' , ,E 5zzQ t7U77T7777  1z 1 1 1  r*urlc|d}|dr |dd}|ddd}d|vr6|dddddd}|S)zCExtract the repo name from a Git URL for the plugin directory name.r>rPNr :)rstripendswithrsplit)rXrs r(_repo_name_from_urlr`s ::c??D }}VCRCy ;;sA  r "D d{{{{3""2&--c155b9 Kr* plugin_dirdictc0|dz }|siS ddl}t|d5}||picdddS#1swxYwYdS#t$r(}t d||icYd}~Sd}~wwxYw)z;Read plugin.yaml and return the parsed dict, or empty dict. plugin.yamlrNutf-8encodingz$Failed to read plugin.yaml in %s: %s)existsyamlopen safe_load Exceptionloggerwarning)ra manifest_filerifes r(_read_manifestrrs.M    ! !  -' 2 2 2 +a>>!$$* + + + + + + + + + + + + + + + + + + =z1MMM s@A#A A#AA#AA## B-B BBNonecT|dD]}|j}||z }|so tj|||d|d|jdZ#t$r*}|d|jd|Yd}~d}~wwxYwdS)zCopy any .example files to their real names if they don't already exist. For example, ``config.yaml.example`` becomes ``config.yaml``. Skips files that already exist to avoid overwriting user config on reinstall. z *.examplez[dim] Created z from [/dim]z)[yellow]Warning:[/yellow] Failed to copy : N)globstemrhrcopy2printrOSError)raconsole example_file real_name real_pathrqs r(_copy_example_filesrs # 44    % * !!   \9555 PiPP|7HPPP    X @QXXUVXX    s6A00 B$: BB$manifest list[str]cH|dpg}|sgSddlmg}|D]n}t|tr|d|i/t|t r*|dr||ofd|DS)zLReturn declared ``requires_env`` names that are unset in ``~/.hermes/.env``. requires_envr) get_env_valuerclg|]0}|d|d(|d1Sr)r.0srs r( z/_missing_requires_env_names..sB [ [ [!AEE&MM [--PQRXPYBZBZ [AfI [ [ [r*)rhermes_cli.configr isinstancer:appendrb)rr env_specsentryrs @r(_missing_requires_env_namesrs<<//52L  //////I$$ eS ! ! $   fe_ - - - - t $ $ $6):): $   U # # # [ [ [ [y [ [ [[r*c|dpg}|sdSddlmm}ddlm}g}|D]n}t |tr|d|i/t |tr*|dr||ofd|D}|sdS|dd}| d |d |D]y} | d} | d d } | d d } | dd} d| }| r|d| z }| || r| d| d | r&td| d }n%td| d }n:#ttf$r&| d|dYdSwxYw|r>|| ||t j| <| d|dU| d| d|d{| dS)aPrompt for required environment variables declared in plugin.yaml. ``requires_env`` accepts two formats: Simple list (backwards-compatible):: requires_env: - MY_API_KEY Rich list with metadata:: requires_env: - name: MY_API_KEY description: "API key for Acme service" url: "https://acme.com/keys" secret: true Already-set variables are skipped. Values are saved to the user's ``.env``. rNr)rsave_env_value)display_hermes_homerc6g|]}|d|Srr1rs r(rz+_prompt_plugin_env_vars.. s,DDDQ==6+C+CDqDDDr*z this pluginz [bold]z6[/bold] requires the following environment variables: descriptionrrXsecretF  — z [dim]Get yours at: rurvz, [dim] Skipped (you can set these later in z /.env)[/dim]u [green]✓[/green] Saved to z/.envz [dim] Skipped (set z in z/.env later)[/dim])rrrrhermes_constantsrrr:rrbrzr rCinputEOFErrorKeyboardInterruptrr)rr|rrrrrmissing plugin_namespecrdescrXrlabelvaluers @r(_prompt_plugin_env_varsrs(<<//52L ????????444444I$$ eS ! ! $   fe_ - - - - t $ $ $6):): $   U # # #EDDD)DDDG ,,v}55K MMa[aaabbbhhF|xx r**hhub!!(E**T   $ ^T^^ #E e  ? MM=#=== > > >  5,]$]]];;AACCm4mmm,,2244+,    MMmJ]J]J_J_mmm n n n FFF   h N4 ' ' '$BJt  MMW;N;N;P;PWWW X X X X MMf4ff=P=P=R=Rfff g g g g MMOOOOOs.A F<<2G32G3cddlm}ddlm}ddlm}|}|dz }|rl|d}||}||||dd |dS|||d |d |dd d |dS)z@Show after-install.md if it exists, otherwise a default message.rConsole)Markdown)Panelafter-install.mdrerfgreenF) border_styleexpandz![green bold]Plugin installed:[/] z [dim]Location:[/] u ✓ Installed)rtitlerN) rich.consoler rich.markdownr rich.panelrrh read_textrz) rarKrrrr| after_installcontentmds r(_display_after_installr4s9$$$$$$&&&&&&      giiG!33M))7);; Xg    eeBWUCCCDDD   E2J22%/22$%         r*cddlm}|}||d|d||dS)z*Show confirmation after removing a plugin.rru[red]✗[/red] Plugin [bold]z[/bold] removed from N)rrrz)rr;rr|s r(_display_removedrQs`$$$$$$giiG MMOOO MMYYYKYYZZZ MMOOOOOr*ct||d}|sedd|Dpd}|d|d|d|t jd |S) zUReturn the plugin path if it exists, or exit with an error listing installed plugins.Tr8z, c3LK|]}||jV dS)N)is_dirr)rds r( z,_require_installed_plugin.._s1RRqxxzzRafRRRRRRr*z(none)[red]Error:[/red] Plugin 'z' not found in z. Installed plugins: r )rJrhriterdirrzsysexit)rr;r|rH installeds r(_require_installed_pluginr[s "44 H H HF ==??IIRRk.A.A.C.CRRRRR^V^   . . .k . ."+ . .     Mr*forcetuple[Path, dict, str]c ddl} t|}n/#t$r"}tt ||d}~wwxYwt }|5}t|dz }t}|std tj |ddd|t |gddd } nD#t$r}td|d}~wtj $r}td |d}~wwxYw| j dkr4| jp| jpd } td | t#|} | dpt'|} t)| |} n/#t$r"}tt ||d}~wwxYw| d}|x t+|}n,#tt,f$rtd| d|ddwxYw|t.kr0ddlm}td| d|dt.d|d d| r,|std| d| dt7j| t7jt |t | dddn #1swxYwY| dz p| dz }|s2| dz st<d| ddl m!}tE| |t#| }|dp| j#}| ||fS)zClone Git plugin into ``~/.hermes/plugins``. Returns ``(target_dir, installed_manifest, canonical_name)``. Raises ``PluginOperationError`` on failure. rNplugin$git is not installed or not in PATH.clonez--depth1T<)capture_outputtexttimeoutz%Git clone timed out after 60 seconds.rzGit clone failed: rmanifest_versionPlugin 'z ' has invalid manifest_version 'z' (expected an integer).)recommended_update_commandz' requires manifest_version z), but this installer only supports up to z. Run z to update Hermes.zD' already exists. Use force reinstall or run `hermes plugins update z`.rd plugin.yml __init__.pyz>%s has no plugin.yaml / __init__.py; may not be a valid pluginr)$tempfilerWrBr,r:r7TemporaryDirectoryrr) subprocessrunFileNotFoundErrorTimeoutExpired returncodestderrstdoutrCrrrr`rJint TypeError_SUPPORTED_MANIFEST_VERSIONrrrhrrmtreemovermrnrrrr)rKrrgit_urlrqr;tmp tmp_targetgit_exeresulterrrrrHmvmv_intrhas_yamlrinstalled_manifestinstalled_names r(_install_plugin_corerms OOO2":.. 222"3q66**12..K  $ $ & &=2##YY) )++ O&'MNN N ^'9c7C OOL# FF !   &6 (   &7     ! !=7FM7R>>@@C&'BS'B'BCC C!*--ll6**J.A'.J.J  6*; DDFF 6 6 6&s1vv..A 5 6\\, - - > R *   *5{55555  333HHHHHH*L{LLLL>YLL5577LLL  ==?? " *E{EE5@EEE M& ! ! ! C OOS[[111{=2=2=2=2=2=2=2=2=2=2=2=2=2=2=2~&..00TVl5J4R4R4T4TH  Vm3;;==  L    %$$$$$ ***'//'++F33Bv{N %~ 55s A=A'2K+CK DC  D2DDA5K=F K F:F55F::KG%$K%)HB-KK K enableOptional[bool]cddlm}|} t|}nC#t$r6}|d|t jdYd}~nd}~wwxYw|dr|d|d|d  t|| \}}} nC#t$r6}|d|t jdYd}~nd}~wwxYw|d z sG|d z s0|d z s|d| dt||t|||} | t j rtt jrV t!d| d} | dv} n#t&t(f$rd} YnwxYwd} | r~t+} t-} | | | | t3| t5| |d| dn|d| d|d|d|dS)zInstall a plugin from a Git URL or owner/repo shorthand. After install, prompt "Enable now? [y/N]" unless *enable* is provided (True = auto-enable without prompting, False = install disabled). rr[red]Error:[/red] r NrMrNzs[yellow]Warning:[/yellow] Using insecure/local URL scheme. Consider using https:// or git@ for production installs.z [dim]Cloning ...[/dim]rrdrrz[yellow]Warning:[/yellow] zQ doesn't contain plugin.yaml or __init__.py. It may not be a valid Hermes plugin.z Enable 'z' now? [y/N]: >yyesF [green]✓[/green] Plugin [bold]z[/bold] enabled.zB[dim]Plugin installed but not enabled. Run `hermes plugins enable z` to activate.[/dim]z=[dim]Restart the gateway for the plugin to take effect:[/dim]z#[dim] hermes gateway restart[/dim])rrrWrBrzrrrQrr,rhrrstdinisattyrrrClowerrr_get_enabled_set_get_disabled_setadddiscard_save_enabled_set_save_disabled_set)rKrrrr|rrqrHrr should_enableanswerenableddisableds r( cmd_installrs%$$$$$giiG":..  .1..///  011   G    MM4'4445555I 6 6 6 2"NN  .1..///   ] " * * , , f|6K5S5S5U5U  fhh    D D D D   .8886:...M 9     "#*"3"3"5"5 " &????%''%%''!', 6 /0 & & & %  &"M "$$$&& N###((('"""8$$$ O~ O O O       O*8 O O O    MMQRRR MM7888 MMOOOOOs>" A",AA")B?? C? ,C::C?;G==HHcddlm}|}t} t|||}nC#t$r6}|d|t jdYd}~nd}~wwxYw|dz s-|d|dt jd|d |d t|\}}|s,|d|t jdt||| }d |vr|d |d dS|d |d|d|ddS)zAUpdate an installed plugin by pulling latest from its git remote.rrrr NrPrz@' was not installed from git (no .git directory). Cannot update.z[dim]Updating rAlready up to daterz[/bold] is already up to date.z[/bold] updated.z[dim]ru) rrr7rrBrzrrrh_git_pull_plugin_dirrrC) rrr|r;rHrqokoutputouts r( cmd_updater s$$$$$$giiG..K*4gFF  .1..///   VO # # % %  3 3 3 3      MM24222333%f--JB  3633444  ((( ,,..Cs"" St S S S       OOOOPPP )c)))*****2 A2,A--A2c6ddlm}|}t} t|||}nC#t$r6}|d|t jdYd}~nd}~wwxYwtj |t||dS)z#Remove an installed plugin by name.rrrr N) rrr7rrBrzrrrrr)rrr|r;rHrqs r( cmd_removerEs$$$$$$giiG..K*4gFF  .1..///   M&T;'''''r setc ddlm}|}t|ddg}t|trt |n t S#t $rt cYSwxYw)zRead the disabled plugins set from config.yaml. An explicit deny-list. A plugin name here never loads, even if also listed in ``plugins.enabled``. r load_configr3rdefault)rrrrlistrrl)rconfigrs r(rrVs 11111169j"EEE *8T : :Es8}}}E uu sAAA21A2rcddlm}m}|}d|vri|d<t||dd<||dS)z/Write the disabled plugins list to config.yaml.rr save_configr3rNrrrsorted)rrrrs r(rresg:::::::: []]Fy$*8$4$4F9j!Kr*cb ddlm}|}|di}t|tst S|dg}t|t rt |n t S#t$rt cYSwxYw)zRead the enabled plugins allow-list from config.yaml. Plugins are opt-in: only names here are loaded. Returns ``set()`` if the key is missing (same behaviour as "nothing enabled yet"). rrr3r)rrrrrbrrrl)rr plugins_cfgrs r(rros 111111jjB// +t,, 55L//)R00)'488Cs7|||ceeC uu sAB ABB.-B.rcddlm}m}|}d|vri|d<t||dd<||dS)z.Write the enabled plugins list to config.yaml.rrr3rNr)rrrrs r(rrse:::::::: []]Fy#)'??F9i Kr*cddlm}|}t|s-|d|dt jdt }t}||vr||vr|d|ddS||| |t|t||d |d dS) zEAdd a plugin to the enabled allow-list (and remove it from disabled).rr [red]Plugin '$' is not installed or bundled.[/red]r [dim]Plugin 'z' is already enabled.[/dim]Nrz.[/bold] enabled. Takes effect on next session.) rr_plugin_existsrzrrrrrrrrrrr|rrs r( cmd_enabler&s$$$$$$giiG $   PdPPPQQQ    G ""H w4x// GdGGGHHH KK Tgx    MM (4 ( ( (r*cddlm}|}t|s-|d|dt jdt }t}||vr||vr|d|ddS||| |t|t||d |d dS) zBRemove a plugin from the enabled allow-list (and add to disabled).rrr!r"r r#z' is already disabled.[/dim]Nu"[yellow]⊘[/yellow] Plugin [bold]z/[/bold] disabled. Takes effect on next session.) rrr$rzrrrrrrrrr%s r( cmd_disabler(s$$$$$$giiG $   PdPPPQQQ    G ""H 7tx// HdHHHIII OOD LLgx    MM ( ( ( (r*ct}|rp||z rdS|D]B}|st|}|d|krdSCddlm}|}|rI||z }|r0|dz s|dz rdSdS)zCReturn True if a plugin with *name* is installed (user) or bundled.Trrget_bundled_plugins_dirrdrF)r7rrrrrhermes_cli.pluginsr+rh)ruser_dirchildrr+ repo_plugins candidates r(r$r$s,~~H tO # # % % 4%%''  E<<>> %e,,H||F##t++tt,;:::::**,,L 4'        & . . 0 0 L(0022 4 5r*rc ddln#t$rdYnwxYwidfd dd lm}|dddt dddt S)uxReturn a list of (key, version, description, source, dir_path) for every plugin the loader can see — user + bundled. Mirrors :meth:`PluginManager._scan_directory_level` so category-namespaced plugins (``observability/langfuse``, ``image_gen/openai``) surface here just like flat ones (``disk-cleanup``). A subdirectory with no ``plugin.yaml`` of its own is treated as a category and recursed into one level deeper (depth capped at 2, same as the loader). The returned ``key`` is the path-derived registry key — the value the user types into ``hermes plugins enable ``. For category-namespaced plugins that's ``/``; for flat plugins it's the manifest's ``name`` (or the directory name if the manifest omits it). User entries override bundled on key collision, matching ``PluginManager.discover_and_load``. rNbasersourcer:prefixdepthrr rsc\|sdSt|D]q}|s|dkr|dkr |jdvr.|dz }|s|dz }|r|j}d}d}r t |d5} | pi} dddn #1swxYwY| d |j}| d d}| d d}n#t$rYnwxYw|r |d |jn|} |} |d kr|dz rd} | ||| |f| <C|dkrK|r |d |jn|j} ||| |dzsdS)Nrbundled>memorycontext_enginerdrrrerfrversionrr>userrPrr ) rrrrrhrjrkrrl)r2r3r4r5rro manifest_namer:rrprkey src_label sub_prefix_scanseenris r(r@z$_discover_all_plugins.._scans\{{}}  F ''. 4. 4A88::  i''F::: -M '')) 1 !L 0 ##%%  !  !-'BBB?a'+~~a'8'8'>BH???????????????(0 VQV(D(D "*,,y""="=&.ll="&E&E $/5G**!&***-" V##V(;(;(=(=# %I!'; 1ES zz17CF--QV---QVJ E!VZ 3 3 3 3]. 4. 4s7'D/8C D/C D/#C $A D// D<;D<r*r7rr;) r2rr3r:r4r:r5rr rs)ri ImportErrorr,r+r7rvalues)r+r@rAris @@@r(_discover_all_pluginsrDs$ D1414141414141414f;::::: E ! ! # #YA666 E,..&"a(((   s  cTddlm}ddlm}|}t }|s,|d|ddSt }t}|dd }|d d |d |dd |d|dd |D]>\}}} } } ||vrd} n ||vrd} nd} | || t|| | ?|||||d|d|ddS)z>List all plugins (bundled + user) with enabled/disabled state.rr)Tablez [dim]No plugins installed.[/dim]:[dim]Install with:[/dim] hermes plugins install owner/repoNPluginsF)r show_linesNamebold)styleStatusVersiondim DescriptionSourcez[red]disabled[/red]z[green]enabled[/green]z[yellow]not enabled[/yellow]z-[dim]Interactive toggle:[/dim] hermes pluginsz?[dim]Enable/disable:[/dim] hermes plugins enable/disable uI[dim]Plugins are opt-in by default — only 'enabled' plugins load.[/dim]) rr rich.tablerFrDrzrr add_columnadd_rowr:) rrFr|entriesrrtablerr:rr3_dirstatuss r(cmd_listrY-s$$$$$$      giiG#%%G  8999 RSSS  G ""H E e 4 4 4E V6*** X Ye,,, ]### XU+++4;GG0g{FD 8  *FF W__-FF3F dFCLL+vFFFF MMOOO MM% MMOOO MMABBB MMSTTT MM]^^^^^r*list[tuple[str, str]]c\ ddlm}d|DS#t$rgcYSwxYw)zAReturn [(name, description), ...] for available memory providers.rdiscover_memory_providerscg|] \}}}||f Sr1r1)rrr_avails r(rz._discover_memory_providers..]s#SSS!3tVt SSSr*)plugins.memoryr]rlr\s r(_discover_memory_providersraYs[<<<<<<SS7P7P7R7RSSSS  s  ++cg}t} ddlm}|D]6\}}}||vr,|||f||7n#t $rYnwxYw ddlm}m}||}|r6t|ddr%|j |vr||j dfn#t $rYnwxYw|S)aZReturn [(name, description), ...] for available context engines. Includes repo-shipped engines from ``plugins/context_engine/`` AND plugin-registered engines (third-party engines installed as Hermes plugins via ``ctx.register_context_engine``). Repo-shipped descriptions win when a plugin-registered engine collides on name. r)discover_context_engines)discover_pluginsget_plugin_context_enginerNzinstalled plugin) rplugins.context_enginercrrrlr,rdregetattrr) enginesrArcrrr_rdre plugin_engines r(_discover_context_enginesrjbsH&(GUUD CCCCCC":":"<"<   D$4d|,,,        RRRRRRRR1133  EW]FDAA EmFX`dFdFd NNM.0BC D D D       Ns%AA A'&A'+AC C  C cp ddlm}|}t|dddpdS#t$rYdSwxYw)zBReturn the current memory.provider from config (empty = built-in).rrr8providerrrrrrrlrrs r(_get_current_memory_providerrosb111111vxR@@@FBF rr $' 55cp ddlm}|}t|dddpdS#t$rYdSwxYw)z.Return the current context.engine from config.rrcontextengine compressorrrmrns r(_get_current_context_enginerusb111111vy(LIIIY\Y ||rpchddlm}m}|}d|vri|d<||dd<||dS)z'Persist memory.provider to config.yaml.rrr8rlNrrrrrrrs r(_save_memory_providerrys_:::::::: []]Fvx#'F8Z Kr*chddlm}m}|}d|vri|d<||dd<||dS)z&Persist context.engine to config.yaml.rrrrrsNrwrxs r(_save_context_enginer{s_:::::::: []]Fy"&F9hKr*cddlm}t}t}dg}dg}d}|D]R\}}|||r|d|n|}||||krt |dz }S|rC||vr?||||dt |dz }|d|| } || } | |krt | d Sd S) zDLaunch a radio picker for memory providers. Returns True if changed.rcurses_radiolistzbuilt-in (default)rrr (not found)zMemory Provider (select one)ritemsselectedTF)hermes_cli.curses_uir~rorarrSry) r~current providersrnamesrrrrchoice new_providers r(_configure_memory_providerrsK555555*,,G*,,I" "E DEH&& d T+/94'''''T U 7??5zzA~H"7%'' W ---...u::>  ,F =Lwl+++t 5r*cddlm}t}t}dg}dg}d}|D]R\}}|||r|d|n|}||||krt |dz }S|dkrC||vr?||||dt |dz }|d|| } || } | |krt | d Sd S) zCLaunch a radio picker for context engines. Returns True if changed.rr}zcompressor (default)rtrr rzContext Engine (select one)rTF)rr~rurjrrSr{) r~rrhrrrrrrr new_engines r(_configure_context_enginersN555555)++G'))G$ $E NEH&& d T+/94'''''T U 7??5zzA~H,7%#7#7 W ---...u::>  +F vJWZ(((t 5r*c vddlm}|}t}t}t }g}g}t }t |D]h\}\} } } } } | r| d| n| }| dkr|d}|| ||| |vr| |vr||itpd}t}d|tfd|tfg}t|}t|}|s.|s,|d |d d Stjs|d d S dd l}t'|||||||d S#t($rt+||||||Yd SwxYw) uJInteractive composite UI — general plugins + provider plugin categories.rrrr7z [bundled]built-inzMemory ProviderzContext EnginezE[dim]No plugins installed and no provider categories available.[/dim]rGNz0[dim]Interactive mode requires a terminal.[/dim])rrrDrrr enumeraterrrorurrr<rzrrrcurses_run_composite_uirB_run_composite_fallback)rr|rU enabled_set disabled_set plugin_names plugin_labelsplugin_selectedir_versionrr3_drcurrent_memorycurrent_context categories has_pluginshas_categoriesrs r( cmd_togglersQ$$$$$$giiG$%%G"$$K$&&LLMeeO8A'8J8J##4 4D(K2=G4.....4 Y  (((ED!!!U### ;  4|#;#;    " " "233AzN133O N,FG ?,EFJ |$$K*%%N ~ ]^^^ RSSS 9     HIIIC &, & G = = = = = CCC m_ ,j' C C C C C CCs;FF87F8c ddlm}t|t|tzdddfd}||t} t|} t |D]I\} } | vr+| | | | 4| | Jt} | | k}| |k}|s|ret| t| | dt| dt|t| z dndkr| d d r:tpd }t}| d |d |ddksd r| d| dS)z._drawAs       T     % % ' ' '   Q 2B 7 7 7   Q 3R 8 8 8   Q 12 6 6 6   QV]Q%6%6F!*PRVWPWPW < > > L*%@%B%B & .JrN"(!1!1   d+++!,,..d"..000"55777",,Q0BBGGG",,Q0CRHHH",,Q0A2FFF",,QV]Q5F5FFL^`bccc***)2r222I%%7;M"34F )+BB--------- 6@n3 8V"(&(("AEM*=> )PRVWPWPW < > > L*%@%B%B & .JrN "(!1!1   d+++!,,..d"..000"55777",,Q0BBGGG",,Q0CRHHH",,Q0A2FFF",,QV]Q5F5FFL^`bccc***SXX&&37 /0er s]A0E22 E?>E?4AH HHJ66 KK,AL<< M M O-- O:9O:u% [green]✓[/green] General plugins: z enabled, z disabled.z& [dim]General plugins unchanged.[/dim]rru*[green]✓[/green] Memory provider: [bold]z[/bold] Context engine: [bold]z[/bold]z/[dim]Changes take effect on next session.[/dim]N)rrrrSwrapperrrrrrrrzroru)rrrrrrr|rr new_enabled new_disabledrr prev_enabledenabled_changeddisabled_changed new_memory new_contextrrrrrs` ` ` @@@@@r(rr3s100000  ! !FL!!Iz??Ll*K(-EJJM~~~~~~~~~~~~@ NN5KMMM uuKH L\**##4 ;; OOD ! ! !   & & & &   T " " " "#%%L!\1O#x/A*A+&&&<(((  @K8H8H @ @<  3{#3#33 @ @ @     Q ?@@@() 133Az 133   :J : :%0 : : :   1}} &9:} GHHH MMOOOOOr*c Tddlm}m}t|d|j|rt |}t|d|jt|d|j t|D]8\} } | |vr|d|jnd} td | d | d zd d | 9t t|d|j } | snst| d z } d| cxkrt|krnn| | hn#ttt f$rYdSwxYwtt }t |}t|D]I\} }| |vr+||||4||Jt'}||ks||krt)|t+||rt|d|jt|D]%\}\}}}td |d zd |d|d&t t|d|j } | rEt| d z }d|cxkrt|krnn||dn#ttt f$rYnwxYwtdS)z1Text-based fallback for the composite plugins UI.r)Colorscolorz Pluginsz General Pluginsz& Toggle by number, Enter to confirm. Tu[✓]z[ ]rrr z>2z. z" Toggle # (or Enter to confirm): Nz Provider Pluginsr]z" Configure # (or Enter to skip): rO)hermes_cli.colorsrrrzYELLOWrDIMrGREENrrCrrSrrBrrrrrrr)rrrrrr|rrrrrmarkervalidxrrrrrrrrs r(rr,s0/////// %% v} - -... -_%% ee)6=99::: ee=vzJJKKK %m44 9 95<=KKz6<888U7677AE777778888 GGG EE"F SSTTZZ\\#hhl////c,///////66u=== 18<     GGG  55 MM  .. ' 'GAtF{{%%%$$T****  &&&&')) , & &,(*B*B k * * * | , , ,  ee*FM::;;;3 A  A A%% B /BB B c ddlm}n#t$rYdSwxYw ddlm}m}||}|jD]P\}}|jj |ks||kr5|j D]+}| |}|r|j r |j ccS,nQn#t$rYnwxYw ddlm } | tfD]} | s| |z } | rRt!| } | dpgD]+}| |}|r|j r |j ccS,n#t$rYnwxYwdS)u!Return the toolset key a plugin registers its tools under, or None. Queries the live tool registry — the plugin must already be loaded. Falls back to reading ``provides_tools`` from plugin.yaml and looking up the toolset from the registry for the first tool name found. r)registryN)rdget_plugin_managerr*provides_tools)tools.registryr rlr,rdr _pluginsrrrtools_registered get_entrytoolsetr+r7rrrr) rr rdr manager_keyloaded tool_namerr+r2r0rs r(_get_plugin_toolset_keyrs(+++++++ tt  KKKKKKKK$$&&#,2244  LD&#t++tt||!'!8--I$..y99E--$},,,,, 0<        >>>>>>,,.. ? - -D;;== t I!! -))44!).>!?!?!E2--I$..y99E--$},,,,, -       4s= BB"B"" B/.B/3BEE E"!E"ct|}|sdSddlm}m}|}|d}t |t si}||d<d}|D]T\}} t | ts|r|| vr| |d}9|| vr| |d}U|r |s |s|g|d<d}|r ||dSdS)zAdd or remove a plugin's toolset from platform_toolsets for all platforms. Only acts if the plugin actually provides tools (has a toolset key). Nrrplatform_toolsetsFTcli) rrrrrrrbrrrremove) rr toolset_keyrrrrrplatformts_lists r(_toggle_plugin_toolsetrsS *$//K :::::::: []]F #677 ' . .8&7"#G.4466  ''4((    ')){+++ G # # NN; ' ' 'Gg&7$/=%  Fr*c"t|s dd|ddSt}t}|rm||vr ||vrd|ddS||||t |t |t|dd|ddS||vr ||vrd|ddS||||t |t |t|dd|ddS)zEnable or disable a plugin in ``config.yaml`` (runtime allow/deny lists). For plugins that provide tools (toolsets), also toggles the toolset in ``platform_toolsets`` so the agent actually sees the tools in sessions. Frz' is not installed or bundled.rT)r r unchanged)r)r$rrrrrrr)rrrrs r("dashboard_set_agent_plugin_enabledr"sO $  W&U&U&U&UVVV   B   C> 2::$c//4@@ @ t  D"3tD1111Du=== 2~~$#++Dt<<<JJtGGDMMMbs4....5 9 99r*Optional[Path]ct} t||d}n#t$rYdSwxYw|r|ndS)z>Resolved path under ``~/.hermes/plugins/`` if it exists.Tr8N)r7rJrBr)rr;rHs r(_user_installed_plugin_dirr%s_..K&t[tLLL tt]]__ .66$.s # 11ct|}|dd|dtddS|dz s dd|ddSt|\}}|sd|dSd d lm}t ||d |v}d |||d S)z1``git pull`` inside ``~/.hermes/plugins/``.NFr' was not found under r?rrPz-' is not a git checkout; cannot pull updates.rrrT)r rr r!)r%r7rhrrrr)rrHr msgrr!s r(dashboard_update_user_pluginr)s ' - -F ~MMMLNNMMM   VO # # % % SSSS   #6**GB +c***$$$$$$ ***$+I) L LLr*rHtuple[bool, str]c t}|sdS tj|ddgdddt|}n"#t$rYdStj$rYdSwxYw|jdkr:|jpd p|j }d |pd fSd|j fS) N)Frpullz --ff-onlyTr)rrrcwd)Fz$Git pull timed out after 60 seconds.rrFzgit pull failed.) r)rrr:rrrrrCr)rHrrrs r(rr2s%''G =<< = fk *F     ===<<<  $===<<<=A}"))++Dv}/B/B/D/Dc//// $$&& &&s)> A AAct}tD]\}}}}}||kr |dkrdddcSt|}| dd|d|ddStj|d |d S) z7Delete a plugin tree under ``~/.hermes/plugins/`` only.r7Fz5Bundled plugins cannot be removed from the dashboard.rNrr'r?T)r r)r7rDr%rr)rr;n_verrsrc_pathrHs r(dashboard_remove_user_pluginr3Is..K#8#:#:cc4S% 99 ))*abb b b b ' - -F ~JJJKJJJ    M& % %%r*ctt|dd}|dkrQd}t|ddrd}nt|ddrd}t|jt|dd| dS|d krt|jdS|d vrt |jdS|dkrt |jdS|d krt|jdS|d vrtdS|tdSddl m }| d|dtjddS)z$Dispatch hermes plugins subcommands.plugins_actionNinstallrFT no_enabler)rrupdate>rmr uninstalldisable>lsrrrz[red]Unknown plugins action: z[/red]r )rgrrKr rrr&r(rYrrrrzrr)argsaction enable_argrs r(plugins_commandr@[s T+T 2 2F  45 ) ) JJ T; . . J O$//      8  49 0 0 049 8  49 9  DI > ! !  (((((( FFFFGGG  r*)r r )r r)rr:r;rr9r<r r)rKr:r r:)rXr:r r:)rarr rb)rarr rs)rrbr r)rrbr rs)rarrKr:r rs)rr:r;rr rs)rr:r;rr r)rKr:rr<r r)FN)rKr:rr<rrr rs)rr:r rs)r r)rrr rs)rrr rs)rr:r r<)r r)r rs)r rZ)r r:)r r<)rKr:rr<rr<r r)rr:r r )rr:rr<r rs)rr:rr<r r)rr:r r#)rr:r r)rHrr r*)Hr0 __future__r functoolsloggingrrrrpathlibrtypingrrrrrrhermes_cli.secret_promptr getLoggerr-rm lru_cacher)rlr,rr7rJrWr`rrrrrrrrrrr rrrrrr&r(r$rDrYrarjroruryr{rrrrrr rrr"r%r)rr3r@r1r*r(rIs#"""""   ,,,,,,%%%%%%999999  8 $ $Q DSSSSS9SSS  666666r8        *\\\\$HHHHV:    $Z6Z6Z6Z6~!PPPPPf%+%+%+%+P(((("    $644PPPPf$_$_$_$_X@####L####V5C5C5C5Cpvvvr9 9 9 x....b++++\####L::::B////MMMM4''''.&&&&$      r*