߲j;dZddlmZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZmZddlmZddlmZdd lmZdd lmZdd lmZmZmZmZmZmZdd lm Z m!Z!ejDd Z#dZ$dZ%e&hdZ'd dZ(d!dZ)d"dZ*d#dZ+d$dZ,dddd d%dZ-d&dZ.d'dZ/edGddZ0 d(dZ1y))zPlugin discovery: directory scanning, entry-point manifests, and the enable/disable gate. Split out of :mod:`hermes_cli.plugins`. Names that tests patch on the origin (``get_bundled_plugins_dir``, ``_env_enabled``) are looked up lazily through it. ) annotationsN) dataclass)Path)AnyDictListOptionalSet)get_hermes_home)cfg_get)VALID_CAPABILITY_IDS)parse_declared_capabilities)PluginManifest_detect_kind_from_source manifest_key_resolve_module_sourceparse_manifest_fileportable_plugin_manifest)LEGACY_RELAY_PLUGIN_KEYSRELAY_PLUGINS_CONFIG_ENVzhermes_cli.pluginszhermes_agent.pluginsz hermes_agent.plugin_capabilities> .kimi-plugin .codex-plugin .devin-plugin.claude-plugin.cursor-pluginct|drt|j|St|trt|j |gS|Dcgc]}|j |k(s|c}Scc}w)zCReturn one metadata entry-point group across supported Python APIs.select)group)hasattrlistr isinstancedictgetr) entry_pointsreps A/home/ubuntu/.hermes/hermes-agent/hermes_cli/plugins_discovery.py_select_entry_point_groupr'&sf|X&L''e'455,%L$$UB/00% ;2U):B ;; ;s A3,A3cg} tjj}t|t}t|t }|D]} |Dchc](}|j|jk(s|j*}}tDcgc]}|jd||vs|} }t|dd} t| dd} |jt|jtt| ddxsd| t| j!ddxsdndd |j|jt#|jt%| |j |S#t $r"}tjd||cYd}~Sd}~wwxYwcc}wcc}w#t $r-}tjd t|d d |Yd}~d}~wwxYw)aReturn metadata-only manifests for installed entry-point plugins. Kind comes from an import-free source scan (memory/model providers route to their own discovery). Capabilities come from the companion ``hermes_agent.plugin_capabilities`` group (``.`` entries pointing at the same object), so consent works without importing plugin code. Failures are isolated per entry point.zEntry-point scan failed: %sN.distmetadataversionSummary entrypoint)namer, descriptionsourcepathkeykind capabilitiesz'Entry-point manifest for %r skipped: %sr0?) importlibr+r$r'ENTRY_POINTS_GROUPENTRY_POINT_CAPABILITIES_GROUP Exceptionloggerdebugvaluer0r getattrappendrstrr#_classify_entrypoint_value_kind_parse_declared_capabilities) manifestseps group_epscapability_epsexcr%ddeclaredcr6r*r+s r&discover_entrypoint_manifestsrL/s ')I  --/-c3EF 238VWc c(6N1!''RXX:MNHN';\!"''!A3?OS[?[A\L\2vt,DtZ6H   ^WWc'$ 2*F*L"&MFNFZC Y ; ArB`b#"((4RXX>9,P   c %  2C8 O\ c LLBGBPVX[D\^a b b cs`>E" F F,F: FFF!B standalone).:rN standalone)rAsplitstriprrr;)r> module_names r&rBrBNsZ%j&&sA.q1779 Q\()? )LMbfwkww sAA AAc ddlm}t|ddg}t|tr t |St S#t $r t cYSwxYw)uMRead ``plugins.disabled`` — a deny-list that wins over ``plugins.enabled``.r load_configpluginsdisabled)defaulthermes_cli.configrVr r!r setr;)rVrXs r&_get_disabled_pluginsr]WsL1;=)ZL *8T :s8}EE u s4A AAAc ddlm}t|dd}t|tr t |SdS#t $rYywxYw)zRead the ``plugins.enabled`` allow-list (plugins are opt-in). ``None`` = key missing/malformed ("nothing enabled yet"; the first ``migrate_config`` run grandfathers installed user plugins); ``set()`` = explicitly empty; else the allow-list.rrUrWenabledNrZ)rVr_s r&_get_enabled_pluginsr`asD1+-I>)'48s7|BdB s277 AAr-) skip_namesprefixdepthc g}|js|S t|j}|D]}|j jdr2|j jdrtjd|Q|j tvrtjd|z |jr|dk(r|r|j |vrtd|dz |d z fDd} |d z } | jxs| j} | $t| |||} | |j|  | r |jt!|||*|d k\rtjd|G|r|d|j n |j } |j%t'||| |d z|S#t$r#}tj d|||cYd}~Sd}~wwxYw#t$r"}tj d ||Yd}~d}~wwxYw#t"$r"}tj d | |Yd}~d}~wwxYw)aPRead manifests under *path*: flat ``//plugin.yaml`` (key ``name``) or category ``///plugin.yaml`` (key ``cat/name``; a manifest-less directory recurses one level, depth capped at two). *skip_names* ignores top-level names; portable ``plugin.json`` packages are accepted alongside YAML manifests.z&Failed to scan plugin directory %s: %sN__zSkipping dunder plugin path %sz1Skipping %s (foreign-harness manifest convention)rc3BK|]}|js|ywN)exists).0fs r& z!scan_directory..s!i^_^f^f^h!!isz plugin.yamlz plugin.ymlz plugin.jsonz+Skipping unreadable plugin directory %s: %szFailed to parse %s: %srOz/Skipping %s (no plugin.yaml, depth cap reached)/)rbrc)is_dirsortediterdirOSErrorr<warningr0 startswithendswithr=_FOREIGN_HARNESS_MANIFEST_DIRSnextrh is_symlinkrr@rr;extendscan_directory)r3r2rarbrcrDchildrenrHchild manifest_file portable_file has_portablemanifest sub_prefixs r&rxrxms'')I ;;=$,,.)$` ::  &5::+>+>t+D LL95 A  ::7 7 LLLe T  <<>eqjZEJJR\D\ !iem.CU\EY-Z!ikopM!M1M(//1O]5M5M5OL  $*=%PH#  *  M  !9%!PQaZ LLJE R5;F81UZZL1J   ^E6*TY\]T]^ _I$`J Q ?sK*  NNH%QT U    M7LL MsTF=,%G,AG,=H= G)G$G)$G), H5HH I#IIcddlm}gddfd }|j}tj d||d|dhdt dz }tj d ||d |d |j d r._scans4y&ZH +UCJ?zScanning bundled plugins: %szbundled (top-level)bundled>model-providersmemorycontext_enginecron_providersrWzScanning user plugins: %suserHERMES_ENABLE_PROJECT_PLUGINSz.hermeszScanning project plugins: %sprojectzHProject plugins disabled (set HERMES_ENABLE_PROJECT_PLUGINS=1 to enable)rg) rrArrr2rAraOptional[Set[str]]returnNone) hermes_clirWget_bundled_plugins_dirr<r=r _env_enabledrcwd)_originr repo_pluginsuser_dir project_dirrDs @r&collect_directory_manifestsrs.&(I 224L LL/> y KM 9,H LL,h7 &(F#;<hhj9,y8  3[A ii0   _` rc .i}|D] }t|}|j|}||jdk(r|jdvr|jrt |jj nd}|jrt |jj nd}|r6|r4||k7r/t jd|j|j|||t jd||j|j|j|||<|S)aLater sources win on key collision (project > user > bundled): a same-named copy under ``~/.hermes/plugins/`` is the documented way to override a bundled plugin, and is logged. A flat user/project manifest that claims a bundled key from a *differently named* directory is an impostor, not an override (``impostor_dir/plugin.yaml`` with ``name: kanban``): it is skipped with a warning so ``hermes plugins enable kanban`` never activates unrelated code under the bundled name.r>rrr-zIgnoring %s plugin at %s: its manifest name '%s' is a bundled plugin's key but the directory is named '%s'; rename the directory to '%s' to override the bundled pluginz5Plugin '%s' at %s (%s) shadows the bundled copy at %s) rr#r2r3rr0r<rqinfo)rDwinnersr~r4shadowedown_dir bundled_dirs r&resolve_manifest_winnersrs *,G 8$;;s#  HOOy$@X__XkEk2:--d8==)..RG6>mm$x}}-22K;7k+AkOOX]]C+  KKOQTV^VcVc  8  NrT)frozencFeZdZUdZded<dZded<dZded <dZd ed <y) ManifestGatezERouting verdict for one winning manifest (see :func:`gate_manifest`).rAactionFboolr_N Optional[str]errorzOptional[tuple]log)__name__ __module__ __qualname____doc____annotations__r_rrrr&rrs(O KGTE=Crrct||jh}dddfd}|tzr#dtd}||tj d|S||zr|dtj dS|jd k(r|d tj d S|jd k(r|d tj ddS|jdk(r4|jdk(r tdS|jdk(r tdS|||zs|ddtj dS|jdk7rQddl m }||j|j}|,d|jxsd}||tj d|StdS)aDecide how one winning manifest is handled. Gate order matters: legacy relay refusal, explicit disable, category-owned kinds (exclusive / model-provider), bundled auto-loads (backend now, platform deferred), then ``plugins.enabled`` opt-in (path-derived key or legacy bare name).F)r_c.td||||g|S)N placeholder)r_rr)r)rlevelmessager_args lookup_keys r& _placeholderz#gate_manifest.._placeholders#M7%eU\^hMpkoMpqqru?removed — Relay lifecycle is owned by Hermes core; configure z insteadz5Refusing to load removed Hermes Relay plugin '%s'; %szdisabled via configzSkipping disabled plugin '%s' exclusiveu<exclusive plugin — activate via .provider configz8Skipping '%s' (exclusive, handled by category discovery)zmodel-providerNz?Skipping '%s' (model-provider, handled by providers/ discovery)Trbackendload_nowplatformdeferz2not enabled in config (run `hermes plugins enable z` to activate)z&Skipping '%s' (not in plugins.enabled)r)installed_plugin_removalz(removed from the Hermes plugin catalog: zno reason recordedu@Refusing to load plugin '%s' — %s; run `hermes plugins remove`load) rrrintrrAr_rrr)rr0rrloggingWARNINGDEBUGr5r2rhermes_cli.plugins_cmd_catalogrr3reason) r~rXr_namesrrrremovedrs @r& gate_manifestrs h'J  'E\ar '' M'( 2 E7??4kmrss x17==Babb}} # JGMM F  }}(( '--!blpr r)# ==I % + + ==J &( (ego@ N []d]j]j 4  )# L*8==(--H  >w~~?eQe>fgEw8z %' '  r)r$rrrArr )rzList['PluginManifest'])r>rArrA)rr\)rz Optional[set]) r3rr2rArarrbrArcrrList[PluginManifest])rr)rDrrzDict[str, PluginManifest])r~rrXzSet[str]r_rrr)2r __future__rimportlib.metadatar8r dataclassesrpathlibrtypingrrrr r hermes_constantsr r[r hermes_cli.plugin_capabilitiesr rrChermes_cli.plugins_manifestrrrrrrhermes_cli.relay_plugin_cutoverrr getLoggerr<r9r: frozensetrtr'rLrBr]r`rxrrrrrrr&rs #!11,%?f_   / 0+!C "+," <> BFUWfg4 44,>4OR4`c44n@4 $   6 6 (06 ;M6 6 r