+ i;ZRt^RIt^RIt^RIt^RIt^RIHt^RIHtH t H t H t H t H t ^RIHt]P !]4tRRRRRR /t]!R'4tRsR R ltR R ltRRltR(RRlltRRltRRltRRltRRltRRltRRlt Rt!RR lt"R!R"lt#R#R$lt$R%R&lt%R#))aLightweight skill metadata utilities shared by prompt_builder and skills_tool. This module intentionally avoids importing the tool registry, CLI config, or any heavy dependency chain. It is safe to import at module level without triggering tool registration or provider resolution. N)Path)AnyDictListOptionalSetTuple)get_hermes_homemacosdarwinlinuxwindowswin32c$V^8dQhR\/#)contentstr)formats"./home/ubuntu/hermes-agent/agent/skill_utils.py __annotate__r"s " "s "caa\f2^RIo\SRR4;'g SPoRVV3RllpVs\V4#)z7Parse YAML with lazy import and CSafeLoader preference.N CSafeLoaderc$V^8dQhR\/#)rvaluer)rs"rryaml_load..__annotate__*s 3 3 3rc*<SPVSR7#))Loader)load)rloaderyamls&r_loadyaml_load.._load*s99U692 2r) _yaml_load_fnr!getattr SafeLoader)rr"r r!s& @@r yaml_loadr'"sD}d3FFt 3 3  !!rctV^8dQhR\R\\\\3,\3,/#)rrreturn)rrrr)rs"rrr4s,""s"uT#s(^S-@'A"rc0/pTpVPR4'gW3#\P!RVR,4pV'gW3#V^VP4^,pWP 4^,Rp\ V4p\ V\4'dTpW3# \diTP4PR4F@pRT9dK TPR^4wrxTP4YP4&KB Y3#i;i)zParse YAML frontmatter from a markdown string. Uses yaml with CSafeLoader for full YAML support (nested metadata, lists) with a fallback to simple key:value splitting for robustness. Returns: (frontmatter_dict, remaining_body) z---z \n---\s*\n:NNN :) startswithresearchstartendr' isinstancedict Exceptionstripsplit) r frontmatterbody end_match yaml_contentparsedlinekeyrs & rparse_frontmatterr?4s #%K D   e $ $   -5I   1y0145L ==?Q&( )D 5<( fd # # K   5 &&(..t4D$C+JC',{{}K $ 5  5s<#B""A.DDcRV^8dQhR\\\3,R\/#rr8r))rrrbool)rs"rrr\s"S#X4rcLVPR4pV'gR#\V\4'gV.p\PpVFYp\ V4P 4P4p\PWD4pVPV4'gKXR# R#)arReturn True when the skill is compatible with the current OS. Skills declare platform requirements via a top-level ``platforms`` list in their YAML frontmatter:: platforms: [macos] # macOS only platforms: [macos, linux] # macOS and Linux If the field is absent or empty the skill is compatible with **all** platforms (backward-compatible default). platformsTF) getr3listsysplatformrlowerr6 PLATFORM_MAPr.)r8rDcurrentrH normalizedmappeds& rskill_matches_platformrN\s ,I  i & &K llG]((*002 !!*9   f % %  rcTV^8dQhR\R,R\\,/#)rrHNr))rr)rs"rrrys"&=&=sTz&=SX&=rc\4R, pVP4'g \4#\VP RR74p\T\4'g \4#TPR4p\T\4'g \4#T;'g5\P!R4;'g\P!R4pT'd:TPR 4;'g/PT4pTe \T4#\TPR 44# \ d+p\ PRY4\4uRp?#Rp?ii;i) auRead disabled skill names from config.yaml. Args: platform: Explicit platform name (e.g. ``"telegram"``). When *None*, resolves from ``HERMES_PLATFORM`` or ``HERMES_SESSION_PLATFORM`` env vars. Falls back to the global disabled list when no platform is determined. Reads the config file directly (no CLI config imports) to stay lightweight. config.yamlutf-8encodingz"Could not read skill config %s: %sNskillsHERMES_PLATFORMHERMES_SESSION_PLATFORMplatform_disableddisabled)r existssetr' read_textr5loggerdebugr3r4rEosgetenv_normalize_string_set)rH config_pathr<e skills_cfgresolved_platformrXs& rget_disabled_skill_namesrfys/"#m3K     u ;00'0BC fd # #u H%J j$ ' 'u   0 0 99& ' 0 0 99. / '^^,?@FFBKK    (():; ;  !; <<+  9;Ju sD88 E-E("E-(E-c:V^8dQhR\\,/#rr))rr)rs"rrrs>>SX>rcVf \4#\V\4'dV.pVUu0uF=p\V4P4'gK$\V4P4kK? up#uupiN)r[r3rr6)valuesvs& rrarasR ~u &#$* =Fqc!fllnNCFLLNF == =s !A2A2c:V^8dQhR\\,/#rhrr)rs"rrrs22$t*2rc\4R, pVP4'g.#\VPRR74p\ T\ 4'g.#TPR4p\ T\ 4'g.#TPR4pT'g.#\ T\4'dT.p\ T\4'g.#\4R, P4p\4p.pTFp\T4P4pT'gK&\PP\PP!T44p\#T4P4p Y8XdKY9dKT P%4'd%TP'T 4TP)T 4K\*P-RT 4K T# \d.u#i;i)a,Read ``skills.external_dirs`` from config.yaml and return validated paths. Each entry is expanded (``~`` and ``${VAR}``) and resolved to an absolute path. Only directories that actually exist are returned. Duplicates and paths that resolve to the local ``~/.hermes/skills/`` are silently skipped. rQrRrSrU external_dirsz0External skills dir does not exist, skipping: %s)r rZr'r\r5r3r4rErrFresolver[r6r_path expanduser expandvarsris_diraddappendr]r^) rbr<rdraw_dirs local_skillsseenresultentryexpandedps rget_external_skills_dirsrs"#m3K      ;00'0BC fd # # H%J j$ ' ' ~~o.H  (C  : h % % #%099;LeDFE   " 77%%bgg&8&8&?@ N " " $   9  88:: HHQK MM!  LLKQ O" MM  sG!! G10G1c:V^8dQhR\\,/#rhrn)rs"rrrsT$Zrc\\4R, .pVP\44V#)uReturn all skill directories: local ``~/.hermes/skills/`` first, then external. The local dir is always first (and always included even if it doesn't exist yet — callers handle that). External dirs follow in config order. rU)r extendr)dirss rget_all_skills_dirsrs)   ( )DKK(*+ KrctV^8dQhR\\\3,R\\\3,/#rArrrr)rs"rrrs*$sCx.T#t)_rc NVPR4p\V\4'g/pVPR4;'g/p\V\4'g/pRVPR.4RVPR.4RVPR.4RVPR.4/#)z>Extract conditional activation fields from parsed frontmatter.metadatahermesfallback_for_toolsetsrequires_toolsetsfallback_for_toolsrequires_tools)rEr3r4)r8rrs& rextract_skill_conditionsrsz*H h % % \\( # ) )rF fd # #,CR!HVZZ(;R@fjj)=rB&**%5r:  rcV^8dQhR\\\3,R\\\\3,,/#rAr)rs"rrrs/884S>8d4S>>R8rcVPR4p\V\4'g.#VPR4p\V\4'g.#VPR4pV'g.#\V\4'dV.p\V\4'g.#.p\ 4pVEFp\V\4'gK\ VPRR44P 4pV'dWu9dKU\ VPRR44P 4pV'gKRVRV/p VPR4p V eWR&VPR4p \V \ 4'd+V P 4'dV P 4V R&MWR&VPV4VPV 4EK! V#) aExtract config variable declarations from parsed frontmatter. Skills declare config.yaml settings they need via:: metadata: hermes: config: - key: wiki.path description: Path to the LLM Wiki knowledge base directory default: "~/wiki" prompt: Wiki directory path Returns a list of dicts with keys: ``key``, ``description``, ``default``, ``prompt``. Invalid or incomplete entries are silently skipped. rrconfigr> descriptiondefaultprompt) rEr3r4rFr[rr6rvrw) r8rrrawr{rzitemr>descr|r prompt_texts & rextract_skill_config_varsrs z*H h % % \\( #F fd # # **X C  #te c4  #%FD$%% $((5"%&,,.ck 488M2./557  3 4! ((9%  &) hhx( k3 ' 'K,=,=,?,?)//1E(O"(O   e/0 Mrc\V^8dQhR\\\\3,,/#rhrrrr)rs"rrr?s $$T#s(^(<$rcl.p\4p\4p\4FpVP4'gK\ VR4FpVP RR7p\ V4wrgTPR4;'gTPPp\T4T9dKd\T4'gKw\T4p T FJp T R,T9gK\T4T R&TPT 4TPT R,4KL K K V# \dKi;i)aEScan all enabled skills and collect their config variable declarations. Walks every skills directory, parses each SKILL.md frontmatter, and returns a deduplicated list of config var dicts. Each dict also includes a ``skill`` key with the skill name for attribution. Disabled and platform-incompatible skills are excluded. zSKILL.mdrRrSnamer>skill)r[rfrruiter_skill_index_filesr\r?r5rEparentrrrNrrwrv) all_vars seen_keysrY skills_dir skill_filerr8_ skill_name config_varsvars rdiscover_all_skill_config_varsr?s&(HUI')H)+   "" 0ZHJ  **G*<!23!7 %0JJJ4E4E4J4JJ:(*)+663K@K"u:Y.#&z?CLOOC(MM#e*- #I,. O!  s D$$ D32D3z skills.configcRV^8dQhR\\\3,R\/#)rr dotted_keyrrr)rs"rrrls"  T#s(^  rcVPR4pTpVF*p\V\4'dWC9d W4,pK)R# V#)zPWalk a nested dict following a dotted key. Returns None if any part is missing..N)r7r3r4)rrpartsrKparts&& r_resolve_dotpathrlsC   S !EG gt $ $mG  NrcV^8dQhR\\\\3,,R\\\3,/#)rrr)r)rs"rrrxs1##d38n%# #s(^#rc\4R, p/pVP4'd5\VPRR74p\ V\ 4'dTp/pVFpVR,p\ RV 2p\W'4pVe-\ V\4'd)VP4'gVPRR4p\ V\4'dKRV9gR V9d=\PP\PPV44pWV&K V# \ dLi;i) aBResolve current values for skill config vars from config.yaml. Skill config is stored under ``skills.config.`` in config.yaml. Returns a dict mapping **logical** keys (as declared by skills) to their current values (or the declared default if the key isn't set). Path values are expanded via ``os.path.expanduser``. rQrRrSr>rrr~z${)r rZr'r\r3r4r5SKILL_CONFIG_PREFIXrrr6rEr_rrrsrt) rrbrr<resolvedr logical_key storage_keyrs & rresolve_skill_config_valuesrxs"#m3KF {44g4FGF&$'' "H%j ,-Q{m<  5 =Zs33EKKMMGGIr*E eS ! !se|tu}GG&&rww'9'9%'@AE % O%   s3D00 D>=D>cRV^8dQhR\\\3,R\/#rAr)rs"rrrs"4S>crcVPRR4pV'gR#\V4P4PR4p\V4^<8dVR,R,#V#)z8Extract a truncated description from parsed frontmatter.rrz'":N9Nz...)rErr6len)r8raw_descrs& rextract_skill_descriptionrsT}b1H  x=   & &u -D 4y2~Cy5  Krc0V^8dQhR\R\/#)rrfilename)rr)rs"rrrs  t s rc#*a".p\P!S4FPwr4pVUu.uFqf\9gKVNK upVR&W9gK/VP\ V4V, 4KR \ VV3RlR7FpVxK R#uupi5i)zrWalk skills_dir yielding sorted paths matching *filename*. Excludes ``.git``, ``.github``, ``.hub`` directories. :NNNc8<\VPS44#rj)r relative_to)r~rs&r(iter_skill_index_files..sc!-- 2K.Lr)r>N)r_walkEXCLUDED_SKILL_DIRSrwrsorted)rrmatchesrootrfilesdrrsf& rrrs GWWZ0E"Cd/B&B11dCQ   NN4:0 11w$LM NDs#B BB B AB)z.gitz.githubz.hubrj)&__doc__loggingr_r/rGpathlibrtypingrrrrrrhermes_constantsr getLogger__name__r]rJ frozensetrr$r'r?rNrfrarrrrrrrrrrrrrs 88,   8 $  X W w  ;<  "$"P:&=R>2j(8v$T& #R r