i@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.hubz.archivecontentct,ddltddpjdtffd }|at|S)z7Parse YAML with lazy import and CSafeLoader preference.Nr CSafeLoadervaluec2|S)N)Loader)load)rloaderyamls 6/home/ubuntu/.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 = = ==rct}|sgS t|d}n#t$rgcYSwxYwt |t sgS|d}t |t sgS|d}|sgSt |tr|g}t |tsgSddl m }|}t }t}g}|D]} t| } | s't jt j| } t)| } | s|| z } n| } | |kr| |vr| r+|| || t2d| |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_dirsr)get_hermes_homez0External skills dir does not exist, skipping: %s)r rPr!rRr/r-r.r<r r=hermes_constantsrgr resolverQr0rVpath expanduser expandvarsr is_absoluteis_diraddappendrSrT) rYr6r[raw_dirsrg hermes_home local_skillsseenresultentryexpandedps rget_external_skills_dirsrysE"##K      ;00'0BBCC   fd # # H%%J j$ ' ' ~~o..H  (C  : h % % 000000!/##K!##++--LeeDFPPE   ""  7%%bg&8&8&?&?@@ NN}} q))++AA A    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 extendry)dirss rget_all_skills_dirsr}s0    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)rrrr)r<r-r.)r2rrs 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. rrconfigr8 description)r8rdefaultNprompt) r<r-r.r=rQr r0rorp) r2rrrawrurtitemr8descrvr prompt_texts rextract_skill_config_varsr s 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]r}rniter_skill_index_filesrRr9r/r<parentrr rErrpro) all_vars seen_keysrO skills_dir skill_filerr2_ skill_name config_varsvars rdiscover_all_skill_config_varsrHsi&(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_dotpathrusZ   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<rVrjrkrl) rrYrr6resolvedr logical_key storage_keyrs rresolve_skill_config_valuesrsR"##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)zWalk skills_dir yielding sorted paths matching *filename*. Excludes ``.git``, ``.github``, ``.hub``, ``.archive`` 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)rxrs rz(iter_skill_index_files..sc!-- 2K2K.L.Lr)r8)rVwalkrprsorted)rrmatchesrootr|filesrjs` 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 rhr r getLogger__name__rSrA frozensetrrr r!r9rrEr]rXryr}rrrrrrrrcompilerrrr`rrrs 8888888888888888<<<<<<<<  8 $ $    i GHH  "s " " " "$"s"uT#s(^S-@'A""""PS#X4:'='=sTz'=SX'='='='=T>SX>>>>:$t*::::zT$Z$sCx.T#t)_(84S>8d4S>>R8888v$T#s(^(<$$$$T& T#s(^     #d38n%# #s(^####R4S>c t s      .// %s%uXc]C-?'@%%%%0(3-0D000000r