`gjudUdZddlZddlZddlZddlZddlmZddlmZm Z m Z ddl m Z ddl mZmZmZej(eZiae ee eeffed<dae eed<ej6d Zej6d Zd Zd Zd Z dZ!dZ"dZ#dZ$dede efdZ%dede efdZ&dede efdZ'de efdZ(d3dededzde)e*eefedzefdzfdZ+de*eefde,eddfdZ- d4de*eefdedzd ed!ed"ed#edzdefd$Z.de ee eefffd%Z/de ee eefffd&Z0de eeffd'Z1d(ede efd)Z2 d5d*ed!ededzd"ede ef d+Z3d,Z4d-ede)e,eeffd.Z5 d6d/e,ed!ededzde e)ee,ee,effd0Z6 d3d1e,ededzde)ee,ee,effd2Z7y)7zShared 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,}z%[IMPORTANT: The user has invoked the z(The full skill content is loaded below.]PThe user has provided the following instruction alongside the skill invocation: z [Runtime note:z skill bundle,z User instruction: z [Loaded as part of the contentreturnct|tsy|jts|St|vr t |St |vr t|Sy)u(Recover the user's instruction from a slash-skill-expanded turn. Returns: - The original string unchanged when it is NOT skill scaffolding (a normal user message passes straight through). - The extracted user instruction when the scaffolding carried one. - ``None`` when the content is skill scaffolding with no user instruction (i.e. a bare ``/skill`` invocation). Callers that feed memory providers should skip the turn in that case — there is no user content worth storing. N) isinstancestr startswith_SKILL_INVOCATION_PREFIX_BUNDLE_MARKER _extract_bundle_user_instruction_SINGLE_SKILL_MARKER&_extract_single_skill_user_instruction)rs G/root/.hermes/venv/lib/python3.12/site-packages/agent/skill_commands.py+extract_user_instruction_from_skill_messager:sN gs #   6 7 /88w&5g>> messagec|jt}|dkry||ttzd}|jt}|dk\r|d|}|j }|xsdSNr)rfind_SINGLE_SKILL_INSTRUCTIONlenfind _RUNTIME_NOTEstrip)r marker_idx instruction runtime_idxs rrrUsr89JA~*s+D'EEFGK""=1Ka!,;/ ##%K  $rc|jt}|dkry||ttzd}|jt}|dk\r|d|}|j }|xsdSr)r"_BUNDLE_USER_INSTRUCTIONr!_BUNDLE_FIRST_SKILL_BLOCKr$)rr%r&first_skill_idxs rrrdst67JA~*s+C'DDEFK!&&'@AO!!"2?3 ##%K  $rc ddlm}tjdxs|d}|xsdS#t$rtjd}Y&wxYw)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_contextr-osgetenv Exception)r-resolved_platforms r _resolve_skill_commands_platformr5ssZ9; II' ( :89   $$ 9II&789s%-A Askill_identifiertask_idc|xsdj}|sy ddlm}m}ddlm}||}t j|||d}|jdsyt|jd xs|}t|jd xsd} d} |jd } | r t| } n| r |t| jz } || |fS#t$rYywxYw#t$rd} Y!wxYw) zOLoad a skill by name/path and return (loaded_payload, skill_dir, display_name).Nr) SKILLS_DIR skill_view)normalize_skill_lookup_nameF)r7 preprocesssuccessnamepath skill_dir) r$tools.skills_toolr:r;agent.skill_utilsr<jsonloadsr3getrrparent) r6r7raw_identifierr:r;r< normalized loaded_skill skill_name skill_pathrA abs_skill_dirs r_load_skill_payloadrNs &,"335N  <A0@ zz z7u E   I &\%%f-; 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`).r z[Runtime note:  )rBr:rrF_load_skills_config_substitute_template_varsint_expand_inline_shellr$rWrarXvaluesrlistexistssortedrglobis_file is_symlink relative_to ValueErrorr?join)rJrArbrcrdrer:r skills_cfgtimeoutrO supportingroentriessubdir subdir_pathfrelskill_view_targetsfs r_build_skill_messagersG-,""9-34G %&J~~ot,+GY K~~ne,jnn%;R@FBG&w 7C b'--/ 2E R ))A67  > u-( ^    . / %l3G&H%IK    . )l.>.>|.L %l<&@%AC  J##N39rL&&(' gt $   g &' )F /F#f,K!!# 1 1# 67/Ayy{1<<>!!-- ":;"))#./ /i / #I$9$9*$E F   R 9: :B LL2bT B'78 9 : 89J8KL$+%7 9  R ghxgyz{ R |nA67 99U + / )  /sL&&L>=L>c :taia ddlm}m}m}m}m}ddl m }m }ddl m }|}t} g} |jr| j!|| j#|| D]} || dD]} t%d| j&Dr! | j)d} || \}}||sH||sQ|j+d | j,j.}|| vr|||vr|j+d d }|sO|j1j3d D]-}|j1}|s|j5d r(|dd}n| j7||j9j;ddj;dd}t<j?d |}t@j?d|j1d}|sd||tBjEd|||d|}|tvr$tBjEd||t|d ||xsd|dtG| tG| j,dt|< tS#tH$rYwxYw#tH$rYtSwxYw)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)get_external_skills_dirsiter_skill_index_files)resolve_commandzSKILL.mdc3$K|]}|dv yw)>.git.hub.github.archiveN).0parts r z&scan_skill_commands..Xsb4tFFbszutf-8)encodingr? descriptionr9ru#NP -rZzSkill %r generates slash command '/%s' which collides with a core Hermes command; skipping auto-registration. Use '/skill %s' instead./zaSkill %r maps to slash command %s already claimed by %r; keeping the first and skipping this one.z Invoke the z skill)r?r skill_md_pathrA)%r5r r rBr:rrrrrCrrhermes_cli.commandsrsetr|rWrXanyrO read_textrFrGr?r$splitraddlowerreplace_SKILL_INVALID_CHARSsub_SKILL_MULTI_HYPHENloggerwarningrr3)r:rrrrrrrdisabled seen_names dirs_to_scanscan_dirskill_mdrrYbodyr?rlinecmd_namecmd_keys rscan_skill_commandsr@s @AOS  S SV7,.%         +467$D H28ZHC bS[SaSabb@&00'0BG(:7(C%K1+> 5[A &??68??3G3GHDz) x' "-//-"DK&$(JJL$6$6t$<&D#'::J ?I9J AI9 I9BI9%J ' I9J /I98J :2I9,J 9 JJ JJ JJcPtrttk7r ttS)aReturn the current skill commands mapping (scan first if empty). Rescans when the active platform scope changes (e.g. a gateway process serving Telegram and Discord concurrently) so each platform sees its own ``skills.platform_disabled`` view (#14536). )r r r5rrrrget_skill_commandsrs  #'G'I I rcdtttttffdtttffd}|t}t }||}t t |t |z }t t |t |z }t t |t |z}|Dcgc] }|||d }}|Dcgc] }|||d } }|| |t|t|dScc}wcc}w)uRe-scan the skills directory and return a diff of what changed. Rescans ``~/.hermes/skills/`` and any ``skills.external_dirs`` so the slash-command map (``agent.skill_commands._skill_commands``) reflects skills added or removed on disk. This does NOT invalidate the skills system-prompt cache. Skills are called by name via ``/skill-name``, ``skills_list``, or ``skill_view`` — they don't need to be in the system prompt for the model to use them. Keeping the prompt cache intact preserves prefix caching across the reload, so a user invoking ``/reload-skills`` pays no cache-reset cost. Returns: Dict with keys:: { "added": [{"name": str, "description": str}, ...], "removed": [{"name": str, "description": str}, ...], "unchanged": [skill names present before and after], "total": total skill count after rescan, "commands": total /slash-skill count after rescan, } ``description`` is the skill's full SKILL.md frontmatter ``description:`` field — the same string the system prompt renders as `` - name: description`` for pre-existing skills. cmdsrci}|jD]2\}}|jd}|xsijdxsd||<4|S)Nrrr9)rVlstriprF)rout slash_keyinfobares r _snapshotz reload_skills.._snapshotsT #zz| >OIt##C(D((7=2CI > r)r?r)addedremoved unchangedtotalcommands)rrrr rr}rr!) rbefore new_commandsafter added_names removed_namesrnrrs r reload_skillsrs@S$sCx.01d38n 'F'(L l #EUc&k12K3v;U34Ms5zCK/0I;F Gaaa 1 GE G?LL&)4LGLU %   HMs :C:C?commandcR|syd|jdd}|tvr|SdS)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. NrrZr)rr)rrs rresolve_skill_command_keyrs8 '//#s+,-G!3!557?4?rrct}|j|}|syt|d|}|sy|\}}} ddlm} | | d| d} t ||| |||S#t $rY"wxYw) 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. NrAr7rbump_use&[IMPORTANT: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])rcrdre)rrFrNtools.skill_usagerr3r) rrcr7rdr skill_infoloadedrJrArKrrbs rbuild_skill_invocation_messagers"#Hg&J  K!8' JF *0'L)Z . 1 =S S )!      sA A*)A*restcg}|xsd}t|tdz kr|j}|jdsnv|j dd}|d}t|dkDr|dnd}t |jd}|||vrn)|j ||}t|tdz kr||jfS)uConsume additional leading ``/skill`` tokens from *rest*. *rest* is the text that follows the FIRST matched skill command (the caller has already resolved that one). Leading whitespace-delimited tokens that start with ``/`` and resolve to installed skill commands are consumed, up to ``_MAX_STACKED_SKILLS`` total leading skills (i.e. at most ``_MAX_STACKED_SKILLS - 1`` extra keys here). Parsing stops at the first token that is not a resolvable skill command — that token and everything after it become the user instruction. Returns: ``(extra_cmd_keys, remaining_instruction)`` where ``extra_cmd_keys`` are canonical ``/slug`` keys from :func:`get_skill_commands`. r9rNr)r!_MAX_STACKED_SKILLSrrrrrWr$)rkeys remainingstrippedrOtokentailrs rsplit_stacked_skill_commandsrCsD I d))A- -##%""3' tQ'au:>uQxr+ELL,=> ?go  G  d))A- - " ""rcmd_keysc Bt}g}g}g}t}|D]}|r||vr |j||j|} | s!|j |j dOt | d|} | s!|j |j d| \} } } ddlm}|| d| d}|j t| | |||j | |sy d jd |D}d |d t|ddddj|g}|r#|j ddj||r|jdd|gdj|}dj|g|||fS#t$rYwxYw)arBuild the user message for a stacked multi-skill slash invocation. Args: cmd_keys: Canonical ``/slug`` keys, in the order the user typed them. user_instruction: Text remaining after the leading skill commands. Returns: ``(message, loaded_skill_names, missing_skill_names)`` or ``None`` when no skill could be loaded at all. rrArrrz1[Loaded as part of the stacked skill invocation "z".]reNrc3&K|] }|s| ywNr)rks rrz9build_stacked_skill_invocation_message..s.1AQ.srz " stacked skill bundle, loading zL skills together. Treat every skill below as active guidance for this turn.]r9zSkills loaded: z, zSkills missing (skipped): zUser instruction: ru )rrrrFrWrrNrrr3rrr!rX)rrcr7r loaded_namesmissing skill_blocksseenrrrrJrArKrrbtyped header_linesheaders r&build_stacked_skill_invocation_messagercs"#H LG LUD$('T/  \\'*  NN7>>#. / $Z %>#. / .4+ i  2 Z @ |3 O   "    J'I$(L  HH.. .E 08|$%&- - $))L123 L879K8LMNR#56F5G!HIJ YY| $F KK/,/ 0, HHK   s&F FFskill_identifiersc &g}g}g} ddlm}|}t}|D]}|xsdj } | r| |vr|j | t | |} | s|j| P| \} } } | |vs| |vr|j| p ddlm }|| d| d}|jt| | |||j| d j|||fS#t$r t}YwxYw#t$rYowxYw) uDLoad one or more skills for session-wide CLI/TUI preloading. Returns (prompt_text, loaded_skill_names, missing_identifiers). Disabled skills are treated the same as missing ones: this loads via a raw identifier straight into ``_load_skill_payload``, bypassing ``get_skill_commands()``'s scan-time disabled filter — mirrors the bundle-invocation gate (#59156). Without this, ``hermes -s `` or a deployment's ``HERMES_TUI_SKILLS`` env var could force-load a skill an operator disabled via ``skills.disabled``/``skills.platform_disabled``. r)get_disabled_skill_namesr9rrz9[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.]rr) rCrr3rr$rrNrWrrrr)rr7 prompt_partsrrrdisabled_namesrrH identifierrrJrArKrrbs rbuild_preloaded_skills_promptrsS!L LG>13UD+%($*113 Z4/  $ZA NN: & .4+ i  ':+G NN: &   2 Z H |T7 7   "    J'K%(N ;;| $lG ;;W 2   s# C+D+DD DDr)r9r9N)r9Nr9)r9N)8__doc__rDloggingr1repathlibrtypingrrrhermes_constantsragent.skill_preprocessingrryr rvr rw getLogger__name__rr r__annotations__r compilerrrrr r#rr)r*rrrr5tupledictrNr{rarrrrrrrrrrrrrrsj   &&0   8 $-/c4S>)*/*.(3-.!rzz-0 bjj*(CAV% !19#6 C HSM  c hsm %(3-%.%/#%/d %/eTXY\^aYaTbdhkodoqtTtNux|N|%/P$ tCH~$ d3i$ D$ V! dsCx.dd{dd d  d d d dN]T#tCH~"56]@ Dd38n!45 >tCH~>B@s@x}@* , ,,4Z, , c] ,z#s#uT#Y^/D#DOI3iOIOI4ZOIeCcDI-./ OIhA<CyA< 4ZA< 3S 49 $%A