ei>dZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z m Z ddlmZmZejeZdddd Zed Zdad efd Zd ed e e eefeffdZde eefd efdZd(dedzd e efdZd e efdZd e efdZd e efdZ de eefd e ee ffdZ!de eefd e e eeffdZ"d e e eeffdZ#dZ$de eefdefdZ%de e eefd e eeffdZ&de eefd efdZ'd ed!efd"Z(ej)d#Z*d$ed e e eeffd%Z+d&e ed efd'Z,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_config_pathget_skills_dirdarwinlinuxwin32)macosr windows)z.gitz.githubz.hubcontentct,ddltddpjdtffd }|at|S)z7Parse YAML with lazy import and CSafeLoader preference.Nr CSafeLoadervaluec2|S)N)Loader)load)rloaderyamls 3/home/div/.hermes/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_frontmatterr94s[#%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%r2cV|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-listsysplatformr lowerr0 PLATFORM_MAPr()r2r;currentr? normalizedmappeds rskill_matches_platformrE\s ,,I t i & & K lG]]((**0022 !!*j99   f % % 44  5rr?ct}|stS t|d}nA#t $r4}t d||tcYd}~Sd}~wwxYwt|tstS| d}t|tstSddl m }|ptjdp |d }|r;| d pi |}|t|St| d S) aRead 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. utf-8encodingz"Could not read skill config %s: %sNskillsr)get_session_envHERMES_PLATFORMHERMES_SESSION_PLATFORMplatform_disableddisabled)r existssetr! read_textr/loggerdebugr-r.r<gateway.session_contextrKosgetenv_normalize_string_set)r? config_pathr6e skills_cfgrKresolved_platformrNs rget_disabled_skill_namesr]ys"##K     uu ;00'0BBCC  9;JJJuu  fd # #uu H%%J j$ ' 'uu 777777 6 9& ' ' 6 ?4 5 5 <'^^,?@@FBKK     (():;; ;  !;!; < <z(_normalize_string_set..s9 = = =qc!ffllnn =CFFLLNN = = =r)rQr-r )valuess rrXrXs= ~uu &# = =F = = ==rc t}|sgS t|d}n#t$rgcYSwxYwt |t sgS|d}t |t sgS|d}|sgSt |tr|g}t |tsgSt }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. rGrHrJ external_dirsz0External skills dir does not exist, skipping: %s)r rPr!rRr/r-r.r<r r=r resolverQr0rVpath expanduser expandvarsris_diraddappendrSrT) rYr6r[raw_dirs local_skillsseenresultentryexpandedps rget_external_skills_dirsrus"##K      ;00'0BBCC   fd # # H%%J j$ ' ' ~~o..H  (C  : h % % !##++--LeeDFPPE   ""  7%%bg&8&8&?&?@@ NN " " $ $    99  88:: P HHQKKK MM!     LLKQ O O O O Ms#A AAcftg}|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. )r extendru)dirss rget_all_skills_dirsrys0    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)r}r~rr)r<r-r.)r2r{r|s rextract_skill_conditionsrsz**H h % % \\( # # )rF fd # #!',CR!H!H#ZZ(;R@@$jj)=rBB **%5r::   rc|d}t|tsgS|d}t|tsgS|d}|sgSt|tr|g}t|tsgSg}t }|D]3}t|tst |dd}|r||vrUt |dd}|s||d} |d} | | | d<|d } t| t r,| r| | d <n|| d <|||| 5|S) 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. r{r|configr8 description)r8rdefaultNprompt) r<r-r.r=rQr r0rlrm) r2r{r|rawrqrpitemr8descrrr prompt_texts rextract_skill_config_varsrs z**H h % % \\( # #F fd # # **X  C  #te c4  #%FD$%%  $((5"%%&&,,.. cTkk 488M2..//5577  ! ! ((9%%  &E) hhx(( k3 ' ' #K,=,=,?,? #)//11E(OO"E(O   e Mrcrg}t}t}tD]}|st |dD]} |d}t |\}}n#t$rY8wxYw|dp |j j }t||vrot|st|} | D]N} | d|vrBt|| d<|| || dO |S)aYScan 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.mdrGrHnamer8skill)rQr]ryrkiter_skill_index_filesrRr9r/r<parentrr rErrmrl) all_vars seen_keysrO skills_dir skill_filerr2_ skill_name config_varsvars rdiscover_all_skill_config_varsr@si&(HUUI'))H)++..   ""  0ZHH . .J  **G*<<!23!7!7 QQ    %00JJ4E4JJ:(**)+66 3K@@K" . .u:Y..#&z??CLOOC(((MM#e*---  . .( Os(B B Bz skills.configr dotted_keyc|d}|}|D]&}t|tr ||vr ||}$dS|S)zPWalk a nested dict following a dotted key. Returns None if any part is missing..N)r1r-r.)rrpartsrBparts r_resolve_dotpathrmsZ   S ! !EG gt $ $ dmGG44 Nrrczt}i}|rL t|d}t |t r|}n#t $rYnwxYwi}|D]}|d}td|}t||}|)t |tr*| s| dd}t |trDd|vsd |vr`` 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``. rGrHr8rNrr~z${)r rPr!rRr-r.r/SKILL_CONFIG_PREFIXrr r0r<rVrhrirj) rrYrr6resolvedr logical_key storage_keyrs rresolve_skill_config_valuesrysR"##KF {44g4FFGGF&$''     D  "H & &%j ,<<{<<  55 =Zs33=EKKMM=GGIr**E eS ! ! Bse||tu}}G&&rw'9'9%'@'@AAE % Os:A!! A.-A.c|dd}|sdSt|d}t|dkr |dddzS|S)z8Extract a truncated description from parsed frontmatter.rrz'"<N9z...)r<r r0len)r2raw_descrs rextract_skill_descriptionrsn}b11H r x==   & &u - -D 4yy2~~CRCy5  Krrfilenamec#Kg}tjdD]@\}}}d|D|dd<||vr%|t||z At |fdD]}|VdS)zzWalk skills_dir yielding sorted paths matching *filename*. Excludes ``.git``, ``.github``, ``.hub`` directories. T) followlinksc$g|] }|tv |Sr`)EXCLUDED_SKILL_DIRS)rads r z*iter_skill_index_files..s#CCCa/B&B&B1&B&B&BrNcHt|SN)r relative_to)rtrs rz(iter_skill_index_files..sc!-- 2K2K.L.Lr)r8)rVwalkrmrsorted)rrmatchesrootrxfilesrhs` rrrs GWZTBBB22dECCdCCCQQQ u   NN4::0 1 1 1w$L$L$L$LMMM rz^[a-zA-Z0-9_-]+$rcXd|vrd|fSt|ddS)z~Split ``'namespace:skill-name'`` into ``(namespace, bare_name)``. Returns ``(None, name)`` when there is no ``':'``. r&Nr')tupler1)rs rparse_qualified_namers3  $Tz C## $ $$r candidatecX|sdStt|S)zDCheck whether *candidate* is a valid namespace (``[a-zA-Z0-9_-]+``).F)bool _NAMESPACE_REmatch)rs ris_valid_namespacers+ u  ##I.. / //rr)-__doc__loggingrVr)r>pathlibrtypingrrrrrr hermes_constantsr r getLogger__name__rSrA frozensetrrr r!r9rrEr]rXruryrrrrrrrrcompilerrrr`rrrs 8888888888888888<<<<<<<<  8 $ $    i ;<<  "s " " " "$"s"uT#s(^S-@'A""""PS#X4:'='=sTz'=SX'='='='=T>SX>>>>2$t*2222jT$Z$sCx.T#t)_(84S>8d4S>>R8888v$T#s(^(<$$$$T& T#s(^     #d38n%# #s(^####R4S>c t s      .// %s%uXc]C-?'@%%%%0(3-0D000000r