+ Wj@a0t$Rt^RIHt^RIt^RIt^RIt^RIt^RI H t ^RI H t ^RI HtHtHtHtHt^RIHt^RIHt^RIHt^R IHt^R IHtHtHtHtH t H!t!^R I"H#t#H$t$]PJ!R 4t&R t'Rt(])!0R1m4t*]PV!RRR7t,R]-R&]P\R4t/RRlt0RRlt1RRlt2RRlt3RRlt4RR lt5R!RR"R#R$^/R%R&llt6R'R(lt7R)R*lt8] !R+R,7!R-R.44t9R/R0lt:R#)2zPlugin 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"hermes_plugin_discovery_suppressedFdefaultzcontextvars.ContextVar[bool]_discovery_suppressedc#"\PR4pRx\PV4R# \PT4i;i5i)z``discover_plugins()`` is a no-op inside; the scope's manager stays undiscovered, so the first real consumer after the block still loads its plugins.TN)rsetreset)tokens PC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\plugins_discovery.pysuppress_plugin_discoveryr0s< " % %d +E+ ##E*##E*sA4AA  AcV^8dQhRR/#)returnbool)formats"r __annotate__r&;s''T'c*\P4#N)rgetr$r'rplugin_discovery_suppressedr+;s $ $ &&r'c$V^8dQhRRRRRR/#)r! entry_pointsrgroupstrr"listr$)r%s"rr&r&?s!<.`` 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: %srC?) importlibr>r-r7ENTRY_POINTS_GROUPENTRY_POINT_CAPABILITIES_GROUP ExceptionloggerdebugvaluerCr getattrappendrr/r*_classify_entrypoint_value_kind_parse_declared_capabilities) manifestseps group_epscapability_epsexcr6ddeclaredcrIr=r>s rdiscover_entrypoint_manifestsr^Hs ')I  --/-c3EF 238VW c(6N1''RXX:MHN';\';!''!A3?OS[?[AA';L\2vt,DtZ6H   ^WWc'$ 2*F*L*L"&MFNFZC Y ; A ArB`b#"((4RXX>9,P    %  2C8 O\ c LLBGBPVX[D\^a b b csg>E: F4 F*.F*> F4F/$F/*A7F4"AF4: F'F"F'"F'* F44 G-?"G((G-c V^8dQhRRRR/#)r!rQr/r"r$)r%s"rr&r&gs33r'c\V4PR^4^,P4pV'd\\ V44MR;'gR# \ dR#i;i)zWClassify an entry-point target by import-free source scan (unresolvable -> standalone).:N standalone)r/splitstriprrrN)rQ module_names& rrTrTgs]%j&&sA.q1779 Q\()? )LMbfwwkww sAAA A)(A)cV^8dQhRR/#)r!r"rr$)r%s"rr&r&pssr'c^RIHp\V!4RR.R7p\V\4'd \ V4#\ 4# \ d\ 4u#i;i)uMRead ``plugins.disabled`` — a deny-list that wins over ``plugins.enabled``. load_configpluginsdisabledrhermes_cli.configrir r4r0rrN)rirks r_get_disabled_pluginsrnpsO1;=)ZL *8T : :s8}EE u s:A AAAcV^8dQhRR/#)r!r"z Optional[set]r$)r%s"rr&r&zs  m r'c^RIHp\V!4RR4p\V\4'd \ V4#R# \ dR#i;i)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.rhrjenabledNrl)rirqs r_get_enabled_pluginsrrzsG1+-I>)'488s7|BdB s8== A  A  skip_namesprefixr@depthc 0V^8dQhRRRRRRRRRR R R /#) r!rFrrEr/rsOptional[set[str]]rtruintr"r:r$)r%s"rr&r&s<44 44,>4OR4`c44r'c @.pVP4'gV#\VP44pTEFpTP PR4'd:TP PR4'd\PRT4K^TP \9d\PRT4KTP4'd!T^8XdT'dTP T9dK\RTR, TR, 34R4p TR , p T P4;'gT P4p T e(\YY4p T eTPT 4EK@EKCT 'd TP\!YT44EKjT^8d\PR T4EKT'dT R TP 2M TP p TP%\'YY^,R 74EK T# \d#p\P RY4TuRp?#Rp?ii;i \d#p\P RY4Rp?EK1Rp?ii;i \"d#p\P R Y4Rp?EKaRp?ii;i)aDRead 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+Skipping unreadable plugin directory %s: %sN__zSkipping dunder plugin path %sz1Skipping %s (foreign-harness manifest convention)c3T"TFqP4'gKVxK R#5ir))exists).0fs& r !scan_directory..s!i-Z^f^f^h!!-Zs( (z plugin.yamlz plugin.ymlz plugin.jsonzFailed to parse %s: %sz/Skipping %s (no plugin.yaml, depth cap reached)/)rtru)is_dirsortediterdirOSErrorrOwarningrC startswithendswithrP_FOREIGN_HARNESS_MANIFEST_DIRSnextr| is_symlinkrrSrrNextendscan_directory)rFrErsrtrurVchildrenrZchild manifest_file portable_file has_portablemanifest sub_prefixs&&$$$ rrrs ')I ;;==$,,.) ::  & &5::+>+>t+D+D LL95 A  ::7 7 LLLe T  <<>>eqjZEJJR\D\ !iem.CU\EY-Z!ikopM!M1M(//1OO]5M5M5OL  $*=PH#  *$  M  !9%!PQaZ LLJE R5;F81UZZL1J   ^E*\]T]^ _IJ Q DdP*  NNH% U    M7LL MsfHII(I;AI>II0 H=H82H=8H= I- I((I-0 J;JJcV^8dQhRR/#r9r$)r%s"rr&r&s%9r'ca^RIHp.oRRV3RlllpVP4p\P RV4V!RVR0Rm4\ 4R, p\P RV4V!R VR 4VP R 4'dF\P!4R , R, p\P R V4V!R VR 4S#\P R4S#)zRead directory manifests in full-discovery order (bundled top-level, bundled/platforms, user, opt-in project) without loading or mutating anything, so startup probes share the exact precedence/containment rules of the real discovery sweep.)rjc ,V^8dQhRRRRRRRRRR /#) r!labelr/ directoryrrErsrwr"Noner$)r%s"rr&1collect_directory_manifests..__annotate__s1  S T 3 DV bf r'c<\WVR7p\PRV\V44SP V4R#))rsz %s: %d manifest(s)N)rrOrPlenr)rrrErsfoundrVs&&&& r_scan*collect_directory_manifests.._scans2yZH +UCJ?r'zScanning bundled plugins: %szbundled (top-level)bundledrjzScanning user plugins: %suserHERMES_ENABLE_PROJECT_PLUGINSz.hermeszScanning project plugins: %sprojectzHProject plugins disabled (set HERMES_ENABLE_PROJECT_PLUGINS=1 to enable)r)>memory computer_usecontext_enginecron_providersmodel-providers) hermes_clirjget_bundled_plugins_dirrOrPr _env_enabledrcwd)_originr repo_pluginsuser_dir project_dirrVs @rcollect_directory_manifestsrs.&(I  224L LL/> y [] 9,H LL,h7 &(F#;<<hhj9,y8  3[A ii0   _` r'c V^8dQhRRRR/#)r!rVr:r"zdict[str, PluginManifest]r$)r%s"rr&r&s(<AZr'c p/pVEF,p\V4pVPV4pVEeVPR8XdVPR9dVP'd \ VP4P MRpVP'd \ VP4P MRpV'd>V'd6WV8wd0\ PRVPVPW5V4K\ PRW2PVPVP4W!V&EK/ V#)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.rr@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) rr*rErFrrCrOrinfo)rVwinnersrrGshadowedown_dir bundled_dirs& rresolve_manifest_winnersrs *,G8$;;s#  HOOy$@X__XkEk2:---d8==)..RG6>mmm$x}}-22K;7+AkOOX]]C+  KKOQTVcVc  8  Nr'T)frozencP]tRt^t$RtR]R&RtR]R&RtR]R &RtR ]R &R t R#) ManifestGatezERouting verdict for one winning manifest (see :func:`gate_manifest`).r/actionFr#rqN Optional[str]errorzOptional[tuple]logr$) __name__ __module__ __qualname____firstlineno____doc____annotations__rqrr__static_attributes__r$r'rrrs(O KGTE=Cr'rc(V^8dQhRRRRRRRR/#) r!rrrkzset[str]rqrwr"rr$)r%s"rr&r&s,8 8 8 (08 ;M8 8 r'ca \V4o ^RIHpS VP0V!S 4mpRR/RV 3RlllpV\,'d$R\ R2pV!V\ PRV4#WA,'dV!R \ PR 4#VPR 8XdV!R \ PR 4#VPR8XdV!R\ PRRR7#VPR8Xd9VPR8Xd \R4#VPR8Xd \R4#VeWB,'gV!RS R2\ PR4#VPR8wdZ^RI H pV!VPVP4pVe3RVP;'gR 2pV!V\ PRV4#\R4#) 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).)legacy_plugin_keysrqFc ,V^8dQhRRRRRRRRR R /#) r!rrlevelrxmessager/rqr#r"rr$)r%s"rr&#gate_manifest..__annotate__ s8rrMr#rrUYrfrrr'c*<\RW0WS.VO5R7#) placeholder)rqrr)r)rrrrqargs lookup_keys&&&$*r _placeholder#gate_manifest.._placeholder sM7e^hMpkoMpqqr'utremoved — Relay lifecycle is owned by Hermes core; configure a standard user or system Relay plugins.toml, or use z# for an explicit user-file overridez5Refusing 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)T)rqrbackendload_nowplatformdeferz2not enabled in config (run `hermes plugins enable z` to activate)z&Skipping '%s' (not in plugins.enabled))installed_plugin_removalz(removed from the Hermes plugin catalog: zno reason recordedu@Refusing to load plugin '%s' — %s; run `hermes plugins remove`load)rhermes_cli.left_core_migrationrrCrrloggingWARNINGDEBUGrHrErhermes_cli.plugins_cmd_catalogrrFreason) rrkrqrnamesrrrremovedrs &&& @r gate_manifestrs h'JA  H);J)G HEr\arr ''' $$<#==` b E7??4kmrss 17==Babb}} # JGMM F  }}(( '--!blpr r)# ==I % + + ==J &( (eoo@ N []d]j]j 4  )# L*8==(--H  >w~~?e?eQe>fgEw8z %' '  r'> .kimi-plugin .codex-plugin .devin-plugin.claude-plugin.cursor-plugin);__conditional_annotations__r __future__r contextlib contextvarsimportlib.metadatarKr dataclassesrpathlibrtypingrrrrr hermes_constantsr rmr hermes_cli.plugin_capabilitiesr r rUhermes_cli.plugins_manifestrrrrrrhermes_cli.relay_plugin_cutoverrr getLoggerrOrLrM frozensetr ContextVarrrcontextmanagerrr+r7r^rTrnrrrrrrr)rs@rrs #!11,%?f_   / 0+!C "+,"7B6L6L(%7939 ++'<> 4AE4UW4fg4n@4 $   8 r'