iDUdZddlZddlZddlZddlmZddlmZmZm Z ddl m Z ddl m ZmZmZejeZiaeeeeeffed<ejdZejd Zd!d ed edzd eeeefedzefdzfd Zdeeefdeed dfdZ d"deeefdedzdededededzd efdZ!d eeeeefffdZ"d eeeeefffdZ#d eeeffdZ$ded e efdZ% d#deded edzded e ef dZ& d!deed edzd eeeeeeffd 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_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 ;/home/longshao/.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.hubz.archiveN).0parts r- z&scan_skill_commands..s(bb4tFFbbbbbbzutf-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& & bbS[Sabbbbb#&00'0BBG(:(:7(C(C%K11+>>! &??68?3GHHDz)) x'' "-//-"D"DK&&$(JJLL$6$6t$<$<&&D#'::<._snapshot?s\ #zz|| > >OIt##C((D((77=2CII r|c&g|] }||dS)rr~rx)rynafters r- z!reload_skills..Rs% G G Gaaa 1 1 G G Gr|c&g|] }||dSrrx)ryrbefores r-rz!reload_skills..Us%LLL&)44LLLr|)addedremoved unchangedtotalcommands)rrrr rr`rlen) r new_commands added_names removed_namesrrrrrs @@r- reload_skillsrs+@S$sCx.01d38nY ' 'F'((L Il # #EUc&kk122K3v;;U344Ms5zzCKK/00I G G G G; G G GEMLLLmLLLGU %%   r|commandcd|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. Nrr<r)rr)rcmd_keys r-resolve_skill_command_keyr`sG t-'//#s++--G!3!5!555774?r|rc"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. Nrr z[Failed to load skill: rr6rbump_usez&[IMPORTANT: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])rErFrG)rr$r.tools.skill_usagerr rp) rrEr rFr skill_infoloadedr)rr*rrDs r-build_skill_invocation_messagerss"##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.])rGz ) rrrr.r9rrr rpre)rr prompt_parts loaded_namesmissingseenr& identifierrr)rr*rrDs r-build_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"loggingrepathlibrtypingrrrhermes_constantsragent.skill_preprocessingrr[r rXr rY getLogger__name__loggerr r__annotations__compilerrtupledictr.r^rCrprrrrrrrxr|r-rsv   &&&&&&&&&&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>tCH~>>>>B@s@x}@@@@* ,, ,,4Z, , c] ,,,,b0<0<Cy0< 4Z0< 3S 49 $%0<0<0<0<0<0