߲jχUdZddlZddlZddlZddlZddlZddlmZddlm Z m Z m Z ddl m Z ddlmZddlmZmZej(eZiae ee ee ffed<dae eed <dae eed <dae eed <ej:Zej>d Z ej>d Z!dZ"dZ#dZ$dZ%dZ&dZ'dZ(ej>ejRe"dzZ*e"dzZ+dZ,dedefdZ-de.dedefdZ/de de efdZ0dnde d ede efd!Z1d"ed#ed$ede efd%Z2de efd&Z3defd'Z4de efd(Z5dod)ed*edzde6e7ee fedzefdzfd+Z8d,e7ee fde.eddfd-Z9d.Z:d/Z;d,e7ee fde efd0Zd9e6e7ee fedzefd4ed*edzd:edef d;Z?dddd3d3d<d=ed>e.ed?e.edzd@e.edzdAe.edzdBed5edefdCZ@hdDZAdede efdEZBdFedAeCdGeCdHe ee ee ffddf dIZDde ee ee fffdJZEde ee ee fffdKZFdLe eefdMe eefde ee ffdNZGdOe ee ee ffde eeffdPZHde ee ffdQZIdRede efdSZJdRedTe ee fde efdUZK dqdVed5ed*edzd6ede ef dWZLdXZMdYede6e.eeffdZZN drd[e.ed5ed*edzde e6ee.ee.effd\ZOdod]edzdeCfd^ZPd_dd`ddadbe.ed*edzdceCdzddeQdeeCdzde6e.ee.ee.ee.eff dfZR dsdge.ed*edzdheCedzde6ee.ee.effdiZSdodje7dzde.efdkZT dtd*edzdje7dzdledzde6ee.ee.effdmZUy)uzRShared slash command helpers for skills (CLI and gateway both invoke /skill-name).N)Path)AnyDictOptional)display_hermes_home)register_stable_prefix)load_skills_configpreprocess_skill_content_skill_commands_skill_commands_platform_skill_commands_home_skill_commands_projectz[^\w-]z-{2,}%[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 "([^"]*)"%namereturnctjd|jjddjdd}tjd|j dS)zNormalize a skill/bundle name to a ``/command`` slug (``Foo Bar`` -> ``foo-bar``); strips chars (``+``, ``/``) that would make invalid Telegram command names. -_)_SKILL_INVALID_CHARSsublowerreplace_SKILL_MULTI_HYPHENstrip)rcmds 9/home/ubuntu/.hermes/hermes-agent/agent/skill_commands.pyslugify_skill_namer!9sU  " "2tzz|';';C'E'M'McSV'W XC  " "3 , 2 23 77parts instructioncndj|dztz}|jt||S)uAppend the instruction line to ``parts``; return the stable prefix, which ends exactly at the instruction marker so (registered with ``agent.prompt_cache_boundary``) the cache planner can break on the scaffold. Single construction site guarantees the prefix is a byte-prefix of the message. Shared by every builder that ends a static skill scaffold with the caller-supplied volatile instruction (single-skill invocations, cron job prompts). 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. See #81867.  )join_SINGLE_SKILL_INSTRUCTIONappend)r#r$ stable_prefixs r append_user_instructionr+@s:IIe$t+.GGM LL-.{m<= r"contentct|tsy|jts|St|vr t |t t|jSt|vr t |tt|jSy)zRecover the user's instruction from a slash-skill-expanded turn: the string unchanged when it is NOT scaffolding, the extracted instruction when the scaffolding carried one, or ``None`` for a bare ``/skill`` invocation.N) isinstancestr startswith_SKILL_INVOCATION_PREFIX_BUNDLE_MARKER _cut_after_BUNDLE_USER_INSTRUCTION_BUNDLE_FIRST_SKILL_BLOCKfind_SINGLE_SKILL_MARKERr( _RUNTIME_NOTErfind)r,s r +extract_user_instruction_from_skill_messager:Psh gs #   6 7 '#;=VX_XdXdeew&'#V+W   )E#EKKN 2 2 4DOOC(D$jE=gFK{'1hh{001DEaHNNPQ 9=eWYK }5 N; N5"d"r"messagemarker stop_markerc||}|dkry||t|zdj|ddjxsdS)z`Text between *marker* (located with ``find``) and *stop_marker*, stripped; None if absent/empty.rNr=)lenrBr)rFrGrHr6 marker_idxs r r3r3vsMfJA~ :F +, - 3 3K CA F L L N VRVVr"c ddlm}tjdxs|d}|xsdS#t$rtjd}Y&wxYw)aCurrent platform scope for disabled-skill filtering, or None (CLI, RL, scripts). A change invalidates the scan cache so each platform sees its own ``skills.platform_disabled`` view. 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). r)get_session_envHERMES_PLATFORMHERMES_SESSION_PLATFORMN)gateway.session_contextrMosgetenv Exception)rMresolved_platforms r _resolve_skill_commands_platformrU~sS9;II&78fOLez'_inject_skill_config..s+lZSRWr#c#e*;!GHls"$]) r]rurvrwr/rmr)rextenditemsrS) rqr#rurvrwrx frontmatterrresolveds r _inject_skill_configrs  oo,**=9^\=M=Mi=X^\^_ *;7 Q./H/UV  R +,?,A+B.QR l[c[i[i[kll S    sAB?A%B?? C  C 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.zwRequired environment setup was skipped. Continue loading the skill and explain any reduced functionality if it matters.c|jdrtS|jdxs(|jdr|jdndxsdS)N setup_skippedgateway_setup_hint setup_needed setup_note)rm_SETUP_SKIPPED_NOTE)rqs r _setup_notersU(""   0 1 *6*:*:>*J &PT  r"ric |jdxsij}|Dcgc]}t|ts|D]}|}}}|ss|rqdD]l}t ||z j d}||Dcgc]>}|j s|jr%t|j|@c}z }n|Scc}}wcc}w)zHSkill-relative support file paths: from ``linked_files`` or a disk walk. linked_files) references templatesscriptsassets*) rmvaluesr.listsortedrglobis_file is_symlinkr/ relative_to) rqrilinkedentriesentry supportingsubdirfilesfs r _supporting_filesrs~.4" < < >F'-`GGT1JX_`u%`%`J` )F oFI.55c:;E %nQ199;_`_k_k_m3q}}Y78n nJ o  aosC C8C C C ractivation_noteuser_instruction runtime_note session_idcddlm}tt|j dxsd||t }|d|j g}|r|dd|dtgz }t||t|} | r |dd| dgz }t||} | rW|rU t|j|} |dd gz }|| D cgc]} d |  c} z }|jd | d |d d} |r|jdt||} |r |dd|dgz }dj!|}| 3|j#| r"t%|t%| kDr t'| |S#t$r|j} YwxYwcc} w)z9Format a loaded skill into a user/system message payload.r)rcr,r) skills_cfgz[Skill directory: r~z[Skill setup note: zP[This skill has supporting files (paths relative to the skill directory above):]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&)rjrcr r/rm_load_skills_configr_SKILL_DIR_NOTErrrr ValueErrorrr)r+r'r0rJr)rqrirrrrrcr,r#rrskill_view_targetsfr*rFs r _build_skill_messagers.& L  Y ' -2. :ReRgGb'--/ 2E "*9+Q7IIu-\*J "+J,?@AA "*+;*<=>> 99U r">.git.hub.locks.github.archivecJddlm}t|}|r||yd|d|S)uUser-facing note when *name*'s slash slug is a core command (name or alias), else None. The single source of the collision predicate: ``scan_skill_commands`` uses it to skip auto-registration (the shadowing guard from 370ebf2d3 — the skill map is consulted before built-in handlers), and the ``/skills`` listing plus the command palette render the note so the skipped skill is explained where the user looks, not only in the log. r)resolve_commandNzslash command /u4 unavailable — name taken by built-in; use /skill )hermes_cli.commandsrr!)rrcmd_names r skill_command_collision_noterSs74!$'H x08 XJ&Z[_Z` aar"skill_md seen_namescommandscddlm}m}m}m}t d|j Dry||jd\}} ||r||r||sy|jd|jj} | |vs| |vry|jdd xs0td | jjd Dd } |j| t| } | syt!| t"j%d | | | yd | } | |vrt"j%d| | || dy| | xsd| dt'|t'|jd|| <y)zGRegister one SKILL.md in *commands* (no-op when filtered or colliding).r)_parse_frontmatterskill_matches_appsskill_matches_platformskill_matches_environmentc3,K|] }|tvywN)_SCAN_SKIP_PARTS)rzparts r r}z!_scan_skill_md..es ?4# # ?sNzutf-8)encodingr descriptionrc3K|]H}|js|jjdr4|jddJyw)#NP)rr0)rzlines r r}z!_scan_skill_md..os=ut4::zaSkill %r maps to slash command %s already claimed by %r; keeping the first and skipping this one.z Invoke the z skill)rr skill_md_pathri)rjrrrranyr# read_textrmrnrnextrrBaddr!rloggerwarningr/)rrrrrrrrrbodyrrrcmd_keys r _scan_skill_mdrbs{{{ ? ??*8+=+=w+=+OPK !+ .6OP[6\dvxCeD ??68??#7#7 8D zTX-//-4utzz|'9'9$'?u 9KNN4!$'H $D)5NOSU]_c e(nG(zWhw&7&? A!%k6_{SWRXX^E_*-h-c(//FZ\HWr"ct}t}t}i} ddlm}m}ddlm}m}m }m } |} t} |} |D cgc] } ||  }} | jr| gng}|||zD cgc] } | | d c} z }|D]}|D]} t|| | | t5|a|a|a|addd|Scc} wcc} w#t$rYEwxYw#t$rY=wxYw#1swY|SxYw)a:Scan skill dirs and return {"/skill-name": {name, description, skill_md_path, skill_dir}}. Builds a local map and publishes once at the end: writing straight into the global exposed partial results to overlapping scans, which then logged bogus "already claimed" collisions against their own incumbents.r)rc_get_disabled_skill_names)get_external_skills_dirsget_project_skills_dirsiter_project_skill_filesiter_skill_index_fileszSKILL.mdN)rUrZr_rjrcrr]rrrrsetexistsrrS _publish_lockr r r r)platformhomeprojectrrcrrrrrrr skills_dirditerslocal_iterrs r scan_skill_commandsrs@ 01H ' )D-/G +-H L  -.% !] 6M6OP)!,PP * 1 1 3  IaIcAcdA(J7dd E! "8Xz8L    * ##+ #") * O1Qd !    * Os_5C/C&$C/ CC/*C 8C/ C> C/ C,)C/+C,,C// C;:C;>Dctttf}t5t}t |xrt ttf|k(}dddrStS#1swYxYw)aReturn the current skill commands mapping (scan first if empty). Rescans when the platform scope (one gateway serving Telegram and Discord) or the active profile's home (Desktop profile switch) or the session's project root (two sessions in two repos) changes, so each sees its own ``platform_disabled`` / ``external_dirs`` / project-skill view. See #14536, #88023, #114359. N) rUrZr_rr boolr r rr)currentris_freshs r get_skill_commandsrsm013O3QSrStuG {">z'?AUWn&osz&z{  8:%8%:: {{s (A""A+beforeafterc:tt|t|z Dcgc] }|||d c}tt|t|z Dcgc] }|||d c}tt|t|zt|dScc}wcc}w)zDiff two {name: description} snapshots into added/removed/unchanged/total. Removed entries carry the pre-rescan description (the file may be gone).)rr)addedremoved unchangedtotal)rrrJ)rrns r diff_command_snapshotsrsAGs5zTWX^T_G_@`a11U1X6aCI#f+X[\aXbJbCcdaQvay9dCJV45U  ads BBcmdsc|jDcic].\}}|jd|xsijdxsd0c}}Scc}}w)zL``{"/slug": info}`` -> ``{"slug": description}`` for diff_command_snapshots.r>rr)rlstriprm)rr{infos r command_snapshotrsDTXT^T^T` aysDCJJsOdjb--m<B B aa as3A c~tt}t}t|t|}t ||d<|S)a7Re-scan skill dirs and return a diff of the slash-command map (``added`` / ``removed`` / ``unchanged`` / ``total`` / ``commands``; descriptions are the full frontmatter field). Does NOT invalidate the skills system-prompt cache: skills are called by name, so ``/reload-skills`` costs no cache reset.r)rr rrrJ)r new_commandsresults r reload_skillsr s< o .F&(L #F,<\,J KF\*F: Mr"commandc*t|tS)uResolve a user-typed /command to its canonical ``/slug`` key, or None. ``_`` ≡ ``-``: Telegram disallows hyphens, so ``/claude-code`` arrives as ``/claude_code``.)resolve_slash_keyr)r s r resolve_skill_command_keyrs W&8&: ;;r"tablecB|syd|jdd}||vr|SdS)zZ``command`` -> ``"/slug"`` when present in *table* (``_`` normalized to ``-``), else None.Nr>rr)r)r rrs r rrs2 '//#s+,-G&70D0r"rctj|}|rt|d|nd}|syd|dd}t|||||S)zGBuild the user message for a skill slash command, or None if not found.rirNz&[IMPORTANT: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])rr)rrmrsr)rrrar skill_infornotes r build_skill_invocation_messagersc$%))'2JNX K!8' J^bF 4VAYK@W WD vtWGWfr ssr"restcpg}|xsd}t|tdz kr|j}|jdsnf|j dddgzdd\}}t |jd}|||vrn)|j ||}t|tdz kr||jfS)zConsume further leading ``/skill`` tokens from *rest* (text after the first matched command); stops at the first non-skill (or repeated) token, which starts the user instruction. Returns ``(extra_cmd_keys, remaining_instruction)``.rr=r>Nr)rJ_MAX_STACKED_SKILLSrr0rBrr)r)rkeys remainingstrippedtokentailrs r split_stacked_skill_commandsr! sD I d))A- -##%""3' ~~dA."5r: t+ELL,=> ?go  G  d))A- - " ""r"cmd_keysc t |Dcgc]}|s| }}t| fddd\}}}}|sydj|} td| d||| } d j| g|||fScc}w) zBuild the user message for a stacked multi-skill slash invocation: ``(message, loaded_skill_names, missing_skill_names)``, or ``None`` when no skill loaded.c6|vrt|dSdS)Nrirrs)rrras r z8build_stacked_skill_invocation_message..'s(`gks`s+HW,=k,JT[\y}r"cd|dS)Nz1[Loaded as part of the stacked skill invocation "z".]rs r r&z8build_stacked_skill_invocation_message..(sHcRr"c$|jdS)Nr>)r)ks r r&z8build_stacked_skill_invocation_message..)s#r") missing_labelNr"z" stacked skill bundle)rr )r_load_skill_blocksr'r) r"rrar+rrr _disabled skill_blockstypedheaderrs ` @r &build_stacked_skill_invocation_messager4s "#H %!1A %D %5G }R6 62L'9l  HHTNE %(>?W^rBCF KK/,/ 0, HH &s A8A8rcT ddlm}||S#t$r tcYSwxYw)zDOperator-disabled skill names (empty set when config is unreadable).r)get_disabled_skill_names)r)r]r6rSr)rr6s r _disabled_skill_namesr72s+>':: u s ''c|Srr()idents r r&r&=sr"F)r,disabled_namesdisabled_as_missingalready_loaded identifiersr:r;r<c g}g} g} g} t} |D]} | r| | vr | j| || }|s| j|| =|d}|r2||vs| |vr*|r| j| n| j|xs| v|r||vr|j|| jt|||||j||| | | fS)uLoad each distinct identifier via *load* and render its block; returns ``(loaded_names, missing, disabled, blocks)``. With *disabled_names*, members whose canonical (LOADED — identifiers may be paths) name or identifier is disabled go to ``disabled`` (or ``missing`` when *disabled_as_missing*). Canonical names in *already_loaded* (e.g. skills.auto_load) count as resolved but render no block, so one skill never lands in the prompt twice.r)rrr)r)r=loadrrar,r:r;r<rrrblocksseen identifierrrs r r/r/;s!LGHFUD!( Z4/  j! NN=4 5 AY z^;z^?["z* 8j9  jN:    +  )&/*2MwWXJ''(( (F 22r"skill_identifiersexcluded_loaded_namesc t|Dcgc]}|xsdjc}fddtd|\}}}}dj|||fScc}w)uLoad skills for session-wide CLI/TUI preloading; returns (prompt_text, loaded_skill_names, missing_identifiers). Disabled skills count as missing: this path bypasses the scan-time filter, and ``hermes -s `` must not force-load an operator-disabled skill. *excluded_loaded_names* are canonical names the session already carries (skills.auto_load): they resolve as loaded but are not rendered again. 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). rct|SNrr%rBras r r&z/build_preloaded_skills_prompt..rs.z7Kr"cd|dS)Nz9[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.]r(r)s r r&z/build_preloaded_skills_prompt..ssQRVQWXAAr"T)r:r;r<r.)r/rr7r')rCrarDrawrrr0 prompt_partss ` r build_preloaded_skills_promptrLbsj6H(9:#)   :K B  5 7T,62L'9l ;;| $lG ;; ;sA user_configc| ddlm}|}t|tr|j dnd}t|tr|j dnd}t|t sgS|Dcgc]4}t|ts|js%|j6}}t tj|S#t$rgcYSwxYwcc}w)z``skills.auto_load`` from *user_config* (else the active profile config), deduplicated; empty when unset, malformed, or the config is unreadable.Nr)load_config_readonlyskills auto_load) hermes_cli.configrOrSr.dictrmrr/rfromkeys)rMrO skills_blockrQrnamess r resolve_auto_load_skillsrW|s  >.0K1;;0M;??8,SWL1;L$1O   -UYI i & (1 ^uZs5KPUP[P[P]U[[] ^E ^  e$ %% I  _s# C-CCC CC home_overridecddlm}m}||t|nd} t |}|sdggf| ||SSt |fddt d\}}} } d j| ||f| ||SS#| ||wwxYw) aTRender ``skills.auto_load`` as fully loaded skill blocks for a new session; returns ``(prompt_text, loaded_names, missing)``. Missing and operator-disabled names are reported, never raised: a typo in config must not block session start on any surface. *home_override* makes home resolution EXPLICIT (same seam as ``build_skills_system_prompt``): the config, the disabled list and the ``/skills`` lookup all resolve under that home, so a gateway build thread that lost the HERMES_HOME ContextVar cannot pin the launch profile's skills into another profile's prompt. r)reset_hermes_home_overrideset_hermes_home_overrideNrct|SrGr%rHs r r&z(build_auto_load_prompt..s2:wOr"cd|dS)Nz[IMPORTANT: The "z" skill is auto-loaded via config (skills.auto_load). Treat its instructions as active guidance for the duration of this session unless the user overrides them.]r(r)s r r&z(build_auto_load_prompt..s-dV466r"T)r:r;r.)rYrZr[r/rWr/r7r') rarMrXrZr[ home_token auto_skillsrrr0rKs ` r build_auto_load_promptr`sVANAZ)#m*<=`dJ3.{; r2:  ! &z 2 ":L  O 7 $9$;QU : 6 gy,{{<(,?  ! &z 2 ": ! &z 2 "sA>5A>> B )u — r)rrN)rNr)rN)NN)NNN)V__doc__rkloggingrQre threadingpathlibrtypingrrrrYragent.prompt_cache_boundaryragent.skill_preprocessingr rr getLogger__name__rr r/__annotations__r r rLockrcompilerrr1r7r(r8r2r4r5escaper?SKILL_SCAFFOLD_SQL_LIKErCr!rr+r:rEr3rUrZr_tuplerSrsrrrrrrrrrrrrrrrrr rrrrr!r4r7rr/rLrWr`r(r"r rqs3X  &&0>i   8 $-/c4S>)*/*.(3-.&*hsm*)-#-  "rzz), bjj*CAn$ !19IBII&>?,NO3S88S8S8 4 c c  #"#s#s#RU#*WWSWsWXc]W %(3- % "c "3#3P#Pd PeTXY\^aYaTbdhkodoqtTtNux|N|P8 tCH~ d3i D &6 ; d38n#DcNtd{tTWy! 2sCx.2d{22 2  2 d 2 2j p $sCx.$+s2 3 pFI pTWZ^T^ pru p p"NR $4  $S :>s)d:J #Y 04S D0@47 4E bs bx} b"\T"\S"\c"\TRUW[\_ad\dWeReMf"\ko"\J3T#tCH~"563l;Dd38n!45;"4S>$sCx.TRUWZRZ^b4T#s(^ 34bc3hb tCH~ 1hsm1_a t  t$' t7:Tz tX[ t c] t #s#uT#Y^/D#(LPI3iI+.I>ADjI eCcDI-./I(C$J#&Dfk!%$3c$3