#jNUdZddlZddlZddlZddlZddlmZddlmZm Z m Z ddl m Z ddl mZmZmZejeZiae ee eeffed<dae eed<ejd Zejd Zd e efd Zd#d ededzd ee eefedzefdzfdZ!de eefde"ed dfdZ# d$de eefdedzdededededzd efdZ$d e ee eefffdZ%d e ee eefffdZ&d e eeffdZ'ded e efdZ( d%dedededzded e ef d Z) d#d!e"ededzd eee"ee"effd"Z*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_commands_skill_commands_platformz [^a-z0-9-]z-{2,}returnc ddlm}tjdp |d}n$#t$rtjd}YnwxYw|pdS)aReturn the current platform scope used for disabled-skill filtering. Used to detect when the active platform has shifted so :func:`get_skill_commands` can drop a stale cache that was populated for a different platform's ``skills.platform_disabled`` view (#14536). Resolves from (in order) ``HERMES_PLATFORM`` env var and ``HERMES_SESSION_PLATFORM`` from the gateway session context. Returns ``None`` when no platform scope is active (e.g. classic CLI, RL rollouts, standalone scripts). r)get_session_envHERMES_PLATFORMHERMES_SESSION_PLATFORMN)gateway.session_contextrosgetenv Exception)rresolved_platforms 9/home/ubuntu/.hermes/hermes-agent/agent/skill_commands.py _resolve_skill_commands_platformrs9;;;;;; I' ( ( :899  999I&7889  $$s%(A A skill_identifiertask_idcT|pd}|sdS ddlm}m}ddlm}t |}|rd}|g} | |n#t$rYnwxYw|D]6} t| | }n#t$rY3wxYw|Z t| |}n(#t$r|}YnwxYwn|d}t!j|||d} n#t$rYdSwxYw| d sdSt| 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)get_external_skills_dirs/F)r preprocesssuccessnamepath skill_dir)striptools.skills_toolrragent.skill_utilsrr expanduser is_absoluteextendrstr relative_to ValueErrorresolvelstripjsonloadsgetparent)rrraw_identifierrrridentifier_path normalized trusted_rootsroot loaded_skill skill_name skill_pathr% abs_skill_dirs r_load_skill_payloadr>5s&,"3355N t&<<<<<<<<>>>>>>~..99;;  & & ( ( 4J'LM $$%=%=%?%?@@@@    &  !$_%@%@%F%F!G!GJE!H!0!$_%<%<%>%>%J%J:K]K]K_K_%`%`!a!aJJ 000!/JJJ0" (..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 rr%activation_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)rrEr template_varsT inline_shellFinline_shell_timeout z[Skill directory: rFzResolve 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:  )r'rr,r3_load_skills_config_substitute_template_varsint_expand_inline_shellr&rHrQr+values isinstancelistexistssortedrglobis_file is_symlinkr-r.r#join)r:r%rRrSrTrUrrE skills_cfgtimeoutr? supportingr_entriessubdir subdir_pathfrelskill_view_targetsfs r_build_skill_messager}s-,,,,,,""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//LLc:taia ddlm}m}m}m}m}ddl m }m }|}t}g} | r| || || D]} || dD]} t!d| jDr" | d} || \} }|| sS|| s_| d| jj}||vr||vr| d d }|sa|d D]9}|}|r!|d s |d d}n:|||dddd}t8d |}t<d|d}|s||pd|dt?| t?| 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_platformskill_matches_environment_get_disabled_skill_names)riter_skill_index_fileszSKILL.mdc3K|]}|dvV dS)>.git.hub.github.archiveN).0parts r z&scan_skill_commands..s(bb4tFFbbbbbbzutf-8)encodingr# descriptionrre#NP -rJz Invoke the z skill)r#r skill_md_pathr%r )!rr r r'rrrrrr(rrsetrmrHr+anyr? read_textr3r4r#r&split startswithaddlowerreplace_SKILL_INVALID_CHARSsub_SKILL_MULTI_HYPHENr,r)rrrrrrrdisabled seen_names dirs_to_scanscan_dirskill_mdrErIbodyr#rlinecmd_names rscan_skill_commandsrsj @AAO9  S S S S S S S S S S S S S SVVVVVVVV,,..%%       ,    + + +4466777$+ + H228ZHH* * bbS[Sabbbbb'&00'0BBG(:(:7(C(C%K11+>>! 54[AA! &??68?3GHHDz)) x'' "-//-"D"DK&&$(JJLL$6$6t$<$<&&D#'::<._snapshot|s\ #zz|| > >OIt##C((D((77=2CII rc&g|] }||dS)r#rr)rnafters r z!reload_skills..s% G G Gaaa 1 1 G G Grc&g|] }||dSrr)rrbefores rrz!reload_skills..s%LLL&)44LLLr)addedremoved unchangedtotalcommands)rr,rr rrnrlen) r new_commands added_names removed_namesrrrrrs @@r reload_skillsr\s+@S$sCx.01d38nY ' 'F'((L Il # #EUc&kk122K3v;;U344Ms5zzCKK/00I G G G G; G G GEMLLLmLLLGU %%   rcommandcd|sdSd|dd}|tvr|ndS)uVResolve a user-typed /command to its canonical skill_cmds key. Skills are always stored with hyphens — ``scan_skill_commands`` normalizes spaces and underscores to hyphens when building the key. Hyphens and underscores are treated interchangeably in user input: this matches ``_check_unavailable_skill`` and accommodates Telegram bot-command names (which disallow hyphens, so ``/claude-code`` is registered as ``/claude_code`` and comes back in the underscored form). Returns the matching ``/slug`` key from ``get_skill_commands()`` or ``None`` if no match. Nr rJr)rr)rcmd_keys rresolve_skill_command_keyrsG t-'//#s++--G!3!5!555774?rrct}||}|sdSt|d|}|sdS|\}}} ddlm} | | n#t $rYnwxYwd| d} t ||| |||S) aEBuild the user message content for a skill slash command invocation. Args: cmd_key: The command key including leading slash (e.g., "/gif-search"). user_instruction: Optional text the user typed after the command. Returns: The formatted message string, or None if the skill wasn't found. Nr%rrbump_usez&[IMPORTANT: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])rSrTrU)rr3r>tools.skill_usagerrr}) rrSrrTr skill_infoloadedr:r%r;rrRs rbuild_skill_invocation_messagers"##Hg&&J t K!8' J J JF t*0'L)Z ......       S S S S )!    s A A)(A)skill_identifiersc g}g}g}t}|D]}|pd}|r||vr||t||}|s||]|\} } } ddlm} | | n#t$rYnwxYwd| d} |t| | | ||| d |||fS) zLoad one or more skills for session-wide CLI preloading. Returns (prompt_text, loaded_skill_names, missing_identifiers). rrrrz9[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.])rUz ) rr&rr>rHrrrr}rr)rr prompt_parts loaded_namesmissingseenr5 identifierrr:r%r;rrRs rbuild_preloaded_skills_promptrsr!L LGUUD+!(!($*1133  Z4//  $ZAAA  NN: & & & .4+ i  2 2 2 2 2 2 HZ     D  7  7 7 7   "        J'''' ;;| $ $lG ;;s;B  BB)N)rrN)rNr)+__doc__r1loggingrrepathlibrtypingrrrhermes_constantsragent.skill_preprocessingrrir rfr rg getLogger__name__loggerr r,__annotations__r compilerrrtupledictr>rlrQr}rrrrrrrrrrs   &&&&&&&&&&000000  8 $ $-/c4S>)*///*.(3-...!rz-00 bj**%(3-%%%%.A/A/#A/d A/eTXY\^aYaTbdhkodoqtTtNux|N|A/A/A/A/H$ tCH~$ d3i$ D$ $ $ $ V! ddsCx.dd{dd d  d d d ddddNCT#tCH~"56CCCCL Dd38n!45    >tCH~>>>>B@s@x}@@@@* ,, ,,4Z, , c] ,,,,b0<0<Cy0< 4Z0< 3S 49 $%0<0<0<0<0<0