+ iHj laRtk0tRt^RIt^RIt^RIt^RIt^RIt^RIHt^RI H t H t H t H t ^RIHt^RIHt^RIHtHt^RIHt]P0!]4t/t]^k/t]^k/t]^k]P<!4t]P@!R4t!]P@!R 4t"R t#R t$R t%R t&Rt'Rt(Rt)]P@!]PT!]#4R,4t+Rt,]P@!R4t-Rt.]#R,t/],R,t0Rt1RRlt2RRlt3RRlt4RRlt5RRR llt6]P@!]PT!],4R!,]-Pn,4t8]P@!R"]Pr4t:R#R$lt;R%R&ltR+R,lt?RR-R.llt@R/R0ltAR1R2ltBR3R4ltCR5R6ltDR7tER8tFRRR9]F33tGR:tHR;R<ltIR=R>ltJRR@RAlltKRBRCltLRDRRERRFRRGR?RHR?/RIRJlltM0RmtNRKRLltORMRNltPRORPltQ^ tRRQRRltSRSRTltTRURVltU/sV]^kRsW]^kRWRXltXRYRZltYR[R\ltZR]R^lt[R_R`lt\RaRblt]RcRdlt^ReRflt_RgRh/RiRjllt`RkRlltaRRmRnlltb^tcRgRh/RoRplltdRRqRrllteRRsRtlltfRuRvRwRRxRhRyR/RzR{lltgRR|R}llthRR~RlltiRRRlltjR#)zRShared slash command helpers for skills (CLI and gateway both invoke /skill-name).N)Path)AnyDictMappingOptional)display_hermes_home)register_stable_prefix)load_skills_configpreprocess_skill_content)AMBIGUOUS_SKILL_PREFIXz[^\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 "([^"]*)"[IMPORTANT: The "zE" skill is auto-loaded\. Follow its instructions for this session\.\]z=then run them with the terminal tool using the absolute path.%c0V^8dQhR\R\/#namereturnstr)formats"9/home/ubuntu/.hermes/hermes-agent/agent/skill_commands.py __annotate__rUs88S8S8c\PRVP4PRR4PRR44p\PRV4P R4#)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& rslugify_skill_namer'UsU  " "2tzz|';';C'E'M'McSV'W XC  " "3 , 2 23 77rc<V^8dQhR\R\R\/#)rparts instructionrlistr)rs"rrr\s!  4 c c rc~RPV4R,\,pVP\ V 24V#)ugAppend 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&& rappend_user_instructionr3\s:IIe$t+.GGM LL-.{m<= rcFV^8dQhR\R\\,/#rcontentr)rrr)rs"rrrls#rc\V\4'gR#VP\4'gV#\V9d!\ V\ \VP4#\V9d!\ V\\VP4#R#)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) isinstancer startswith_SKILL_INVOCATION_PREFIX_BUNDLE_MARKER _cut_after_BUNDLE_USER_INSTRUCTION_BUNDLE_FIRST_SKILL_BLOCKfind_SINGLE_SKILL_MARKERr0 _RUNTIME_NOTErfind)r6s&r+extract_user_instruction_from_skill_messagerClsn gs # #   6 7 7 '#;=VX_XdXdeew&'# the typed text. ``_hmwa_auto_load_skills`` builds each payload with ``_build_skill_message`` (activation header, body, then the skill-directory footer note) and appends the user's text as the final block. The footer's closing sentence is the reliable payload-end marker: the user's text is what follows the LAST footer. A header quoted inside a body (a skill embedding the scaffold in an example) carries no footer, so it cannot end the payload early. ``/`` renders when no user text follows, matching the single-skill describer's bare-invocation shape.Nz([^"]*)"r/c3^<"TF"wrSPV4'gKVxK$ R#5iN)r9).0startendtails& r 3_describe_auto_loaded_skill_turn..s#b3GZU4??[`KaSS3Gs- -r)r9_AUTO_LOAD_PREFIXrematchescapegrouprB_SKILL_DIR_NOTE_ENDlenlstripnext_TRAILING_BLOCK_ENDSr?r%r/split)r6 name_matchr footer_end block_endcutrMs& @r _describe_auto_loaded_skill_turnr`}s"   / 0 0"))$56DgNJ",:  A "D23JR!4&z+t+ $7 889 : A A CDb3Gbdhi i) iii "7:axtC#i.()*113R ::<<!4&z+t+ 88DJJL ! ) )T)rcRV^8dQhR\R\R\\,/#)rr6 separatorr)rrr)rs"rrrs&##s#s#RU#rc^\V\4'gR#VP\4'd \ V4#VP\ 4'gR#\ PV4pV'dVP^4MRP4pVPR4'dTMRV 2p\V4pV'dYWPJdTRPVP\4^,P44pV'dV'd V V V 2#T#V'dV#R#)uRender a slash-skill-expanded turn the way the user typed it: ``"/work — fix the title leak"``, ``"/work"`` for a bare invocation, or ``None`` when *content* is not scaffolding. ``separator=" "`` gives the literal invocation as typed (chat transcripts). A gateway auto-load scaffold (channel-bound skill on a new session) is also scaffolding: the typed request follows the skill payload, so it renders as that request — the header/body never reaches a preview or a title (#48359). NrrGr)r8rr9rQr`r:_SKILL_NAME_RErSrUr%rCr/r[SKILL_EXCERPT_JOINT)r6rbrSrlabelr*s&& rdescribe_skill_invocationrgs gs # #+,,/88   6 7 7   )E#EKKN 2 2 4DOOC((D$jE=gFK{1hh{001DEaHNNPQ 9=eWYK }5 N; N5"d"rz([^"]*)z^Skills loaded: (.+)$cFV^8dQhR\R\\,/#r5)rr,r)rs"rrrs"jjsjtCyjrcL\V\4'g.#VP\4'dQ\P V4'd4\P V4Uu.uFqP^4NK up#.#VP\4'g.#VPR^4^,p\V9du\PV4pV'dVVP^4PR4Uu.uF*qDP4'gKVP4NK, up#.#\P V4pVP\ 4'd2V'd*VP^4'dVP^4.#.#uupiuupi)aSkill names a slash-skill, bundle/stacked or gateway auto-load turn carries inline; ``[]`` for any other text. Only a complete activation header counts, so typed text that merely starts like one (``[IMPORTANT: The "config" file is broken]``) is not mistaken for a skill load.r.,)r8rr9rQ_AUTO_LOAD_HEADER_RErSfinditerrUr:r[r;_BUNDLE_LOADED_REsearchr%rdendswithr@)r6mheaderloadednrSs& rskills_loaded_by_scaffoldrtsB gs # # +,,OcOiOijqOrOr$8$A$A'$JK$Jq $JKzxzz   6 7 7 ]]4 #A &F"))'2OU6<<?#8#8#=K#=a  #=K][]]   )E%/CDDSXS^S^_`SaSaEKKN igiiL Ls&FF! F!c ^V^8dQhR\R\R\R\\,/#)rmessagemarker stop_markerrrE)rs"rrrs2WWWSWsWXc]WrcV!V4pV^8dR#W\V4,RPV^4^,P4;'gR#)z`Text between *marker* (located with ``find``) and *stop_marker*, stripped; None if absent/empty.N)rWr[r%)rvrwrxr? marker_idxs&&&& rr<r<sNfJA~ F +, - 3 3K CA F L L N V VRVVrc:V^8dQhR\\,/#rrrr)rs"rrrs % %(3- %rc^RIHp\P!R4;'g V!R4pT;'gR# \d\P!R4pL/i;i)azCurrent 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). )get_session_envHERMES_PLATFORMHERMES_SESSION_PLATFORMN)gateway.session_contextrosgetenv Exception)rresolved_platforms r _resolve_skill_commands_platformrsY9;II&78ffOLe^RIHpV!4pVe \V4#R#)aThe project root the scan's project skills resolve from (None outside a repo). One multi-session host serves sessions in different repos; without this tag the first session's project skills stayed published for every other session's ``get_skill_commands`` lookup (#114359).)find_project_rootN)agent.skill_utilsrr)rroots r_resolve_skill_commands_projectrs#4  D(3t92d2rc V^8dQhR\R\R,R\\\\3,\R,\3,R,/#)rskill_identifiertask_idNr)rtupledictrr)rs"rrrsQPP#Pd PeTXY\^aYaTbdhkodoqtTtNux|N|Prc^RIHpV!4'dR#T;'gRP4pV'gR#^RIHpHp^RIHpV!V4p\P!V!WqRR74pTPR4'gR#\TPR 4;'gR4p Rp TPR 4'd\TR ,4p M*T 'd#T!4\T 4P, p Y\TPR 4;'gT43# \dR#i;i \dRp LGi;i) zOLoad a skill by name/path and return (loaded_payload, skill_dir, display_name).safe_worker_enabledNr) _skills_dir skill_viewnormalize_skill_lookup_nameF)r preprocesssuccesspath skill_dirr)agent.safe_worker_policyrr%tools.skills_toolrrrrjsonloadsrgetrrparent) rrrraw_identifierrrr normalized loaded_skill skill_pathrs && r_load_skill_payloadrs<&,,"335N =A0@ zz*ZUZ"[\    I & &\%%f-334JI $$k23  # Z(8(?(??I C (8(8(@(N(NJ$O OO  I s#4D(!!D:( D76D7: E  E cRV^8dQhR\R\R\\,/#)r identifierpayloadr)rrr)rs"rrrs*oocoDoXc]orc\V\4'dVPR4MRpV'd\ V RRP V4 2#R#)u``Ambiguous skill name X: use one of `` when a failed skill_view *payload* is a same-tier name collision, else None — so preload/cron say why instead of "Unknown"/"not found". load_namesNz : use one of , )r8rrr r/)rrrs&& rambiguous_skill_labelrsI/9$.G.G\*TJZd$ %j\tyy?T>U Vnjnnrc0V^8dQhR\R\/#)rrrr)rs"rrr$sDDSDSDrc^RIHp^RIHp\P !V!V!V4RR74p\Y4;'gT# \ dTu#i;i)zZDisplay form of an identifier that failed to load (failure path only: re-asks skill_view).)rrF)r)rrrrrrrr)rrrrs& r_missing_skill_labelr$sU0A**Z(CJ(O\abc ! 5 C CC s0A AAcFV^8dQhR\\,R\/#)rmissingrr+)rs"rrr/s"cc49ccrcVUu.uF!qP\4'gKVNK# ppVUu.uF qV9gK VNK ppRPY#'d RRPV4 2.,4#.,4#uupiuupi)zOne error line for unresolved preload identifiers: ambiguous ones keep their own wording, the rest are reported as ``Unknown skill(s): ...``.z; zUnknown skill(s): r)r9r r/)rrp ambiguousunknowns& rformat_missing_skillsr/s$LGq||4J'KGIL!8'Qi%7qq'G8 99YQX%7 '8J7K#L"Ma bb^`a bbM8sBBB B clV^8dQhR\\\3,R\\,RR/#)rrr)rN)rrrr,)rs"rrr7s-  tCH~ d3i D rc^RIHpHpHp\ VP R4;'gVP R4;'gR4pV!V4wrgV!V!V44pV'gR#VP R4VP R\4 R24VPRVP444VP R 4R# \dR#i;i) zAppend a ``[Skill config: ...]`` block with resolved ``metadata.hermes.config`` values so the agent needn't read config.yaml. Any failure leaves the message without it.)extract_skill_config_varsparse_frontmatterresolve_skill_config_values raw_contentr6rNz[Skill config (from z/config.yaml):c3\"TF"wrRT RV'd \V4MR 2xK$ R#5i)z z = z (not set)Nr)rJkeyvalues& rrN'_inject_skill_config..Cs*l[kZSr#c#e*;!GH[ks*,]) rrrrrrr1rextenditemsr) rr)rrrr frontmatterrresolveds && r_inject_skill_configr7s  oo,**=9^^\=M=Mi=X^^\^_ *;7 ./H/UV  R +,?,A+B.QR l[c[i[i[kll S    s#&CC'C+A%C 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.z/scripts/foo.js`).z [This skill has supporting fileszwRequired environment setup was skipped. Continue loading the skill and explain any reduced functionality if it matters.chV^8dQhR\\\3,R\\,/#)rrr)rrrr)rs"rrrYs&d38n#rcVPR4'd\#VPR4;'g5VPR4'dVPR4MR;'gR#) setup_skippedgateway_setup_hint setup_needed setup_noteN)r_SETUP_SKIPPED_NOTE)rs&r _setup_noterYse((""   0 1  *6*:*:>*J*J &PT   rcV^8dQhR\\\3,R\R,R\\,/#)rrrNr)rrrrr,)rs"rrras2  DcN td{ tTWy rc>VPR4;'g/P4pVUUu.uF=p\V\4'gKVFp\ V4P 4NK K? pppV'gV'dRFp\ W, PR44pYWUu.uFQqP4'gKVP4'dK2VPV4P 4NKS up, pK V#uuppiuupi)zHSkill-relative support file paths: from ``linked_files`` or a disk walk. linked_files*) references templatesscriptsassets) rvaluesr8r,ras_posixsortedrglobis_file is_symlink relative_to) rrlinkedentriesentry supportingsubdirfilesfs && r_supporting_filesras~.44" < < >F8>qW*WVZB[(ip`e$u+&&(ip(Jq )FFI.55c:;E t1QZQZQ\>efeqeqes>1==3<<>t tJ G r usD &D.D D"#DrcV^8dQhR\\\3,R\R,R\R\R\R\R,R\/#) rrrNactivation_noteuser_instruction runtime_note session_idr)rrrr)rs"rrrns^22sCx.2d{22 2  2 d 2 2rc^RIHp\\VP R4;'gR4W\ 4R7pVRVP 4.pV'dVRRV R2\., p\W4\V4p V 'dVRRV R2., p\W4p V 'dlV'dd\VPV!444p VRR ., pYU u.uFp R V 2NK up , pVPR V R V \ 24R p V'dVPR4\!W4p V'dVRRV R2., pRP#V4pV e<VP%V 4'd%\'V4\'V 48d \)V 4V# \d3\TP R4;'g TP4p ELi;iuup i)z9Format a loaded skill into a user/system message payload.)rr6r) skills_cfgz[Skill directory: r[Skill setup note: rzP[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 Nz[Runtime note: r.)rrr rr_load_skills_configr%_SKILL_DIR_NOTErrrr ValueErrorrr1_SUPPORTING_FILES_ENDr3r/r9rWr)rrrrrrrr6r)rrskill_view_targetsfr2rvs&&&&&& r_build_skill_messagerns.& L  Y ' - -2. ReRgGb'--/ 2E "*9+Q7II-\*J "+J M R0H  " ~Q788iiG W%7%7 %F%F3ws)d:J #Y 04S D0@47 rcRV R\V4 R2R.T;'g.ORRPV4 2NpV'd$VPRRPV4 24V'd$VPRRPV4 24V'dVRR V 2., pV'dVRR V 2., pR PV4#) zHeader for multi-skill messages (bundles and stacked invocations). ``subject`` must end in " skill bundle" so the bundle-format extractor applies.r z , loading zL skills together. Treat every skill below as active guidance for this turn.]rzSkills loaded: rzSkills missing (skipped): z-Skills disabled for this platform (skipped): zBundle instruction: zUser instruction: r.)rWr/r1)r r rrrrrliness&&$$$$$ r_scaffold_headerr s 0y9|$%&- -        $))L123  E 1$))G2D1EFG DTYYxEXDYZ[ ",->,?@AA "*+;*<=>> 99U rcFV^8dQhR\R\\,/#rrE)rs"rrrs" b bs bx} brc\^RIHp\V4pV'd V!V4fR#RV RV 2#)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. )resolve_commandNzslash command /u4 unavailable — name taken by built-in; use /skill )hermes_cli.commandsrr')rrcmd_names& rskill_command_collision_noters74!$'H x08 XJ&Z[_Z` aarc V^8dQhR\R\R\R\\\\\3,3,RR/#)rskill_mdr seen_namescommandsrN)rsetrrr)rs"rrrsO"\"\T"\S"\c"\TRUW[\_ad\dWeReMf"\ko"\rc ^RIHpHpHpHp\ ;QJd&RVP 4F 'gK RM RM!RVP 44'dR#V!VPRR74wrV!V4'dV!V4'dV!V4'gR#VPRVPP4p W9gW9dR#VPR R 4;'g1\R V P4PR 44R 4p VPV 4\V 4p V 'gR#\!V 4e\"P%R WV 4R#RV 2p W9d'\"P%RWW=,R,4R#RT R T ;'gRV R2R\'V4R\'VP4/W=&R#)zGRegister one SKILL.md in *commands* (no-op when filtered or colliding).)_parse_frontmatterskill_matches_appsskill_matches_platformskill_matches_environmentc32"TF q\9xK R#5irI)_SCAN_SKIP_PARTS)rJparts& rrN!_scan_skill_md..s ?# #sTFN utf-8-sig)encodingr descriptionrc3"TFZqP4'gKVP4PR4'dKAVP4R,xK\ R#5i)#:NPNN)r%r9)rJlines& rrNr!sDu'?t::< X\XbXbXdXoXopsXt c  '?sA$"A$A$r.zSkill %r generates slash command '/%s' which collides with a core Hermes command; skipping auto-registration. Use '/skill %s' instead.rGzaSkill %r maps to slash command %s already claimed by %r; keeping the first and skipping this one. Invoke the z skill skill_md_pathr)rrrrranyr) read_textrrrrYr%r[addr'rloggerwarningr)rrrrrrrrrbodyrr$rcmd_keys&&&& r_scan_skill_mdr2s{{ s ? ?sss ? ???*8+=+={+=+STK !+ . .6OP[6\6\dvxCeDeD ??68??#7#7 8D T-//-4utzz|'9'9$'?u 9KNN4!$'H $D)5NOS_c e(nGzh&7&? A}k6_6_{SWRXX^E_(#h-c(//FZ\HrchV^8dQhR\\\\\3,3,/#r|rrr)rs"rrrs%**T#tCH~"56*rc^RIHpV!4'd/#\4\4\ 43p\ 4p/p^RIHpHpV!4p\4pV!4F1pVR,R8XgK\\VR,4WgV4K3 \;_uu_4V\ V&V\"V&R R R 4V# \dKni;i \d\PRRR7Lai;i +'giT#;i) 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)_get_disabled_skill_names_skill_catalogstatusuniquerzSkill command scan failedTexc_infoN)rrrrr_skill_dirs_signaturerr6r7rr2rrr.debug _publish_lock_skill_commands_by_key_skill_commands_sig_by_key) rr signaturerr6r7rrrs rscan_skill_commandsrBs = + -/K/MOnOp qC&'I*,HAO,.% $%EX(*"4f #6hW& '/s#*3"3'  O! A 04 @A  OsB.C4CC#C: C CCC"C76C7: D c$V^8dQhR\/#r|)r)rs"rrr5sErc 6^RIHpHp^RIHpHp\ ;_uu_4\\4pRRR4\XUUUu0uFwrVqv'gKWg3kK uppp4R\pRR\43.p VFcwrgV!V4p T!T;'g\PP4p V PWg\434V!V 4V!V 4Ke \!V 4# +'giL;iuupppi T!T 4T!T 4i;i)a9Signature of every skill scope a session has resolved commands for, plus the ambient one. One gateway serves sessions in several profiles and repos; each published ``(platform, home, project)`` key names a scope whose roots (that profile's skills/external dirs, that repo's trusted project skills) a viewer is looking at. The change watcher (``skills.changed``) compares this, so an install in a session's repo B notifies viewers even when the gateway was launched in repo A. Only command maps/catalogs refetch; a conversation's stored system prompt is never rebuilt. )reset_session_cwdset_session_cwdreset_hermes_home_overrideset_hermes_home_overrideNr)agent.runtime_cwdrErFrrHrIr>r,r?r_MAX_WATCHED_SCOPESr<rrsepr1r) rErFrHrIkeys _platformhomeprojectscopesrows home_token cwd_tokens rpublished_scopes_signaturerU5sEU *+  TRT)A'T_d_TR SThUh iF ,. / 0D -d3 #G$:$:rww{{;  3 KK(=(?@ A i ( &z 2  ; R i ( &z 2s#C, C? C? 2D, C< Dc:V^8dQhR\\,/#r|)rr)rs"rrrPs  x rc^RIHpHpHpV!4wr4T!VUUu.uFwrVVNK uppV!44#uuppi \d\ P RRR7R#i;i)aStat-cheap change signature of every skill root (the catalog's own: the mtime and child names of every directory the catalog walks, depth-bounded, plus the disabled set and the platform). None when it cannot be computed (a root that cannot be stat'ed), which keeps the published map rather than rescanning on every lookup. Any other error raises: the catalog scan itself takes the same signature unguarded (``tools.skills_tool._skill_catalog``), and a swallowed bug would pin a stale map silently.)r6skill_search_dirs_skills_scan_signaturezSkill dir signature failedTr:N)rr6rXrYOSErrorr.r=)r6rXrYroots_active_tierds rr<r<Psb gf*,%&?XUq&?AZA\]]&?  1D As= 7 =="A#"A#chV^8dQhR\\\\\3,3,/#r|r4)rs"rrr_s%!!Dd38n!45!rc^^RIHpV!4'd/#\4\4\ 43p\ ;_uu_4\ PV4p\PV4pRRR4Xe\4pVe XeWC8XdV#\4# +'giL8;i)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, #104849. rN) rrrrrr>r?rr@r<rB)rrcached scanned_atcurrents rget_skill_commandsrd_s= + -/K/MOnOp qC '++C0/33C8  () ?j0G4IM    s +B B, cV^8dQhRR/#)rrN)rs"rrrs**$*rcd\;_uu_4/sRsRRR4R# +'giR#;i)z(Drop the cached plugin skill projection.N)r>_plugin_skill_commands_plugin_skill_commands_tagrfrr invalidate_plugin_skill_commandsrjs! !#%)" s / chV^8dQhR\\\\\3,3,/#r|r4)rs"rrrs%4T#s(^(;#<rc^RIHp^RIHpHp^RIHp^RIHpV!4V!4pVP4p\V!44\;QJd.RV4FNK 5M !RV443p\;_uu_4\\V8HrRRR4X 'g \WVV4pV!4p V!4p V 'g V 'gX#XP!4U U u/uFewrV R,V 9dKV R,P#R^4^,V 9dK<V R,P#R^4^,V 9dKcWbKg up p # +'giL;iuup p i) zProject enabled plugin skills into the interactive-only slash namespace (``/plugin:skill``). Config disable lists (``skills.disabled``, ``plugins.disabled``) are applied on EVERY call, so a config-only disable takes effect without a rescan. get_disabled_skill_names)discover_pluginsget_plugin_manager)_get_disabled_pluginsrc3j"TF)p\VPR4;'gR4xK+ R#5i)rrN)rr)rJrps& rrN,get_plugin_skill_commands..s((T8aQUU6]-@-@b)A)A8s!33Nr:)rrnhermes_cli.pluginsrorphermes_cli.plugins_discoveryrqrrlist_plugin_skill_metadatarrr>rhri_scan_plugin_skill_commandsrr[)rnrorprqrmanagermetadatatagrais_freshrdisabled_pluginsrinfos rget_plugin_skill_commandsrs$ ;GB0 "G113H  !55(T8(T55(T8(T#T UC 13MQT3T  ,WD')H,. , #)<<> #1icV ( ,0L,>,>sA,Fq,IX,U <%%c1-a04DD  >   s$E!E#8"E#"E#E# E c V^8dQhR\R\R\\\\\3,3,/#)rrzr{r)r,rrrr)rs"rrrs8##4#e#SRVWZ\_W_R`M`Ha#rc ^RIHpHpHpHp/pVEFkp\ VP R4;'gR4P4p RV 9dK?VPV 4p V eV P4'gKlV!V PRRR74wrT!T 4'dT!T 4'dT!T 4'gKR T P4 2p \T 4fY9d\PR T 4KRT R \ T P R 4;'g TP R 4;'gR T R 24P4RT R\ T 4R\ T P 4RR/Y}&EKn \";_uu_4WrussRRR4V# \dEKi;i +'giT#;i)zIBuild the plugin skill projection and publish it with its tag atomically.)rrrrrrrtNr"r#)r#errorsrGzAPlugin skill %r collides with an existing slash command; skippingr$r)z plugin skillrr*rsourceplugin)rrrrrrrr%find_plugin_skillrr,rZr"rr.r/rr>rhri)ryrzr{rrrrrr qualifiedrparsedrrs&&& rrxrxs +-H &)//R0668 i  ,,Y7  8#3#3#5#5  *8+=+={[d+=+efIF'v..3LV3T3TYklrYsYs )//#$% ' 2 >#/ NN^`i j  I}c&**]2K3\3\uyyYfOg3\3\7B9+]5[/]]b]b]d  ?CM X__-x   %0 =E: :  O#     Os>FF1 F.-F.1 G c V^8dQhR\\\\\3,3,R\\\\\3,3,R\\\\\3,3,/#)rfilesystem_commandsplugin_commandsrr4)rs"rrrs]  c4S>12 EI#tTWY\T\~J]E^  #tCH~  rc\V4pVP4F5wr4W29d'\PRW2V,R,4K1WBV&K7 V#)zFMerge interactive sources with filesystem commands winning collisions.z3Plugin skill %r collides with %r; keeping the firstr)rrr.r/)rrrcommandr~s&& r!_merge_interactive_skill_commandsrsU'(H(..0    NNPRYdk[lms[t u $W  1 OrchV^8dQhR\\\\\3,3,/#r|r4)rs"rrrs%S$sCx.-@(Arc\4\4\43p\\ 4\ 44p\ ;_uu_4\V4\V&RRR4V# +'giT#;i)zFilesystem skills plus profile-scoped plugin skills; never use for messaging/native command menus (plugin skills are CLI/TUI/desktop only).N) rrrrrdrr>r'_last_interactive_skill_commands_by_key)identityrs rget_interactive_skill_commandsrsZ124P4RTsTuvH01C1EG`GbcH <@N/9  O  Os A%% A6 cV^8dQhR\\\3,R\\\3,R\\\3,/#)rbeforeafterrr4)rs"rrrs<4S>$sCx.TRUWZRZ^rc pR\\V4\V4, 4Uu.uFpRVRW,/NK upR\\V4\V4, 4Uu.uFpRVRW,/NK upR\\V4\V4,4R\V4/#uupiuupi)zDiff two {name: description} snapshots into added/removed/unchanged/total. Removed entries carry the pre-rescan description (the file may be gone).addedrr$removed unchangedtotal)rrrW)rrrss&& rdiff_command_snapshotsrs s5zTWX^T_G_@`a@`161mUX6@`a6#f+X[\aXbJbCcdCcaVQ vy9CcdVCJV45U  ads B.&B3 cV^8dQhR\\\\\3,3,R\\\3,/#)rcmdsrr4)rs"rrrs8bb4T#s(^ 34bc3hbrcVP4UUu/uF:wrVPR4T;'g/PR4;'gRbK< upp#uuppi)zL``{"/slug": info}`` -> ``{"slug": description}`` for diff_command_snapshots.rGr$r)rrXr)rrr~s& rcommand_snapshotrsMTXT^T^T` aT`ysCJJsOdjjb--m<BB BT` aa asAA AcFV^8dQhR\\\3,/#r|r4)rs"rrrs""tCH~"rc\4\4\43p\;_uu_4\P V4pRRR4Xf\;_uu_4\ \P V/44p\'dC\^,V^,8Xd*\P4Fwr#W!9gK W1V&K RRR4\V4p\;_uu_4\P4RRR4^RI HpV!4\4\!4p\#V\%44p\V4p\'WH4p \;_uu_4V\V&RRR4\)V4V R&V # +'giELJ;i +'giL;i +'giL;i +'giLZ;i)aRe-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. The plugin projection is rebuilt too, so a plugin enabled/disabled/installed since the last scan shows up without a restart.N)clear_skills_cacher)rrrr>rrrr?rirhrrclearrrrjrBrrrrW) rbefore_commandsrr~rr new_commandseffective_commandsrresults r reload_skillsrsJ , -/K/MOnOp qC AEEcJ ]"#9#=#=c2#FGO)).H.KsSTv.U%;%A%A%CMG5370&D o .F  $$& 5$&&(L: ``"/slug"`` when present in *table* (``_`` normalized to ``-``), else None.NrGrr)r"r#)rr exact_keyr1s&& rrr%sX GMMO$%I'//#s+11345G&70D0rc xV^8dQhR\R\R\R,R\R\\,/#)rr1rrNrrrE)rs"rrr0sC t t  t$' t7:Tz tX[ t c] trc\4PV4pV'd.\VPR4;'g VR,VR7MRpV'gR#RV^, R2p\WVW!VR7#)zGBuild the user message for a skill slash command, or None if not found.rrrNz&[IMPORTANT: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])rr)rrrr)r1rrr skill_inforrnotes&&&& rbuild_skill_invocation_messager0sv0155g>Jt~ 0B!C!^!^zR]G^ho pEIF 4VAYK@W WD vWfr ssrctV^8dQhR\R\R\\\,\3,/#)rrestrr)rrrr,)rs"rrrCs3##s#D#USWX[S\^aSaMb#rc.pT;'gRp\V4\^, 8dVP4pVPR4'gM_VP R^4R.,R,wrV\ VPR4VR7pVeWr9dMVP V4TpKW#P43#)aiConsume 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)``. Native callers (messaging gateway) must pass ``interactive=False``: plugin skills are interactive-only and must not resolve here.rrGN:NrN)r)rW_MAX_STACKED_SKILLSrXr9r[rr1r%)rrrM remainingstrippedtokenrMr1s&$ rsplit_stacked_skill_commandsrCs D I d))A- -##%""3'' ~~dA."5r: +ELL,=;W ?go  G " ""rc V^8dQhR\\,R\R\R,R\\\\\,\\,3,,/#)rcmd_keysrrNr)r,rrr)rs"rrrXsSII3iI+.I>ADjI eCcDI-./Ircaa \4o VUu.uFq3'gK VNK pp\VV V3RlRSRR7wrVrxV'gR#RPV4p \RV R2WVVR 7p R PV .VO4WV3#uupi) zBuild the user message for a stacked multi-skill slash invocation: ``(message, loaded_skill_names, missing_skill_names)``, or ``None`` when no skill loaded. Keys come from ``split_stacked_skill_commands``; native callers only ever pass filesystem keys.c<VS9d<\SV,PR4;'gSV,R,SR7#R#)rrrN)rr)r1rrs&r8build_stacked_skill_invocation_message..bscNUYaNa+HW,=,A,ABT,U,w,wYabiYjkvYwBIJkgkkrcRV R2#)z1[Loaded as part of the stacked skill invocation "z".]rfrs&rrrcsHcRrc$VPR4#)rG)rX)ks&rrrds #r) missing_labelNr"z" stacked skill bundle)rr )r_load_skill_blocksr/r ) rrrrrMr r _disabled skill_blockstypedrqrs &&f @r&build_stacked_skill_invocation_messagerXs ./H %x!1AAxD %5G  kR6 62L9  HHTNE %(>?rBCF KK/,/ 0, HH &s BBc>V^8dQhR\R,R\/#)rplatformNr)rr)rs"rrrmsC$J#rcX^RIHpV!VR7# \d\4u#i;i)zDOperator-disabled skill names (empty set when config is unreadable).rm)r)rrnrr)rrns& r_disabled_skill_namesrms+>':: u s ))rcV#rIrf)idents&rrrxsrdisabled_namesdisabled_as_missingalready_loadedc.V^8dQhR\\,R\R,R\R,R\R\R,R\\\,\\,\\,\\,3,/#)r identifiersrNrrrr)r,rrrr)rs"rrrvsn%3%3c%3`` 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). rrc<\VSR7#rrrrs&rr/build_preloaded_skills_prompt..s .z7KrcRV R2#)z9[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.]rfrs&rrrsQRVQWXAArT)rrrrr)rrr,rr%rrr/) rrrrrawr rr prompt_partss &f& rbuild_preloaded_skills_promptrs=2t-...5G(9:(9))   (9:K B 3DYD[ 1F62L9 ;;| $l ;; ;s BBcTV^8dQhR\R,R\\,/#)r user_configNr)rr,r)rs"rrrs"&&$+&c&rcVf^RIHpV!4p\V\4'dVP R4MRp\V\4'dVP R4MRp\V\ 4'g.#VUu.uFCp\V\4'gKVP4'gK3VP4NKE pp\ \PV44# \d.u#i;iuupi)z``skills.auto_load`` from *user_config* (else the active profile config), deduplicated; empty when unset, malformed, or the config is unreadable.N)load_config_readonlyskills auto_load) hermes_cli.configrrr8rrr,rr%fromkeys)rr skills_blockrrnamess& rresolve_auto_load_skillsrs  >.0K1;;0M0M;??8,SWL1;L$1O1O   -UYI i & & (1 ^ uZs5K]PUP[P[P]]U[[] E ^  e$ %% I  _s# C*C=C=6C=* C:9C:c V^8dQhR\R,R\R,R\R,R\\\\,\\,3,/#)rrNr home_overrider)rrrrr,)rs"rrrsN33 4Z3-1D[3PTW[P[3 3S 49 $%3rc 4a^RIHpHpVeV!\V44MRp\ V4pV'gR..3Ve V!V4##\ VV3RlRS\ 4RR7wrxrRPV 4Wx3Ve V!V4## Te T!T4ii;i) a<Render ``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. rGNrc<\VSR7#rrrs&rr(build_auto_load_prompt..s 2:wOrcRV R2#)r 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.]rfrs&rrrs-dV466rT)rrr)rrHrIrrrrr/) rrrrHrIrS auto_skillsr rrrs f&& rbuild_auto_load_promptrsVANAZ)#m*<=`dJ3.{; r2:  ! &z 2 ":L  O 7 $9$;QU : 6 y{{<(,?  ! &z 2 ": ! &z 2 "sB3B=BBc(V^8dQh/^\9d=\\\\\\\3,3,3,;R&^\9d=\\\\\\\3,3,3,;R&^\9d\\\3,;R&^\9d,\\\\\3,3,;R&^\9d\ \,;R&#)rr?rr@rhri)__conditional_annotations__rrrrr)rs"rrrsXX6DCUDd38n)<$==>C7Y<UTeT#tCH~:M5N.N)OT=YD43D.3EY|76S$sCx.016}Y~32HUO2Yr)u — rI)z[Skill config (z ])rz] )rrN>.git.hub.locks.github.archive)rNr)rN)NN)NNN)lr__doc__rloggingrrR threadingpathlibrtypingrrrrrragent.prompt_cache_boundaryragent.skill_preprocessingr rr rr getLogger__name__r.r?rr@Lockr>compiler r$r:r@r0rAr;r=r>rTrdrQ_AUTO_LOAD_SUFFIX_RErVSKILL_SCAFFOLD_SQL_LIKEAUTO_LOAD_SCAFFOLD_SQL_LIKErer'r3rCr`rgpatternrk MULTILINErmrtr<rrrrrrrrrrrZrrrrrr rrr2rBrKrUr<rdrhrirjrrxrrrrrrrrrrrrrrrrr)rs@rrsX  //0>i4   8 $BDCSU'T243 zz),jj*CAn$ !19BII&>?,NO (zz"jkV3S80#58  "*:#<zz")),=">"KNbNjNj"jkJJ7Fj$W % "3P@oDc &6-24T;=RSU;  2j p MQ $CG :<4E b"\J*\6 !@576.22*<#L b "Jq5q1 t #5#*I*%3%%3DH%3fk%3"&%3P<<&"33r