Ji%dZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z m Z ddlmZejeZdddd Zed Zdad efd Zd ed e e eefeffdZde eefd efdZd e efdZd e efdZd e efdZd e efdZde eefd e ee ffdZ de eefd efdZ!dedefdZ"dS)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_homedarwinlinuxwin32)macosr windows)z.gitz.githubz.hubcontentct,ddltddpjdtffd }|at|S)z7Parse YAML with lazy import and CSafeLoader preference.Nr CSafeLoadervaluec2|S)N)Loader)load)rloaderyamls ./home/ubuntu/hermes-agent/agent/skill_utils.py_loadzyaml_load.._load*s99U6922 2) _yaml_load_fnrgetattr SafeLoaderstr)rrrrs @@r yaml_loadr "sl }d33Ft 3 3 3 3 3 3 3 3  ! !!rreturncXi}|}|ds||fStjd|dd}|s||fS|d|dz}||dzd} t |}t |tr|}n#t$rt| dD]I}d|vr| dd\}}| || <JYnwxYw||fS)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*\nN :) startswithresearchstartendr isinstancedict Exceptionstripsplit) r frontmatterbody end_match yaml_contentparsedlinekeyrs rparse_frontmatterr84s[#%K D   e $ $!D   -55I !D  1y001445L 9==??Q&(( )D 5<(( fd # # ! K 555 &&((..t44 5 5D$C++JC',{{}}K $ $  5 55  s&B''A;D%$D%r1cV|d}|sdSt|ts|g}tj}|D]h}t |}t||}| |rdSidS)aReturn 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) getr,listsysplatformrlowerr/ PLATFORM_MAPr')r1r:currentr> normalizedmappeds rskill_matches_platformrD\s ,,I t i & & K lG]]((**0022 !!*j99   f % % 44  5rctdz }|stS t|d}nA#t $r4}t d||tcYd}~Sd}~wwxYwt|tstS| d}t|tstStj d}|r;| dpi |}|t|St| d S) zRead disabled skill names from config.yaml. Resolves platform from ``HERMES_PLATFORM`` env var, falls back to the global disabled list. Reads the config file directly (no CLI config imports) to stay lightweight. config.yamlutf-8encodingz"Could not read skill config %s: %sNskillsHERMES_PLATFORMplatform_disableddisabled)r existssetr read_textr.loggerdebugr,r-r;osgetenv_normalize_string_set) config_pathr5e skills_cfgresolved_platformrLs rget_disabled_skill_namesrZys]"##m3K     uu ;00'0BBCC  9;JJJuu  fd # #uu H%%J j$ ' 'uu  "344<'^^,?@@FBKK     (():;; ;  !;!; < <z(_normalize_string_set..s9 = = =qc!ffllnn =CFFLLNN = = =r)rOr,r)valuess rrUrUs= ~uu &# = =F = = ==rctdz }|sgS t|d}n#t$rgcYSwxYwt |t sgS|d}t |t sgS|d}|sgSt |tr|g}t |tsgStdz }t}g}|D]}t| }|s&tjtj|}t#| } | |kr| |vr| r+|| || t*d| |S)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. rFrGrHrJ external_dirsz0External skills dir does not exist, skipping: %s)r rNr rPr.r,r-r;rr<resolverOr/rSpath expanduser expandvarsris_diraddappendrQrR) rVr5rXraw_dirs local_skillsseenresultentryexpandedps rget_external_skills_dirsrrs"##m3K      ;00'0BBCC   fd # # H%%J j$ ' ' ~~o..H  (C  : h % % #%%099;;LeeDFPPE   ""  7%%bg&8&8&?&?@@ NN " " $ $    99  88:: P HHQKKK MM!     LLKQ O O O O Ms#A AAcltdz g}|t|S)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. rJ)r extendrr)dirss rget_all_skills_dirsrvs5    ( )DKK(**+++ Krcd|d}t|tsi}|dpi}t|tsi}|dg|dg|dg|dgdS)z>Extract conditional activation fields from parsed frontmatter.metadatahermesfallback_for_toolsetsrequires_toolsetsfallback_for_toolsrequires_tools)rzr{r|r})r;r,r-)r1rxrys rextract_skill_conditionsr~sz**H h % % \\( # # )rF fd # #!',CR!H!H#ZZ(;R@@$jj)=rBB **%5r::   rc|dd}|sdSt|d}t|dkr |dddzS|S)z8Extract a truncated description from parsed frontmatter. descriptionz'"<N9z...)r;rr/len)r1raw_descdescs rextract_skill_descriptionrsn}b11H r x==   & &u - -D 4yy2~~CRCy5  Kr skills_dirfilenamec#Kg}tjD]@\}}}d|D|dd<||vr%|t||z At |fdD]}|VdS)zzWalk skills_dir yielding sorted paths matching *filename*. Excludes ``.git``, ``.github``, ``.hub`` directories. c$g|] }|tv |Sr])EXCLUDED_SKILL_DIRS)r^ds r z*iter_skill_index_files..s#CCCa/B&B&B1&B&B&BrNcHt|S)N)r relative_to)rqrs rz(iter_skill_index_files..sc!-- 2K2K.L.Lr)r7)rSwalkrjrsorted)rrmatchesrootrufilesres` riter_skill_index_filesr s GWZ0022dECCdCCCQQQ u   NN4::0 1 1 1w$L$L$L$LMMM r)#__doc__loggingrSr(r=pathlibrtypingrrrrrr hermes_constantsr getLogger__name__rQr@ frozensetrrrr r8boolrDrZrUrrrvr~rrr]rrrsL 8888888888888888,,,,,,  8 $ $    i ;<<  "s " " " "$"s"uT#s(^S-@'A""""PS#X4:=#c(====@>SX>>>>2$t*2222jT$Z$sCx.T#t)_(4S>c t s      r