iKJUdZddlZddlZddlZddlZddlmZddlmZm 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_idch|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_torlstripjsonloadsgetparent) rrraw_identifierrridentifier_path normalized loaded_skill skill_name skill_pathr$ abs_skill_dirs r_load_skill_payloadr85s&,"3355N t<<<<<<<<~..99;;  & & ( ( 4 , !8!8!:!:!F!FzGYGYG[G[!\!\]]  , , ,+  ,(..s33Jz Jz7u E E E   tt   I & &t\%%f--;< frontmatter_ config_varsresolvedlineskeyvalue display_vals r_inject_skill_configrMcs           ,**=99^\=M=Mi=X=X^\^__   F**;77 Q// <<   F..{;;  FQ,?,A,AQQQR"..** 5 5JC(->#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)rr?r template_varsT inline_shellFinline_shell_timeout z[Skill directory: r@zResolve 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)r/_load_skills_config_substitute_template_varsint_expand_inline_shellr%rCrMrDvalues isinstancelistexistssortedrglobis_file is_symlinkr+ ValueErrorr"join)r4r$rNrOrPrQrr? skills_cfgtimeoutr9 supportingr[entriessubdir subdir_pathfrelskill_view_targetsfs r_build_skill_messagerzs-,,,,,,""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//LLctaia 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}t6d |}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_platform_get_disabled_skill_names)get_external_skills_dirsiter_skill_index_fileszSKILL.mdc3K|]}|dvV dS))z.gitz.githubz.hubz.archiveN).0parts r z&scan_skill_commands..s(bb4tFFbbbbbbzutf-8)encodingr" descriptionrra#NP -rFz Invoke the z skill)r"r skill_md_pathr$r) rr r r&rr|r}r~rArrsetrirCrDanyr9 read_textr/r0r"r%split startswithaddlowerreplace_SKILL_INVALID_CHARSsub_SKILL_MULTI_HYPHENr)r)rr|r}r~rrdisabled seen_names dirs_to_scanscan_dirskill_mdr?rEbodyr"rlinecmd_names rscan_skill_commandsrs" @AAO5 wwwwwwwwwwwwVVVVVVVV,,..%%       ,    + + +4466777$' ' H228ZHH& & bbS[Sabbbbb#&00'0BBG(:(:7(C(C%K11+>>! &??68?3GHHDz)) x'' "-//-"D"DK&&$(JJLL$6$6t$<$<&&D#'::<._snapshotbs\ #zz|| > >OIt##C((D((77=2CII rc&g|] }||dS)r"rr)rnafters r z!reload_skills..us% G G Gaaa 1 1 G G Grc&g|] }||dSrr)rrbefores rrz!reload_skills..xs%LLL&)44LLLr)addedremoved unchangedtotalcommands)rr)rr rrjrlen) r new_commands added_names removed_namesrrrrrs @@r reload_skillsrBs+@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. NrrFr)rr)rcmd_keys rresolve_skill_command_keyrsG t-'//#s++--G!3!5!555774?rrc"t}||}|sdSt|d|}|s d|ddS|\}}} 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$rz[Failed to load skill: r"r@rbump_usez&[IMPORTANT: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])rOrPrQ)rr/r8tools.skill_usagerrrz) rrOrrPr skill_infoloadedr4r$r5rrNs rbuild_skill_invocation_messagers"##Hg&&J t K!8' J J JF ?>F);>>>>*0'L)Z ......       S S S S )!    sA&& A32A3skill_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.])rQz ) rr%rr8rCrrrrzro)rr prompt_parts loaded_namesmissingseenr1 identifierrr4r$r5rrNs 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__r-loggingrrepathlibrtypingrrrhermes_constantsragent.skill_preprocessingrrer rbr rc getLogger__name__loggerr r)__annotations__r compilerrrtupledictr8rhrMrzrrrrrrrrrrs   &&&&&&&&&&000000  8 $ $-/c4S>)*///*.(3-...!rz-00 bj**%(3-%%%%.+/+/#+/d +/eTXY\^aYaTbdhkodoqtTtNux|N|+/+/+/+/\$ tCH~$ d3i$ D$ $ $ $ V! ddsCx.dd{dd d  d d d ddddN?T#tCH~"56????D Dd38n!45    >tCH~>>>>B@s@x}@@@@* ,, ,,4Z, , c] ,,,,b0<0<Cy0< 4Z0< 3S 49 $%0<0<0<0<0<0