+ lHjn Rt^RIHt^RIHt^RIHtHtHtH t ^RI H t H t H t ^RIHtHt^RIHt!RR]4t!R R ]4t!R R ]4t]!R ]]RR7]!R]]RR7!RR]4t!RR]4t!RR]4t]!R]]RR7!RR] 4t!RR]4t!RR]4t]!R ]]R!R7!R"R#]4t!R$R%]4t]!R&]]R'R7!R(R)]4t!R*R+] 4t!R,R-] 4t !R.R/]4t!]!R0]]!R1R7!R2R3] 4t"!R4R5] 4t#!R6R7]4t$!R8R9] 4t%!R:R;] 4t&!R<R=]4t']!R>]#]'R?R7!R@RA]4t(!RBRC]4t)!RDRE] 4t*!RFRG]4t+]!RH](]+RIR7!RJRK]4t,!RLRM]4t-!RNRO]4t.!RPRQ]4t/!RRRS]4t0!RTRU]4t1!RVRW]4t2]!RX],]2RYR7!RZR[]4t3!R\R]]34t4!R^R_]4t5!R`Ra]54t6]!Rb]3]6RcR7]!Rd]3]5ReR7]!Rf]4]5RgR7!RhRi]4t7!RjRk]4t8]!Rl] ]8RmR7!RnRo] 4t9!RpRq]4t:!RrRs]4t;]!Rt] ];RuR7!RvRw] 4t<!RxRy]4t=!RzR{]4t>]!R|] ]>R}R7!R~R] 4t?!RR]?4t@!RR]4tA]!R]@]ARR7!RR]?4tB!RR]4tC]!R]B]CRR7!RR]4tD!RR]4tE]!R]?]ERR7!RR]4tF]!R]?]FRR7!RR]?4tG!RR]4tH]!R]G]HRR7!RR]?4tI!RR] 4tJ!RR]4tK]!R]I]KRR7!RR]4tL]!R]I]LRR7!RR]I4tM!RR]4tN]!R]M]NRR7!RR]4tO!RR]4tP!RR]4tQ!RR]4tR]!R]O]RRR7!RR] 4tS!RR] 4tT!RR] 4tU!RR]4tV!RR] 4tW!RR]4tX!RR]4tY!RR]4tZ!RR]4t[!RR]4t\!RR]4t]!RR]4t^!RR]4t_!RR]4t`!RR]4ta]!R]T]aRR7!RR] 4tb!RR] 4tc!RR]4td!RR]4te]!R]c]eRR7R#)aTools / toolsets / MCP servers / plugins / skills / learning graph / reload contracts (``tui_gateway/methods_tools.py``). Every ``mcp.servers.*``, ``mcp.catalog``, ``skills.manage`` and ``plugins.manage`` handler runs under ``_profile_scoped_rpc`` and the desktop routes them via ``requestGatewayForProfile`` / ``requestForBot``, so all of them accept the optional ``profile`` key. ) annotations)Field) JsonValueParamsResultWireEnum) OpenModel ProfileParamsSessionLiveInfo)CatalogAppState CatalogTier)methodc*]tRt^t$RtRtR]R&RtR#)_SessionScopedzHandlers that look a live session up with ``_sessions.get(params.get("session_id"))``: an absent / unknown id falls back to the launch profile's config, so it is never required.N str | None session_id)__name__ __module__ __qualname____firstlineno____doc__r__annotations____static_attributes__rL/home/ubuntu/.hermes/hermes-agent/tui_gateway/contracts/tools_mcp_plugins.pyrrs_"J !rrcR]tRt^t$RtR]R&R]R&R]R&R]R&R tR ]R &R tR #) ToolsetRowzkOne row of ``methods_tools._toolset_rows``; ``tools`` only when the caller asked for them (``tools.list``).strname descriptionint tool_countboolenabledNlist[str] | Nonetoolsr)rrrrrrr&rrrrrrs) IO M"E "rrc"]tRt^(t$R]R&RtR#)ToolsetsListResultzlist[ToolsetRow]toolsetsrNrrrrrrrrrr(r((srr(z tools.listzdEvery toolset with its resolved tool names, flagged against the session's (or config's) enabled set.)paramsresultdocz toolsets.listz?Toolset summaries (no tool names) for the desktop Toolsets tab.c,]tRt^3t$R]R&R]R&RtR#) ToolShowRowrrr rNr*rrrr/r/3 Irr/c,]tRt^8t$R]R&R]R&RtR#)ToolShowSectionrrzlist[ToolShowRow]r&rNr*rrrr2r28s I rr2c,]tRt^=t$R]R&R]R&RtR#)ToolsShowResultzlist[ToolShowSection]sectionsr!totalrNr*rrrr4r4=s ## Jrr4z tools.showz^The /tools listing grouped by toolset, including tools deferred behind the tool_search bridge.c]tRt^FtRtRtRtR#) ToolsActionenabledisablerN)rrrrr9r:rrrrr8r8Fs FGrr8cL]tRt^Kt$RtR]R&R]R&RtR]R&RtR]R &R tR#) ToolsConfigureParamsz``names`` are toolset keys or ``server:tool`` MCP targets; with ``session_id`` the live session's profile is authoritative and its agent is rebuilt.r8action list[str]namesNrrprofiler) rrrrrrrr@rrrrr<r<Ks):  !J !GZrr<cX]tRt^Ut$R]R&R]R&RtR]R&R]R&R]R &R]R &R tR#) ToolsConfigureResultr>changedenabled_toolsetsNzSessionLiveInfo | Noneinfomissing_serversr#resetunknownr)rrrrrrErrrrrBrBUs* #'D ' K rrBztools.configurezcPersist a toolset / MCP enable-disable change and rebuild the session agent so it takes effect now.c8]tRt^et$RtRtR]R&RtR]R&RtR#)ReloadEnvParamszYThe shared owner serves ``/reload`` for one session the caller controls (``session_id``).Nrrr@r rrrrrrrr@rrrrrJrJesc!J !GZrrJc"]tRt^lt$R]R&RtR#)ReloadEnvResultr!updatedrNr*rrrrMrMls LrrMz reload.envzURe-read ~/.hermes/.env (CLI /reload parity); built agents keep their pool until /new.cT]tRt^tt$RtRtR]R&RtR]R&RtR]R&Rt R]R &R t R#) ReloadMcpParamszWithout ``confirm`` the handler may answer ``confirm_required`` (per ``approvals.mcp_reload_confirm``); ``always`` persists the opt-out; ``rev`` is the config revision the caller wants loaded (coalescing).NrrFr#confirmalwaysrevr) rrrrrrrrQrRrSrrrrrPrPts2m"J !GTFDCrrPc]tRt^~tRtRtRtR#)ReloadMcpStatusconfirm_requiredreloadedrN)rrrrrVrWrrrrrUrU~s )HrrUc"]tRt^tRtRtRtRtR#)ReloadMcpSessionapplied unchangedbusyrN)rrrrrZr[r\rrrrrYrYsGI DrrYc]tRt^t$RtR]R&RtR]R&RtR]R&RtR]R &Rt R]R &Rt R ]R &Rt R ]R&Rt R]R&Rt R]R&RtR#)ReloadMcpResulta.``session``: what the calling local session's MCP servers did (a new policy generation, nothing to change, or deferred while a turn runs or waits); ``unavailable``: configured servers that did not connect beside what did apply; ``session_servers``: the MCP servers that session's committed policy runs.rUstatusNrmessage loaded_rev bool | None coalescedturn_isolationJsonValue | Nonehost_ackzReloadMcpSession | Nonesessionr% unavailablesession_serversr)rrrrrrr`rarcrdrfrgrhrirrrrr^r^sdi GZ!J !!I{!"&NK&!%H%'+G $+$(K!((,O%,rr^z reload.mcpzZTear down and rediscover MCP servers for every live session (prompt cache is invalidated).c*]tRt^tRtRtRtRtRtRt R#) SkillsActionlistsearchinstallbrowseinspectrN) rrrrrlrmrnrorprrrrrkrks D FG FGrrkch]tRt^t$Rt]P tR]R&Rt R]R&Rt R]R&Rt R]R &R t R#) SkillsManageParamszs``query`` is the search text / hub identifier / browse page (digits); ``page`` / ``page_size`` apply to ``browse``.rkr=Nrquery int | Nonepage page_sizer) rrrrrrkrlr=rrsrurvrrrrrrrrs7(,,FL,E:D* Iz rrrc,]tRt^t$R]R&R]R&RtR#) SkillHubHitrrr rNr*rrrrxrxr0rrxcb]tRt^t$RtRtR]R&RtR]R&RtR]R&Rt R]R &Rt R]R &R t R#) SkillBrowseItemz,``hermes_cli.skills_hub.browse_skills`` row.rrr sourceNrtrust identifierr) rrrrrrrr r|r}r~rrrrrzrzs66D#NKFCE:!J !rrzcp]tRt^t$RtRtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R &Rt R]R &R t R#) SkillInspectInfozU``hermes_cli.skills_hub.inspect_skill``; ``{}`` when the identifier resolves nowhere.Nrrr r|r~r%tagsskill_md_previewr) rrrrrrrr r|r~rrrrrrrrsC_D*"K"FJ!J !!D !#'j'rrc]tRt^t$RtRtR]R&RtR]R&RtR]R&Rt R ]R &Rt R ]R &Rt R ]R&Rt R ]R&Rt R ]R&RtR]R&RtR#)SkillsManageResultuShape follows the action: ``list`` → ``skills`` (category → names); ``search`` → ``results``; ``install`` → ``installed`` + ``name``; ``browse`` → ``items`` + paging; ``inspect`` → ``info``.Ndict[str, list[str]] | Noneskillszlist[SkillHubHit] | Noneresultsrb installedrrzlist[SkillBrowseItem] | Noneitemsrtru total_pagesr6zSkillInspectInfo | NonerEr)rrrrrrrrrrrrurr6rErrrrrrshn+/F '.(,G %,!I{!D**.E '.D*"K"E:$(D !(rrz skills.managezbSkills hub backend: list the profile's skills or search / browse / inspect / install from the hub.c8]tRt^t$RtRtR]R&RtR]R&RtR#)SkillsReloadParamsz``session_id`` binds the rescan to that session's profile and workspace (project skills); ``profile`` scopes a session-less rescan.Nrrr@rrKrrrrrs1"J !GZrrc0]tRt^t$R]R&RtR]R&RtR#)SkillCommandRefrrr{r rN)rrrrrr rrrrrrs IKrrc]tRt^t$Rt]!]R7tR]R&]!]R7t R]R&]!]R7t R]R&^t R]R &^t R]R &R t R #) SkillsReloadDiffz'``agent.skill_commands.reload_skills``.default_factoryzlist[SkillCommandRef]addedremovedr>r[r!r6commandsrN)rrrrrrrlrrrr[r6rrrrrrrsG1#(#>E >%*4%@G "@ 6Iy6E3NHcrrc,]tRt^t$R]R&R]R&RtR#)SkillsReloadResultroutputrr,rNr*rrrrrs K rrz skills.reloadzNRe-scan skill dirs; the pre-rendered ``output`` is what /reload-skills prints.cB]tRtRt$RtR]R&RtR]R&RtR]R&RtR#)LearningFramesParamsiNrtcolsrowsframesr) rrrrrrrrrrrrrrs D*D*FJrrc`]tRtRt$RtR]R&R]R&R]R&R ]R &]!]R 7tR ]R &Rt R#) LearningFrameiz``agent.learning_graph_render.render_graph`` projection; ``grid`` rows are lists of ``[text, styleKey, alpha?, hexOverride?]`` runs.floatrevealrdater!visiblezlist[list[JsonValue]]gridrzlist[dict[str, JsonValue]]labelsrN) rrrrrrrrlrrrrrrrs.8 M I L ).t)DF &DrrcH]tRtRt$R]R&R]R&RtR]R&RtR]R&R tR#) LearningLegendItemirglyphlabelNrstylecolorr)rrrrrrrrrrrrrs J JE:E:rrc^]tRtRt$R]R&R]R&R]R&R]R&R]R&R]R&R]R &R tR #) LearningNodeRowiridrr fullLabelmetabodyrrNr*rrrrrs% G J JN I I Jrrcz]tRtRt$R]R&R]R&R]R&R]R&R]R&R]R &R tR ]R &R tR ]R &R]R&RtR #)LearningBucketRowi$r!indexrrrrmemoriesr6Nrcategoryrzlist[LearningNodeRow]nodesr)rrrrrrrrrrrrr$s: J J I KM JHjE:  rrc,]tRtRt$R]R&R]R&RtR#) LearningAxisi0rstartendrNr*rrrrr0s J Hrrcr]tRtRt$R]R&R]R&R]R&R]R&R ]R &R ]R &R ]R&R ]R&R ]R&RtR#)LearningFramesResulti5zlist[LearningFrame]rzlist[LearningLegendItem]legend categorieszlist[LearningBucketRow]bucketsr>summaryraxisr!countrrrNr*rrrrr5s5  $$(( $$   J I Irrzlearning.frameszWPre-render the /journey timeline (frames + legend/summary) so the TUI walks it locally.c&]tRtRt$RtR]R&RtR#)LearningNodeParamsiENrrr)rrrrrrrrrrrrEs B rrc&]tRtRt$RtR]R&RtR#)LearningEditParamsiINrcontentr)rrrrrrrrrrrrIs GZrrc4]tRtRt$RtR]R&RtR]R&RtR#) LearningMutationResultiMuQ``agent.learning_mutations`` — ``ok: false`` carries the reason in ``message``.r#okNrr`r)rrrrrrr`rrrrrrMs[ HGZrrcP]tRtRt$RtR]R&RtR]R&RtR]R&RtR]R&Rt R#) LearningDetailResultiTNrkindrrrr) rrrrrrrrrrrrrrrTs*D*B E:GZrrzlearning.detailzrequires transportr)rrrrrrrrrrrrhs, I!%NJ%O MNrrc"]tRtRt$R]R&RtR#)McpCatalogResultirzlist[McpCatalogEntry]serversrNr*rrrrrrs ""rrz mcp.catalogzYCurated MCP presets with per-profile installed/enabled state and the env keys each needs.c]tRtRtRtRtRtR#)McpServerSourceizconfigpluginrN)rrrrrrrrrrrrzs F Frrc]tRtRt$RtR]R&R]R&RtR]R&RtR]R &R ]R &R ]R &RtR]R &Rt R]R&R]R&Rt R]R&R]R&Rt R]R&Rt R#)McpServerSummaryiu]``tui_gateway/mcp_rpc_helpers.summarize_server`` — a server's config without secret values.rrrNrurlcommandr>argsenvauthrboauth_tokens_presentr#r$rer&rr|rr) rrrrrrrrrrr&rrrrrrrsbg INCGZ O ND*(,+, M"E " FJrrc"]tRtRt$R]R&RtR#)McpServersListResultizlist[McpServerSummary]rrNr*rrrrrs ##rrzmcp.servers.listzSConfigured MCP servers for the (scoped) profile, secrets redacted to env-key names.c.]tRtRtRtRtRtRtRtRt Rt R #) McpRuntimeStatusi connecteddisabled connectingfailedlazy configuredrN) rrrrrrrrrrrrrrrrs IHJ F DJrrcp]tRtRt$RtR]R&R]R&R]R&R]R &R]R &R ]R &R ]R&RtR]R&RtR#)McpServerRuntimeRowizDSafe projection of ``tools.mcp_tool_discovery.get_mcp_status`` rows.rrrr!r&r#rrrr_rr|Nrrr)rrrrrrrrrrrrrs4N IN JON  FJrrc,]tRtRt$R]R&R]R&RtR#)McpServersStatusResultizlist[McpServerRuntimeRow]rr! checked_atrNr*rrrrrs &&Orrzmcp.servers.statuszSCached runtime state per configured server; never connects, probes, or starts auth.c"]tRtRt$R]R&RtR#)McpServerNameParamsirrrNr*rrrrr IrrcF]tRtRt$RtRtR]R&RtR]R&RtR]R&R t R#) McpServersAddParamsiz``preset`` (catalog id) and/or ``config`` (url/command/args/env/headers/auth/tools); a ``bearer_token`` is written to the profile's .env, only the header template persists.Nrpresetdict[str, JsonValue] | Noner bearer_tokenr) rrrrrrrrrrrrrrrs)]FJ*.F '.#L*#rrc6]tRtRt$R]R&R]R&R]R&RtR #) McpServersAddResultir#rrrrserverrNr*rrrrrs H I rrzmcp.servers.addzUAdd a server to the profile's config from a catalog preset and/or an explicit config.c0]tRtRt$R]R&RtR]R&RtR#)McpServersSetApiKeyParamsirvalueNrenv_varr)rrrrrrrrrrrrs JGZrrc@]tRtRt$R]R&R]R&R]R&R]R&R tR #) McpServersSetApiKeyResultir#rrrrrrrNr*rrrrrs H I L rrzmcp.servers.set_api_keyzaStore a credential in the profile's .env and reference it from the server config (header or env).c,]tRtRt$R]R&R]R&RtR#) McpProbeToolirrr rNr*rrrrrr0rrcr]tRtRt$RtR]R&R]R&RtR]R &RtR ]R &RtR ]R &R]R &Rt R]R&Rt R#)McpServersTestResultizY``ok: false`` carries ``error``; ``prompts`` / ``resources`` are only counted on success.r#rzlist[McpProbeTool]r&Nrerrorrtprompts resources oauth_neededrbrr) rrrrrrrrr rrrrrrrs?c H E:GZ Iz (,+,rrzmcp.servers.testu`Connect, list tools, disconnect — an OAuth server with no token on disk is reported as not ok.c,]tRtRt$R]R&R]R&RtR#)McpServersRemoveResultir#rrrNr*rrrr r s  H Mrr zmcp.servers.removez-Drop a server from the profile's config.yaml.c*]tRtRt$RtRtR]R&RtR#)McpOauthStartParamsizrWith ``client_redirect_uri`` the CLIENT hosts the loopback and relays the code via ``mcp.servers.oauth.callback``.Nrclient_redirect_urir)rrrrrrrrrrrrrs''+*rrc@]tRtRt$R]R&R]R&R]R&R]R&RtR #) McpOauthStartResultir#rrrauth_urlflowrNr*rrrrrs HOM Irrzmcp.servers.oauth.startzTBegin a PKCE OAuth flow; the client opens auth_url and polls mcp.servers.oauth.poll.c&]tRtRt$RtR]R&RtR#)McpOauthFlowParamsizX``session_id`` is the OAuth flow id returned by ``oauth.start`` (not a gateway session).rrrNrrrrrrrrrrrrs bOrrc"]tRtRtRtRtRtRtR#)McpOauthPollStatusipendingapprovedrrN)rrrrrrrrrrrrrsGH Errcd]tRtRt$R]R&R]R&RtR]R&RtR]R &RtR]R &RtR ]R &R t R#)McpOauthPollResultir#rrr_Nrr error_messagerzlist[McpProbeTool] | Noner&r) rrrrrrrrr&rrrrrrs6 H !J ! $M:$Hj'+E $+rrzmcp.servers.oauth.pollzSPoll a flow; approved persists tokens for the profile and returns the probed tools.c>]tRtRt$R]R&RtR]R&RtR]R&RtR#) McpOauthCancelResulti'r#rNrr_rr)rrrrrr_rrrrrrr's HFJ $M:$rrzmcp.servers.oauth.cancelzHCancel a flow owned by the resolved profile, waking its callback worker.cP]tRtRt$RtR]R&RtR]R&RtR]R&RtR]R&Rt R#) McpOauthCallbackParamsi1Nrcodestaterissr) rrrrr"rr#rr$rrrrr!r!1s*D*E:E:Crr!c>]tRtRt$R]R&RtR]R&RtR]R&RtR#) McpOauthCallbackResulti9r#rNrrrr)rrrrrrrrrrrr&r&9s H!J ! $M:$rr&zmcp.servers.oauth.callbackzARelay a client-captured redirect into a client_redirect_uri flow.c]tRtRtRtR#)PluginsListParamsiFrN)rrrrrrrrr(r(Fsrr(c|]tRtRt$R]R&R]R&R]R&RtR]R &RtR ]R &RtR ]R &RtR ]R &Rt R]R&Rt R#)LegacyPluginRowiJrrversionr#r$Nrkeyrtr&hooksrrr) rrrrrr,r&r-rrrrrrr*r*JsC I L MCE:E:HjE:rr*c6]tRtRt$R]R&R]R&R]R&RtR#)PluginToolsetRowiVrr,rr rNr*rrrr/r/Vs H Jrr/c>]tRtRt$R]R&RtR]R&RtR]R&R tR#) PluginsListResulti\zlist[LegacyPluginRow]pluginsNzlist[PluginToolsetRow] | Noner)r%portable_mcp_serversr)rrrrrr)r3rrrrr1r1\s "".2H+2-1*1rr1z plugins.listz[Loaded plugin manager entries (legacy flat view); the Plugins Hub uses plugins.manage list.c6]tRtRtRtRtRtRtRtRt Rt R t R t R #) PluginsActionigrltogglernupdateremovesettings onboardingpresencerN) rrrrrlr6rnr7r8r9r:r;rrrrr5r5gs* D FG F FHJHrr5c]tRtRt$Rt]P tR]R&Rt R]R&Rt R]R&Rt R ]R &Rt R]R &Rt R]R &RtR]R &RtR ]R&RtR]R&RtR ]R&RtR]R&RtR]R&RtR#)PluginsManageParamsira7``toggle``: ``key``/``name`` + ``enable``; ``install``: ``identifier``/``repo`` or ``catalog_name`` (+ ``force``, ``enable``, ``ref``); ``update``: ``name`` (+ ``accept_capabilities`` to apply a re-pin that widened the plugin after the user confirmed the ``delta``, + ``force`` to apply an update whose security scan returned caution after the user saw the findings); ``remove``: ``name`` (user installs only); ``settings``: ``key`` + ``values`` (``{setting_key: value}``, non-secret schema keys only); ``presence``: ``names`` (catalog names, answered in that order).r5r=Nrr,rrbr9r~repo catalog_nameforcerefaccept_capabilitiesrvaluesr%r?r)rrrrrr5rlr=rr,rr9r~r>r?r@rArBrCr?rrrrr=r=rsH*..FM.CD*FK!J !D*#L*#E;C'++*.F '."E "rr=c.]tRtRtRtRtRtRtRtRt Rt R #) PluginSettingFieldTypeistringnumberbooleanenumsecretjsonrN) rrrrrFrGrHrIrJrKrrrrrErEs F FG D F DrrEc]tRtRt$RtR]R&R]R&R]R&R]R&R ]R &R tR ]R &R tR ]R&R tR]R&R t R]R&R t R]R&Rt R #)PluginSettingFieldizOne ``config_schema`` key of a plugin manifest, rendered by the Plugins hub (``hermes_cli.plugins_settings.plugin_settings_fields``). ``secret`` fields carry no value: ``env`` names the ``.env`` variable and ``has_value`` whether it is set.rr,rEtyperr r#requiredNrerdefaultr%choicesrrrb has_valuer) rrrrrrrrPrQrrRrrrrrMrMsZH H  JN"E " $G $ $G $C!I{!rrMc:]tRtRtRtRtRtRtRtRt Rt R t R t R t R #) PluginServerStateirapp_not_runninghermes_not_connectedendpoint_unavailableno_interactive_sessionversion_too_old missing_appunsupported_gpurHrN)rrrrrrUrVrWrXrYrZr[rHrrrrrTrTs2I'O115'OK'OGrrTc6]tRtRt$R]R&R]R&R]R&RtR#) PluginServerRowirrrTr#sentencerNr*rrrr]r]s I Mrr]c]tRtRt$RtR]R&R]R&R]R&R]R&R]R&R]R &R ]R &R]R &R ]R &R]R&RtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R&Rt R]R&Rt R]R&Rt R]R&RtR]R&RtR#)AgentPluginRowizW``methods_tools._plugin_rows`` + ``plugins_cmd_catalog.catalog_row_fields`` provenance.rrr,r+r r|r_r#portable install_dirhas_desktop_halfzlist[PluginServerRow]rNrr? catalog_tier installed_sha catalog_shacatalog_versionrbupdate_available update_target pinned_shazlist[PluginSettingField] | Nonesettings_schemar)rrrrrrr?rdrerfrgrhrirjrkrrrrr`r`sa I H L K KN ""#L*##L*# $M:$"K""&OZ&$(k(!%M:$!J !7;O4;rr`cZ]tRtRt$RtR]R&R]R&]!]R7tR]R &R t R ]R &R t R #)PluginLiveServeriziOne plugin MCP server connected at activation: its callable tool names, or the reason it did not connect.rrr#rrr>r&Nrrr) rrrrrrrrlr&rrrrrrmrms(s IOT2E92E:rrmc4]tRtRt$RtR]R&RtR]R&RtR#) PluginLiveSkillizTOne plugin skill usable now through ``skill_view`` (qualified ``:``).rrr{r rN)rrrrrrr rrrrroros^ IKrrocP]tRtRt$]!]R7tR]R&]!]R7tR]R&Rt R#) PluginLiveNowirzlist[PluginLiveServer] mcp_serverszlist[PluginLiveSkill]rrN) rrrrrrlrrrrrrrrrqrqs"*/*EK'E$)$$?F !?rrqcv]tRtRt$RtR]R&R]R&]!]R7tR]R&R t R ]R &]!]R7t R]R &R t R #)PluginActivationiuWhat a plugin loaded mid-run does NOW vs later (``hermes_cli.plugins_activation``). ``activated_now`` kinds (``{kind: [names]}``): ``gateway_commands`` (slash names), ``locales`` (``.`` language-pack layers), ``gateway_transforms`` / ``hooks`` (hook names), ``callbacks`` (platforms / ``slack:``) — live in the running gateway once it reloaded (``gateway_reloaded``). ``live_now``: the plugin's MCP servers (connected, with their tools, or the error) and skills, usable in every open chat of the profile from its next turn — the chats also get a note listing them. ``deferred`` kinds: ``tools`` (Python tool names) and ``prompt`` (section ids) apply from the next session.rrr,rzdict[str, list[str]] activated_nowNzPluginLiveNow | Nonelive_nowdeferredr) rrrrrrrdictrurvrwrrrrrtrts>$ I H*/*EM'E%)H")%*4%@H"@rrtcb]tRtRt$RtR]R&R]R&R]R&R]R&R ]R &R ]R &R]R &RtR#)OnboardingCatalogPluginizA catalog plugin curated for the onboarding card (``onboarding: true``) that this OS runs. ``app_state`` is the pinned ``plugin.json`` declaration judged on this host; ``sentence`` names what is missing (empty when present or unknown).rrtitler r tierr> platformsr app_stater^rNrrrrrzrzs03 I J MrrzcN]tRtRt$RtR]R&R]R&R]R&R]R&R]R &R tR #) CatalogPluginPresenceiaA named catalog plugin this OS runs. ``state`` is the pinned ``plugin.json`` app declaration judged on this host; ``sentence`` names what is missing (empty when present or unknown); ``disclosure`` is the catalog description's ``Disclosure:`` sentence (empty when it has none).rrr{r r#r^ disclosurerNrrrrrrs$P I J MOrrcX]tRtRt$RtR]R&R]R&R]R&R]R&R]R &R]R &R tR #) PluginScanFindingizUOne security-scan finding (``tools.plugin_guard``) on a plugin tree the scan blocked.r pattern_idseverityrfiler!liner rNrrrrrrs$_OMM I Irrc]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R ]R &Rt R ]R &Rt R ]R &Rt R ]R &Rt R]R&RtR ]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR ]R&RtR]R&RtR ]R&RtR]R &RtR]R!&RtR ]R"&RtR]R#&RtR$]R%&RtR]R&&Rt R]R'&Rt!R(]R)&Rt"R*]R+&R,t#R#)-PluginsManageResultiu``list`` → ``plugins`` + counts; ``toggle`` → ``ok``/``unchanged``/``restart_required``/``name`` (the canonical key written)/``plugin``; ``install`` → ``hermes_cli.plugins_cmd.dashboard_install_plugin``'s ok payload; ``toggle``/``install``/``update`` that loaded a plugin also carry ``gateway_reloaded`` (the running gateway picked it up and re-wired its handlers) and ``activation`` — the honest split of what is live now vs deferred, so ``restart_required`` is True only when no gateway answered; ``update`` → ``ok``/``unchanged``/``sha``, or ``ok=false`` + ``consent_required`` with the ``delta`` (``{surface: [added...]}``) / ``delta_lines`` a widened pin adds — nothing changed until the client retries with ``accept_capabilities`` — or ``ok=false`` + ``scan_blocked`` with ``scan_verdict`` / ``scan_findings`` (retry a caution verdict with ``force``); ``remove`` → ``ok``/``name`` plus ``cleared_memory_provider`` when the removed plugin was the live ``memory.provider``.Nzlist[AgentPluginRow] | Noner2rt user_count bundled_countrbrr[restart_requiredgateway_reloadedzPluginActivation | None activationcleared_memory_providerrrzAgentPluginRow | Noner plugin_namer%warnings missing_envpython_dependencies known_issuesafter_install_pathr$shaconsent_requiredrdelta delta_lines scan_blocked scan_verdictzlist[PluginScanFinding] | None scan_findingsrwrittenz$list[OnboardingCatalogPlugin] | Noner:z"list[CatalogPluginPresence] | Noner;r)$rrrrrr2rrrrr[rrrrrrrrrrrrr$rrrrrrrrrr:r;rrrrrrsA],0G (/!J ! $M:$B !I{!$(k($(k(*.J'.+/[/D*$(F !("K"!%H%$(K!(,0)0%)L")%) )G[C$(k()-E &-$(K!(!%L+$#L*#48M18E: $G $7;J4;37H07rrzplugins.managezuPlugins Hub backend: list installed plugins, toggle, git-install, re-pin a catalog install, or remove a user install.c&]tRtRtRtRtRtRtRtR#)PluginCatalogLookupStatusiNfound invalid_namerHrhrN) rrrrrrrHrhrrrrrrNs E!LGKrrc"]tRtRt$R]R&RtR#)PluginCatalogLookupParamsiUrrrNr*rrrrrUrrrcR]tRtRt$RtR]R&R]R&R]R&R]R&RtR]R &R tR #) PluginCatalogLookupEntryiYzWThe fields an install needs: the same ones the embedded catalog picker posts on a pick.rrr>rsubdir communityr|rN)rrrrrrr|rrrrrrYs#a I I H KD#rrc4]tRtRt$RtR]R&RtR]R&RtR#) PluginCatalogLookupResulticz``found`` carries ``entry``. ``unknown`` covers a name the catalog doesn't list and one it removed; ``unavailable`` means neither the live catalog nor the in-tree fallback could be read.rr_NzPluginCatalogLookupEntry | Noneentryr)rrrrrrrrrrrrrcs^ &%-1E *1rrzplugins.catalog.lookupzOne curated plugin-catalog entry by name, from the backend's live catalog (cached, with the in-tree fallback and kill list); backs hermes://plugin/install?catalog= deep links.N)fr __future__rpydanticrbaserrrrcommonrr r connectors_operationr r registryr rrr(r/r2r4r8r<rBrJrMrPrUrYr^rkrrrxrzrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrrrr!r&r(r*r/r1r5r=rErMrTr]r`rmrorqrtrzrrrrrrrrrrrsZ#55==>"V"##|N3E qs~6H LN& f f |N? km( 66!5>R prff|OO bdfh x -f - |OO gi8!!& "i"(y( ) )1:L oqf y 1:L []6 EFEf ! ! 6 6 !5>R df+V1!3R moV $7@V :<+-+& )