ei8UdZddlZddlZddlZddlmZddlmZmZm Z ddl m Z ddl m ZmZmZejeZiaeeeeeffed<ejdZejd Zd d ed edzd eeeefedzefdzfd Zdeeefdeed dfdZ d!deeefdedzdededededzd efdZ!d eeeeefffdZ"d eeeeefffdZ#ded e efdZ$ d"deded edzded e ef dZ% d deed edzd eeeeeeffdZ&dS)#zShared slash command helpers for skills. Shared between CLI (cli.py) and gateway (gateway/run.py) so both surfaces can invoke skills via /skill-name commands. N)Path)AnyDictOptional)display_hermes_home)expand_inline_shellload_skills_configsubstitute_template_vars_skill_commandsz [^a-z0-9-]z-{2,}skill_identifiertask_idreturnch|pd}|sdS ddlm}m}t |}|rZ t| |}n'#t$r|}YnwxYw| d}tj |||d}n#t$rYdSwxYw|dsdSt|d p|}t|d pd} d} |d } | rt | } n-| r+ |t | jz } n#t$rd} YnwxYw|| |fS) zOLoad a skill by name/path and return (loaded_payload, skill_dir, display_name).Nr) SKILLS_DIR skill_view/F)r preprocesssuccessnamepath skill_dir)striptools.skills_toolrrr expanduser is_absolutestrresolve relative_to Exceptionlstripjsonloadsgetparent) r r raw_identifierrridentifier_path normalized loaded_skill skill_name skill_pathr abs_skill_dirs 6/home/div/.hermes/hermes-agent/agent/skill_commands.py_load_skill_payloadr.s&,"3355N t<<<<<<<<~..99;;  & & ( ( 4 , !8!8!:!:!F!FzGYGYG[G[!\!\]]  , , ,+  ,(..s33Jz Jz7u E E E   tt   I & &t\%%f--;<#e***;K LL3c33k33 4 4 4 4 S U      s%AC= C=& C=5BC== D  D rractivation_noteuser_instruction runtime_note session_idcddlm}t|dpd}t }|ddrt |||}|ddr6t |d d pd } t||| }|d|g} |rC| d| d |d | d t|| |dr| ddgn|dr"| dd|dd gnK|dr6|dr!| dd|dd gg} |dpi} | D],} t| tr| | -| s|rdD]}||z }|rt!|dD]a}|rK|s7t||}| |b| r|r t||}n#t*$r |j}YnwxYw| d| d| D] }| d|d||z !| d|d|d|r-| d| d||r.| d| d|d d| S) z9Format a loaded skill into a user/system message payload.r)rr5r template_varsT inline_shellFinline_shell_timeout z[Skill directory: r6zResolve any relative paths in this skill (e.g. `scripts/foo.js`, `templates/config.yaml`) against that directory, then run them with the terminal tool using the absolute path. setup_skippedz[Skill setup note: Required environment setup was skipped. Continue loading the skill and explain any reduced functionality if it matters.]gateway_setup_hintz[Skill setup note: setup_needed setup_note linked_files) references templatesscriptsassets*z"[This skill has supporting files:]z- z -> z) Load any of these with skill_view(name="zM", file_path=""), or run scripts directly by absolute path (e.g. `node z/scripts/foo.js`).zPThe user has provided the following instruction alongside the skill invocation: z[Runtime note:  )rrrr$_load_skills_config_substitute_template_varsint_expand_inline_shellrr9rCr:values isinstancelistexistssortedrglobis_file is_symlinkr ValueErrorrjoin)r)rrDrErFrGrr5 skills_cfgtimeoutr/ supportingrQentriessubdir subdir_pathfrelskill_view_targetsfs r-_build_skill_messagerpps-,,,,,,""9--344G %&&J~~ot,,L+GY KK~~ne,,Djnn%;R@@FBGG&w 7CC b'--// 2E  R 6)666777  >   u---((  ^       . / /   Kl3G&HKKK       . ) ) l.>.>|.L.L  Cl<&@CCC    J##N339rL&&(('' gt $ $ '   g & & & /)/F / /F#f,K!!## / 1 1# 6 677//Ayy{{/1<<>>/!!-- ":":;;"))#... i  / #I$9$9*$E$E F F   / / / )    /  R 9::: : :B LL8b88 B88 9 9 9 9  99J 9 9$ 9 9 9   | R zhxzz{{{8 R 6|666777 99U  s "K//LLcia ddlm}m}m}m}ddlm}m}|}t}g}| r| || ||D]} || dD]} td| jDr" | d} || \} } || sS| d| jj}||vrx||vr}| d d }|sa| d D]9}|}|r!|d s |d d}n:|||dddd}t2d |}t6d|d}|s||pd|dt9| t9| jdtd|<#t:$rYwxYwn#t:$rYnwxYwtS)zScan ~/.hermes/skills/ and return a mapping of /command -> skill info. Returns: Dict mapping "/skill-name" to {name, description, skill_md_path, skill_dir}. r)r_parse_frontmatterskill_matches_platform_get_disabled_skill_names)get_external_skills_dirsiter_skill_index_fileszSKILL.mdc3K|]}|dvV dS))z.gitz.githubz.hubN).0parts r- z&scan_skill_commands..s(VVtt::VVVVVVzutf-8)encodingr descriptionrrW#NP -r<z Invoke the z skill)rr~ skill_md_pathrr)r rrrrrsrtr7rurvsetr_r9r:anyr/ read_textr$r%rrsplit startswithaddlowerreplace_SKILL_INVALID_CHARSsub_SKILL_MULTI_HYPHENrr )rrrrsrtrurvdisabled seen_names dirs_to_scanscan_dirskill_mdr5r;bodyrr~linecmd_names r-scan_skill_commandsrsO5 wwwwwwwwwwwwVVVVVVVV,,..%%       ,    + + +4466777$' ' H228ZHH& & VVx~VVVVV#&00'0BBG(:(:7(C(C%K11+>>! &??68?3GHHDz)) x'' "-//-"D"DK&&$(JJLL$6$6t$<$<&&D#'::<F);>>>>*0'L)Z S S S S )!    r|skill_identifiersc g}g}g}t}|D]}|pd}|r||vr||t||}|s||]|\} } } d| d} |t | | | ||| d|||fS)zLoad one or more skills for session-wide CLI preloading. Returns (prompt_text, loaded_skill_names, missing_identifiers). rrz9[IMPORTANT: The user launched this CLI session with the "z~" skill preloaded. Treat its instructions as active guidance for the duration of this session unless the user overrides them.])rGz )rrrr.r9rpre) rr prompt_parts loaded_namesmissingseenr& identifierrr)rr*rDs r-build_preloaded_skills_promptrYs(!L LGUUD+(($*1133  Z4//  $ZAAA  NN: & & & .4+ i 7  7 7 7   "        J'''' ;;| $ $lG ;;r|)N)rrN)rNr)'__doc__r"loggingrepathlibrtypingrrrhermes_constantsragent.skill_preprocessingrr[r rXr rY getLogger__name__loggerr r__annotations__compilerrtupledictr.r^rCrprrrrrrxr|r-rsR   &&&&&&&&&&000000  8 $ $-/c4S>)*///!rz-00 bj**+/+/#+/d +/eTXY\^aYaTbdhkodoqtTtNux|N|+/+/+/+/\$ tCH~$ d3i$ D$ $ $ $ V! ddsCx.dd{dd d  d d d ddddN>T#tCH~"56>>>>BDd38n!45@s@x}@@@@* $$ $$4Z$ $ c] $$$$R(<(<Cy(< 4Z(< 3S 49 $%(<(<(<(<(<(