+ Wjka0t$Rt^RIHt^RIt^RIt^RIt^RIt^RI H t ^RI H t H t ^RIHt^RIHtHtHtHtHtHtHtHtHt^RIHt^RIHt^RIt ]PD!R 4t#0Rvmt$R ]%R &0R kR kRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkR kR!kR"kR#kR$kR%kR&kR'kR(kR)kR*kR+kR,kR-kt&R ]%R.&^t'R/](3R0](3R1])3R2])3R3])]*3R4])]*3R5]+3R6]+3R7],3R8],3R9]-3R:]-3R;](3/ t.R<]%R=&R>R?lt/R@RAlt0RBRClt1RDRElt2RFRGlt3RHRIlt4RJRKlt5RLRMlt6RNROlt7RPRQlt8RRRSlt9RTRUlt:RVRWlt;RXRYltRwR^R_llt?R`Ralt@] !RbRc44tARxRdRelltB]P!Rf4tDRgRhltE]P!Ri4tFRjRkltGRlRmltHRnRoltIRpRqltJRrRsltKRtRultLR# ]!dRt EL{i;i)yzPlugin manifest model and parsing (``plugin.yaml`` v1/v2, portable ``plugin.json``). Split out of :mod:`hermes_cli.plugins`; validation warns and never fails a load. ) annotationsN)suppress) dataclassfield)Path) AnyCallableDictListMappingOptionalSetTupleUnion)fast_safe_load)parse_declared_capabilitieszhermes_cli.pluginszset[str]_VALID_PLUGIN_KINDSnameversion descriptionauthor requires_envprovides_toolsprovides_hookskindhookslabel optional_env platformsexternal_dependenciespip_dependenciesprovides_browser_providersprovides_web_providersmanifest_version api_versionrequires_pluginspython_dependencies config_schemalicensehomepagetags capabilitiesemitslistenshermesdependsrequires_hermespython_runtimeprovides_locales requires_authoauth_KNOWN_MANIFEST_FIELDSstrstringintintegerfloatnumberboolbooleanlistarraydictobjectsecretzdict[str, tuple]_CONFIG_SCHEMA_TYPEScV^8dQhRR/#)returnr<)formats"OC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\plugins_manifest.py __annotate__rJ6s"""c&^RIHpVP#))plugins) hermes_clirN_PLUGINS_DEBUG)_origins rI_plugins_debugrR6s-  ! !!rKc V^8dQhRRRR/#rEkeyr6rFrG)rHs"rIrJrJ;s++3+3+rKc\V4p\P!VPR44P 4R,pRV RV 2#)zGReturn a readable, collision-resistant namespace for a portable plugin.zutf-8:NNz agent-plugin--)_portable_slughashlibsha256encode hexdigest)rUslugdigests& rI_portable_skill_namespacer`;sD # D ^^CJJw/ 0 : : !_portable_slug..Cs0fZeTV2::<<2:2COZes /AAz-_plugin)joinlowerstrip)rUr^s& rIrYrYBs7 77fZ]ZcZcZef fD ::d  ' 'x'rKc$V^8dQhRRRRRR/#)rErUr6serverrFrG)rHs"rIrJrJGs!""#"s"s"rKc?\V4#)a`Internal name of a portable plugin's MCP server: exactly the name its ``mcp.json`` gives it, the same rule a user's own ``mcp_servers`` block in config.yaml follows. The plugin's skill namespace (``agent-plugin--``) is NOT prepended: it keeps plugin-data and skill names collision-free without coordination, but here it cost ~40 chars of every ``mcp____`` name, which providers cap at 64, so the tool verb was hash-clamped away. A duplicate is refused at load (native config first, then first-loaded plugin) with a warning naming both owners; that beats hiding it behind a digest.)rY)rUrps&&rIportable_mcp_server_namerrGs & !!rKc V^8dQhRRRR/#)rEvaluerArFr6rG)rHs"rIrJrJRs//6/c/rKca\S\4'dRPV3RlR44#SfR#\S4#)zFNormalize a manifest author value for the string PluginManifest field., c3z<"TF0pSPV4'gK\SV,4xK2 R#5iN)getr6)rgfrts& rIri"_display_author..Us*Y0H1EIIVWLU1X0Hs;;rc)remailurl) isinstancer rlr6)rtsfrI_display_authorrRs9%!!yyY0HYYY2.CJ.rKc(V^8dQhRRRRRRRR/#)rEdatar rUr6 field_namewhatrG)rHs"rIrJrJYs)'QTrKcVPV4pVe+\WS4'g\PRWV4R#V#)zVReturn ``data[field_name]`` when absent or of ``typ``; warn and return None otherwise.Nz"Plugin %s: %s must be %s; ignoring)ryr~loggerwarning)rrUrtyprraws&&&&& rI_manifest_field_of_typerYs8 ((: C z#33;SdS JrKc4V^8dQhRRRRRRRRRRR RR R /#) rErr rUr6rrcoercerwarnrFr>rG)rHs"rIrJrJbs@   s  3 PX `c hl rKc.p\WV\V4;'g.F8pV!V4pVf\PWQV4K'VP V4K: V#)zbCoerce each item of list field ``field_name``; ``coerce`` returning None warns ``warn`` and skips.)rr>rrappend) rrUrrrroutitemcoerceds &&&&&& rI_manifest_listrbsW C':tTJPPbP, ? NN4d + JJw  Q JrKc V^8dQhRRRR/#)rErrArFzOptional[dict[str, Any]]rG)rHs"rIrJrJnsF'?rKc.\V\4'dRVRR/#\V\4'dc\VPR4\4'd>VR,'d/VPR4pRVR,RVe \V4/#R/#R#)z]``{id, version_range}`` from a requires_plugins item (str shorthand ok); None when malformed.id version_rangeN)r~r6r ry)rvrs& rI_dependency_entryrns|$dOT22$  Z%D%Dd XXo &d4j/bn3r7WWRVWW rKc ,V^8dQhRRRRRRRRRR/#) rErrArUr6rfallback Optional[int]rFrG)rHs"rIrJrJxs0vCsmP]rKcx\V4# \\3d\P Y!T4Tu#i;i)z]``int(raw)``; a non-integer warns ``warn`` (formatted with key, raw) and yields ``fallback``.)r8 TypeError ValueErrorrr)rrUrrs&&&&rI _manifest_intrxs73x z "t#&s )99c$V^8dQhRRRRRR/#)rErUr6rrrFdict[str, Any]rG)rHs"rIrJrJs!#.rKc /p\V\4'dTM/P4Fwr4\V\4'g\P RW4K3VP R4pVeW\ V4P4\9d5\P RWVRP\\444\V4V\ V4&K V#)z``config_schema`` (key -> {type?, default?, description?, ...}) keeping only mapping entries; warns on what it drops or cannot type-check. Shared by ``plugin.yaml`` and ``plugin.json``.zPPlugin %s: config_schema entry %r must be a mapping (e.g. {type: str}); skippingtypezgPlugin %s: config_schema key %r declares unknown type %r (known: %s); type check will be skipped for itrv) r~r itemsrrryr6rmrCrlsortedr@)rUrschemaskeyspecstypes&& rI_config_schema_entriesrs F(g66sBEEG $(( NNbdg o    U!1!1!3;O!O NNA5$))F3G,H"I  !Js4yH MrKc$V^8dQhRRRRRR/#)rErr rUr6rFrrG)rHs"rIrJrJs!((G(#(.(rKcT\VPR^4VR^4pV\8d\P RW\4VPR4pVfRM \W1RR4p\ WRR\ R 4p\ WR R R R 4p\V\WR\R44p\WR\R4;'g.Uu.uFp\V4NK p p\\VP44\, 4p V 'd?V^8d\PM\P !RVRP#V 44RTRTRTR TRTR\VPR4;'gR4R\VPR4;'gR4RV /#uupi)zjValidate/normalize manifest v2 fields into PluginManifest kwargs (warnings, never failures). See #64165. r#z?Plugin %s: manifest_version %r is not an integer; treating as 1zrPlugin %s: manifest_version %d is newer than this Hermes supports (%d); loading anyway and ignoring unknown fieldsr$Nz5Plugin %s: api_version %r is not an integer; ignoringr%za listzjPlugin %s: requires_plugins entry %r must be a plugin id string or a {id, version_range} mapping; skippingr&za list of requirement stringsc~\V\4'd'VP4'dVP4#R#rx)r~r6rn)rs&rI+_parse_manifest_v2_fields..s)Zc%:%:tzz||TZZ\UQUUrKzXPlugin %s: python_dependencies entry %r must be a non-empty requirement string; skippingr'z a mappingr*zdPlugin %s: unknown manifest field(s) ignored: %s (newer manifest schema or typo; plugin still loads)rvr(rcr))rrySUPPORTED_MANIFEST_VERSIONrrrrrrr r>r6rsetkeysr5debugrl) rrUmvraw_apiapidepspydepsrtr*unknowns && rI_parse_manifest_v2_fieldsrs txx 2A6XZ[ ]B && HILRl hh}%G/$}Mt(UC  %x1B < D  (*IUbF $C)@O]dfq)r sF4ThW]][]] _]qCF]D _S%(>>?G7 4 BCF RYHZ B s4FNcekC0C0I0Ir,JC,223VT  `sF%c(V^8dQhRRRRRRRR/#)rE plugin_idr6rr settingsrF list[str]rG)rHs"rIrJrJs)c7gR[rKc .p\V\4'd\V\4'gV#VP4EFwrE\V\4'gKWB9d9VPR4'd RV9dVP RV RV R24K\VPR4pV'd-\ P\ V4P44MRpVfKW$,p\W4'd&\V\4'gK\V9gKVP RV RV RV R \V4P R 2 4EK V#) zReturn actionable warning strings for settings vs config_schema mismatches (never raises). Never raises; schema mismatches must not block plugin load (#64165). requireddefaultzplugins.entries.z .settings.z9 is required by the plugin's config_schema but is not setrNz should be z (got )) r~r rryrrCr6rmr<r__name__) rrrwarningsrrrexpectedrts &&& rIvalidate_config_schemars. H fg & &j7.K.Klln $((   xx ## (=&ykD6BCC  CH'++CJ,<,<,>?d   %**z%/F/F4W_K_ OO"9+Zv['U 4 45Q8 #%* OrKc V^8dQhRRRR/#)rE manifestszMapping[str, PluginManifest]rFrrG)rHs"rIrJrJs..)E.).rKcl^RIp\VP44p/pVF?pW,P'gKVP W,PV4KA VUu/uF qD\ 4bK ppVFpW,P Fp\V\4'dVPR4MRpV'gK6Wp9dTMVPV4pVf\PRWGV4KlW8Xd\PRV4KWT,PV4K K VPV4p V P4.p T P'4'd=\T P)44p T P+T 4T P,!T !KRT #uupi TPdhp \!T P"4^8dT P"^,M.p \PRRP%RT 444TuRp ? #Rp ? ii;i)aReturn plugin keys in dependency order: B before A when A requires B; alphabetical ties. A cycle warns and falls back to alphabetical order for all; a missing dependency warns once but never removes the dependent plugin (loads never hard-fail on advisory deps). See #64165. NrzPlugin %s requires plugin '%s' which is not enabled/installed; loading anyway (probe availability at runtime via ctx.has_plugin). Run `hermes plugins enable %s` if it is installed.z3Plugin %s declares a dependency on itself; ignoringz^Plugin dependency cycle detected (%s); falling back to alphabetical load order for all pluginsz -> c38"TFp\V4xK R#5irx)r6rgcs& rIri,resolve_plugin_load_order..sBYSXa3q66SXs)graphlibrrr setdefaultrr%r~r ryrraddTopologicalSorterprepare CycleErrorlenargsrl is_active get_readyextenddone)rrrby_namekedgesdepdep_idresolvedsorterexccycleorderedreadys& rIresolve_plugin_load_orderrs ).." #D G  <      y|00! 459!9DqSU(DE!9 <00C&0g&>&>SWWT]DF!'!4v'++f:MH^v  TVWX X&1" ' ' .FG     v'')*u U NC":*   "388}q0 b 67={{BYSXBY7Y  s%)F6F;;H3 AH.(H3.H3c V^8dQhRRRR/#)rE source_textr6rF Optional[str]rG)rHs"rIrJrJs  # - rKca\;QJdV3RlR 4F 'gK RM RM!V3RlR 44'dR#RS9d RS9dR#R#) aKind implied by source markers (mirrors plugins/memory ``_is_memory_provider_dir`` and plugins/cron_providers ``_is_cron_provider_dir``): memory-, cron- or computer-use-provider markers -> ``exclusive``; ``register_provider`` + ``ProviderProfile`` -> ``model-provider``; else ``None``. Keeps these kinds out of the general manager's eager import (its PluginContext has no ``register_cron_scheduler``, #62951).c3,<"TF qS9xK R#5irxrG)rgmarkerrs& rIri+_detect_kind_from_source..s F0EV[ 0EsTF exclusiveregister_providerProviderProfilemodel-providerN)register_memory_providerMemoryProviderregister_cron_scheduler CronSchedulerregister_computer_use_providerComputerUseProvider)any)rsfrI_detect_kind_from_sourcers[  s F0E Fsss F0E FFFk).?;.N rKc$V^8dQhRRRRRR/#)rEoriginrlimitr8rFr6rG)rHs"rIrJrJs!  ] 3 # rKc$V'd7VPR4'd \PPV4pV'dVPR4'gR#\ V4P RRR7RV# \ dR#i;i)z\First ``limit`` chars of a module's source (``.pyc`` mapped back to ``.py``); "" on failure..pyrc utf-8-sigreplace)encodingerrorsN)z.pycz.pyo)endswith importlibutilsource_from_cacher read_text Exception)rrs&&rI_read_source_from_originr st foo&677^^55f=FV__U33F|%%{9%MfuUU s"B=BB!B BBc V^8dQhRRRR/#)rE module_namer6rFrrG)rHs"rIrJrJ+s""s"}"rKcVPR4Uu.uFq'gK VNK ppV'gR#\PPV^,4pVeVP'gR#\ V4^8Xd VP#VP pV'gR#\VR,^R7FwrVR;rx\\V4Fnp W, R, WR,, rV P4'd\V 4W, .rM'V P4'gKc\V 4pM VfR#V\ V48XgVfVu#TpK R#uupi \dR#i;i)aMReturn a module's source path WITHOUT importing it, or ``None``. ``find_spec`` on a dotted name imports the parent package, so only the top-level name uses it; remaining segments are walked through ``submodule_search_locations`` by hand. Namespace/zipped/extension modules return ``None``. Shared with ``plugins/memory/__init__.py``..N:NN)start __init__.pyr) splitrr find_specrrsubmodule_search_locations enumeratemapris_filer6r) r ppartsr search_pathsipart found_origin next_pathsbasepkg_initmod_files & rIresolve_module_originr!+sH $))#. 4.1!QQ.E 4 ~~''a1 =E>c$V^8dQhRRRRRR/#)rEr r6rr8rFrG)rHs"rIrJrJPs&OOOCO3OrKc,\\V4V4#)zWFirst ``limit`` chars of a module's source without importing it ("" when unresolvable).)r r!)r rs&&rI_resolve_module_sourcer$Ps #$9+$F NNrKc V^8dQhRRRR/#)rEmanifestPluginManifestrFr6rG)rHs"rIrJrJUs))>)c)rKcBVP;'g VP#)zURegistry id of a manifest: the path-derived ``key`` when set, else the bare ``name``.)rUr)r&s&rI manifest_keyr)Us << ( (8==(rKc:]tRtRt$RtR]R&RtR]R&RtR]R&RtR]R&] !] R 7t R ]R &] !] R 7t R ]R &] !] R 7t R ]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&] !] R 7tR ]R&^tR]R&RtR]R&] !] R 7tR ]R!&] !] R 7tR ]R"&] !]R 7tR#]R$&RtR]R%&RtR]R&&] !] R 7tR ]R'&] !] R 7tR ]R(&] !] R 7t R ]R)&] !] R 7t!R ]R*&] !]R 7t"R+]R,&R-t#R#).r'iZz0Parsed representation of a plugin.yaml manifest.r6rrcrrr)default_factoryzlist[str | dict[str, Any]]rrrrsourceNrpath standalonerrUr0Fr<portableskill_namespacer+r8r#rr$zlist[dict[str, Any]]r%r&rr'r(r)r*r,r-r2zdict[str, dict[str, Any]]locale_metadatarG)$r __module__ __qualname____firstlineno____doc____annotations__rrrrr>rrrr,r-rrUr0r/r0r+r#r$r%r&r@r'r(r)r*r,r-r2r1__static_attributes__rGrKrIr'r'Zs`: IGSKFC/4T/JL,J %d ;NI; %d ;NI;FCD- D#CMOSHdOS$D9L)9c!%K%-24-H*H&+4%@@$)$$?M>?GSHcD1D)1T2E92t4GY4#("=i=16t1LO.LrKr'c$V^8dQhRRRRRR/#)rErrrUr6rFz+tuple[list[str], dict[str, dict[str, Any]]]rG)rHs"rIrJrJs"   # 7b rKc2^RIHpHp.p/pVfWE3#\V\\ 34'dV.p\V\ 4'g.\PRV\V4P4WE3#VEFp/p\V\ 4'dV!VPRR44p\VPR4\4'd8VR,P4'dVR,P4VR&RV9d\VR,4VR&MV!V4pV!V4'g\PRW4KW9d\PRW4KVPV4V'gEKWuV&EK WE3#) z``provides_locales`` -> (ids, metadata). Entries are ``"pl"`` or ``{id: pl, endonym: Polski, rtl: false}``; ids are canonicalised (lowercase, ``_`` -> ``-``), invalid or duplicate ones are dropped with a warning.)is_language_idnormalize_language_idzBPlugin %s: provides_locales must be a list of language ids, got %srrcendonymrtlz5Plugin %s: ignoring invalid provides_locales entry %rz.Plugin %s: duplicate provides_locales entry %r)agent.i18n_layersr:r;r~r6r r>rrrrryrnr<r) rrUr:r;idsmetadatar entry_metalang_ids && rIparse_provides_localesrCsXHC*,H {}#W~&&e c4 []`bfgjbkbtbtu}%' dG $ $+DHHT2,>?G$((9-s33Y8M8M8O8O(,Y(=(=(? 9%}$(e$5 5!+D1Gg&& NNRTW ^  > NNKS Z  7 : *W %& =rKz!^\s*(>=|<=|==|!=|>|<)\s*(.+?)\s*$cV^8dQhRR/#)rErFr6rG)rHs"rIrJrJs+++rKc0^RIHpV!4P#)z8Base release version of the Hermes code that is running.get_version_info)hermes_cli.version_inforG base_versionrFs rIrunning_hermes_versionrJs8   * **rKz^\d+c V^8dQhRRRR/#)rEvr6rFzOptional[tuple]rG)rHs"rIrJrJs  c o rKc\P!R\V4P4P R4^4^,PR4pVR.^\ V4, ,, p.pVR,FVp\ PVP44pVfR#VP\VP^444KX \V4#)u``v1.2.3-rc1`` / ``1.2.3rc1`` / ``1.2.3.post1`` → ``(1, 2, 3)``; ``None`` when a segment has no leading digits. PEP 440 pre/post/dev suffixes glued to a segment (``0rc1``) are dropped so an rc *target* still gates and an rc *running* version does not disable every gate.z[-+]rLr 0:NNN) rerr6rnlstripr_VERSION_SEGMENT_REmatchrr8grouptuple)rLrrxms& rI_version_tuplerXs HHWc!flln33C8! =``/``>``/``<=``/``<``/``==``/``!=`` clauses (comma = AND; bare version = ``>=``). Unparseable versions are permissive — no PEP 440 dependency for a one-field manifest gate.NTz>=z<=z==z!=>.sC?a ?s,F) rX__ge____le____eq____ne____gt____lt__filterr_VERSION_COMPARATOR_RErSrT) rrZcuropsclauserWoptargettgts && rIversion_satisfiesros  !C { T3::tSZZszzSVX[XbXbdgilisis tCC4::c?CD " ( ( 012aggaj!''!*-v V$ ?373<< E rKc V^8dQhRRRR/#)rEr&r'rFrrG)rHs"rIrJrJs88N8}8rKc\V\4'dVPRR4M VPpV'gR#\ 4p\ W4'dR#RV RV 2#)zYLoad-blocking reason when the manifest's ``requires_hermes`` rejects the running version.r0rcNzrequires hermes z , running )r~r ryr0rJro)r&rrZs& rIrequires_hermes_errorrrsW2>  ! ! #lD && P 499V,?%@A ]*I |d 2y7G7G7I7I i #--Y-UV[\K/ backendplatformrr.r)i )rc)M__conditional_annotations__r5 __future__rrZimportlib.utilrloggingrP contextlibr dataclassesrrpathlibrtypingrrr r r r r rrutilsrhermes_cli.plugin_capabilitiesrr hermes_yamlr ImportError getLoggerrrr6r5rr6r8r:r<r>r@rCrRr`rYrrrrrrrrrrrrr r!r$r)r'rCcompilerhrJrRrXrorrr~rr)rs@rIrs # (RRR f   / 0 dXd $ $ $$$&.$0>$@P$Rb$ $ $$,$.9$;R$$5$7O$ $& $(: $M $ OV $ C68cVUSFIvwQTV[P\ sElFTGY$RY\`[b TGXw sf *&" +( "/ ((V@.b  "JO )  5M5M 5Mp H$HI+jj)   8 ,#{ DsG GG