yjUdZddlZddlZddlZddlZddlmZddlmZm Z m Z ddl m Z ddl mZddlmZmZmZejeZiae ee eeffed<dae eed <ejd Zejd Zd Z d Z!dZ"dZ#dZ$dZ%dZ&ejej'e dzZ(e dzZ)dZ*de+dedefdZ,dede efdZ-d=dedede efdZ.dede efd Z/dede efd!Z0de efd"Z1d>d#ed$edzde2e3eefedzefdzfd%Z4d&e3eefde+eddfd'Z5 d?d&e3eefd)edzd*ed+ed,ed-edzdefd.Z6de ee eefffd/Z7de ee eefffd0Z8de eeffd1Z9d2ede efd3Z: d@d4ed+ed$edzd,ede ef d5Z;d6Z d>d;e+ed$edzde2ee+ee+effd<Z?dS)BzShared 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)register_stable_prefix)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.]zPThe 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 z "([^"]*)"%parts instructionreturncd|dztz}|t||S)uAppend the instruction line to ``parts``; return the stable prefix. Shared by every builder that ends a static skill scaffold with the caller-supplied volatile instruction (single-skill invocations, cron job prompts). The returned prefix ends exactly at the instruction marker, so registering it with ``agent.prompt_cache_boundary`` lets the Anthropic cache planner put a breakpoint on the scaffold instead of caching the whole message as one atomic block (#81867). Keeping construction in one place guarantees the registered prefix stays a byte-prefix of the built message — the invariant the request-time split depends on.  )join_SINGLE_SKILL_INSTRUCTIONappend)rr stable_prefixs :/home/ragecks/.hermes/hermes-agent/agent/skill_commands.pyappend_user_instructionrJsDIIe$$t+.GGM LL-<{<<=== contentct|tsdS|ts|St|vrt |St |vrt|SdS)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 r+extract_user_instruction_from_skill_messager&[sn gs # #t   6 7 7  /888w&&5g>>> 4r — separatorct|tr|tsdSt|}|r|dnd}|dr|nd|}t|}|rY||urU| td}d | }|r |r|||n|S|r|ndS)u Render a slash-skill-expanded turn the way the user typed it. The expanded message embeds the whole skill body, so any surface that summarizes a user turn from its raw content — session titles, sidebar previews, the ``/rewind`` picker — otherwise shows the skill's own prose as if the user had written it. That is how a skill's opening line ends up as a session title. Returns ``"/work — fix the title leak"``, or ``"/work"`` for a bare invocation, or ``None`` when *content* is not skill scaffolding (the caller should then summarize it as an ordinary message). *separator* joins the command and the instruction. Previews use the default em dash; pass ``" "`` for the literal invocation the user typed, which is what chat transcripts render. N/r ) rrr r!_SKILL_NAME_REmatchgroupstripr&splitSKILL_EXCERPT_JOINTr)rr(r/namelabelrs rdescribe_skill_invocationr6vs" gs # #7+=+=>V+W+Wt   ) )E# +EKKNNN 2 2 4 4DOOC(( 8DDj$jjE=gFFKO{'11"''(;<rfirst_skill_idxs rr#r#s677JA~~t*s+C'D'DDEEFK!&&'@AAO!!"2?"23 ##%%K  $rc 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_contextrEosgetenv Exception)rEresolved_platforms r _resolve_skill_commands_platformrMs9;;;;;; I' ( ( :899  999I&7889  $$s%(A A skill_identifiertask_idcB|pd}|sdS ddlm}m}ddlm}||}t j|||d}n#t$rYdSwxYw| dsdSt| d p|}t| d pd} d} | d } | rt| } n-| r+ |t| j z } n#t$rd} YnwxYw|| |fS) zOLoad a skill by name/path and return (loaded_payload, skill_dir, display_name).r+Nr) SKILLS_DIR skill_view)normalize_skill_lookup_nameF)rO preprocesssuccessr4path skill_dir) r1tools.skills_toolrQrRagent.skill_utilsrSjsonloadsrKgetrrparent) rNrOraw_identifierrQrRrS normalized loaded_skill skill_name skill_pathrW abs_skill_dirs r_load_skill_payloadrds&,"3355N t <<<<<<<<AAAAAA00@@ z Jz7u E E E   tt   I & &t\%%f--;<#e***;K LL3c33k33 4 4 4 4 S U      s%AC= C=& C=5BC== D  D r+rWactivation_noteuser_instruction runtime_note session_idcJddlm}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|dd}|r%| dt/| |}|r.| d| d|d d| }|D||r/t5|t5|krt7||S) z9Format a loaded skill into a user/system message payload.r)rQrr+ template_varsT inline_shellFinline_shell_timeout z[Skill directory: rjzResolve 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`).Nz[Runtime note: r)rXrQrr\_load_skills_config_substitute_template_varsint_expand_inline_shellr1rrurlvaluesrlistexistssortedrglobis_file is_symlink relative_to ValueErrorr4rrr r;r)r`rWrvrwrxryrQr skills_cfgtimeoutr supportingrentriessubdir subdir_pathfrelskill_view_targetsfrr7s 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   MI R07GHH 8 R 6|666777iiG W%7%7 %F%F 3w<#tH$rYKwxYw`n#tH$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)rQ_parse_frontmatterskill_matches_platformskill_matches_environment_get_disabled_skill_names)get_external_skills_dirsiter_skill_index_files)resolve_commandzSKILL.mdc3K|]}|dvV dS)>.git.hub.github.archiveN).0parts r z&scan_skill_commands..s(bb4tFFbbbbbbrzutf-8)encodingr4 descriptionr+r#NPr--rnzSkill %r generates slash command '/%s' which collides with a core Hermes command; skipping auto-registration. Use '/skill %s' instead.r,zaSkill %r maps to slash command %s already claimed by %r; keeping the first and skipping this one.z Invoke the z skill)r4r skill_md_pathrW)%rMr r rXrQrrrrrYrrhermes_cli.commandsrsetrrrlanyr read_textr\r]r4r1r2r addlowerreplace_SKILL_INVALID_CHARSsub_SKILL_MULTI_HYPHENloggerwarningrrK)rQrrrrrrrdisabled seen_names dirs_to_scanscan_dirskill_mdrrmbodyr4rlinecmd_namecmd_keys rscan_skill_commandsrs @AAOS  S S S S S S S S S S S S S SVVVVVVVV777777,,..%%       ,    + + +4466777$D D H228ZHHC C bbS[Sabbbbb@&00'0BBG(:(:7(C(C%K11+>>! 54[AA! &??68?3GHHDz)) x'' "-//-"D"DK&&$(JJLL$6$6t$<$<&&D#'::<$K"K1#K'K1(DK=K1?(K'K1)=K>chtrttkrttS)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 rMrrrrget_skill_commandsrs0  #'G'I'I I I rcldtttttffdtttffd}|tt }||t t t z }t t t z }t t t z}fd|D}fd|D}|||tt|dS)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. Note: the system prompt skill index truncates this to the first 57 chars; see ``extract_skill_description``. cmdsrci}|D]6\}}|d}|pidpd||<7|S)Nr,rr+)rklstripr\)rout slash_keyinfobares r _snapshotz reload_skills.._snapshot!s\ #zz|| > >OIt##C((D((77=2CII rc&g|] }||dS)r4rr)rnafters r z!reload_skills..4s% G G Gaaa 1 1 G G Grc&g|] }||dSrr)rrbefores rrz!reload_skills..7s%LLL&)44LLLr)addedremoved unchangedtotalcommands)rrrr rrrr;) 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 %%   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,rnr)rr)rrs rresolve_skill_command_keyrBsG 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. NrWrOrbump_use&[IMPORTANT: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])rwrxry)rr\rdtools.skill_usagerrKr) rrwrOrxr skill_infoloadedr`rWrarrvs rbuild_skill_invocation_messagerUs"##Hg&&J t K!8' J J JF t*0'L)Z ......W-----       S S S S )!    s A A+*A+restcg}|pd}t|tdz kr|}|dsn|dd}|d}t|dkr|dnd}t |d}|||vrn2|||}t|tdz k||fS)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`. r+r*r,Nr)r;_MAX_STACKED_SKILLSrr r2rrr1)rkeys remainingstrippedrtokentailrs rsplit_stacked_skill_commandsrsD I d)))A- - -##%%""3''  tQ''au::>>uQxxr+ELL,=,=>> ?goo  G  d)))A- - - "" ""rcmd_keysc t}g}g}g}t}|D] }|r||vr ||||} | s)||d_t | d|} | s)||d| \} } } ddlm}|| |n#t$rYnwxYwd| d}|t| | |||| |sd Sd d |D}d |d t|dddd |g}|r+|dd ||r| dd|gd |}d |g|||fS)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. r,rWrrrz1[Loaded as part of the stacked skill invocation "z".]ryNr-c3K|]}||V dSNr)rks rrz9build_stacked_skill_invocation_message..s'..1A.Q......rrz " stacked skill bundle, loading zL skills together. Treat every skill below as active guidance for this turn.]r+zSkills loaded: z, zSkills missing (skipped): zUser instruction: r )rrrr\rrrdrrrKrrr;rl)rrwrOr loaded_namesmissing skill_blocksseenrrrr`rWrarrvtyped header_linesheaders r&build_stacked_skill_invocation_messager s"##H LG LUUD$($( 'T//  \\'**   NN7>>#.. / / / $Z %>#.. / / / .4+ i  2 2 2 2 2 2 HZ 1 1 1 1 1    D  P O O O   "        J'''' t HH..... . .E - - -|$$ - - - 3$))L1133 LOM79K9KMMNNNKR!H6F!H!HIJJJ YY| $ $F KK/,/ 0 0, HHs C!! C.-C.skill_identifiersc g}g}g} ddlm}|}n#t$rt}YnwxYwt}|D]}|pd} | r| |vr|| t | |} | s|| ]| \} } } | |vs| |vr||  ddlm }|| |n#t$rYnwxYwd| d}|t| | |||| d |||fS) 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_namesr+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.]rr) rYrrKrr1rrdrrrrr)rrO prompt_partsrrrdisabled_namesr r^ identifierrr`rWrarrvs rbuild_preloaded_skills_promptrs!L LG>>>>>>1133 UUD+%(%($*1133  Z4//  $ZAAA  NN: & & & .4+ i  ' ':+G+G NN: & & &   2 2 2 2 2 2 HZ 1 1 1 1 1    D  7  7 7 7   "        J'''' ;;| $ $lG ;;s44 C C*)C*)r'r)r+r+N)r+Nr+)r+N)@__doc__rZloggingrIrepathlibrtypingrrrhermes_constantsragent.prompt_cache_boundaryragent.skill_preprocessingr rr rr r getLogger__name__rr r__annotations__r compilerrr!r$rr=r"rArBescaper.SKILL_SCAFFOLD_SQL_LIKEr3rrr&r6r%r#rMtupledictrdrurrrrrrrrr rrrrr%s   &&&&&&&&&&000000>>>>>>  8 $ $-/c4S>)*///*.(3-...!rz-00 bj**(CAV% !19IBI&>??,NOO 3S8 4cc"#6$#$#s$#s$#RU$#$#$#$#N C HSM     c hsm    %(3-%%%%.%/%/#%/d %/eTXY\^aYaTbdhkodoqtTtNux|N|%/%/%/%/P$ tCH~$ d3i$ D$ $ $ $ V! nnsCx.nd{nn n  n d n nnnnb]T#tCH~"56]]]]@ Dd38n!45    >tCH~>>>>B@s@x}@@@@* ,, ,,4Z, , c] ,,,,z#s#uT#Y^/D####DOIOI3iOIOI4ZOIeCcDI-./ OIOIOIOIhA<A<CyA< 4ZA< 3S 49 $%A<A<A<A<A<A