+ iHjx$a0t$Rt^RIHt^RIt^RIt^RIt^RIHt^RI H t H t H t H t Ht^RIt^RIHt^RIHt^RIHtHtHtHt]P6!]4t/sR]R &Rs R ]R &R R lt!RRlt"RRlt#RRlt$RRlt%RRlt&RRlt'RRlt(RRlt)R(RRllt*R R!lt+R)R"R#llt,R$R%lt-R&R'lt.R#)*uSkill bundles — aliases that load multiple skills under one slash command. YAML files in ``/skill-bundles/`` (``name``, ``description``, ``skills: [...]``, optional ``instruction``; file stem = fallback name). ``/`` loads every member skill into one user message. If a bundle and a skill share a slug, the bundle wins — slash dispatch checks bundles first, on purpose. ) annotationsN)Path)AnyDictListOptionalTuple)get_hermes_home)atomic_write_text)command_snapshotdiff_command_snapshotsresolve_slash_keyslugify_skill_namedict[str, dict[str, Any]]_bundles_cachezOptional[tuple]_bundles_cache_mtimecV^8dQhRR/#)returnr)formats"8/home/ubuntu/.hermes/hermes-agent/agent/skill_bundles.py __annotate__rs\\d\c\PPR4pV'd\V4P 4#\ 4R, #)z^Bundles directory: ``HERMES_BUNDLES_DIR`` override (tests) or ``/skill-bundles``.HERMES_BUNDLES_DIRz skill-bundles)osenvirongetr expanduserr )overrides r _bundles_dirr!s7zz~~23H*24> $ $ &[8IO8[[rcV^8dQhRR/#)rr list[Path]r)rs"rrr#sggJgrc \4pVP4'd5RUUu.uF%p\VPV44Fq"NK K' upp#.#uuppi)*.yaml)r%z*.yml)r!existssortedglob)baseextfs r_iter_bundle_filesr,#sN >DQUQ\Q\Q^Q^, M,#fTYYs^6LA6LA, Mfdff Ms+Ac V^8dQhRRRR/#)rfilesr#rtupler)rs"rrr(s " " "u "rc.pVFPpVP\V4\P!VP 44P 434KR \\V44# \ dKvi;i)a Sorted ``(path, content digest)`` of the bundle files. Content, not timestamps: a same-size rewrite within one coarse mtime/ctime tick, or under host/filesystem clock skew, still moves it. Bundles are a handful of small YAML files, so reading them per check is cheap.) appendstrhashlibsha256 read_bytes hexdigestOSErrorr/r')r.entriesr+s& r _bundles_sigr9(sjG   NNCFGNN1<<>$B$L$L$NO P  !!   sA A-- A<;A<c V^8dQhRRRR/#)rpathrrOptional[dict[str, Any]]r)rs"rrr5sD%=rca\P!SPRR74pRT3Rllp\T\4'g T!R4#\TPR 4;'g SP4P4pT'g T!R 4#TPR 4;'g.p\T\4'd T'g T!R 4#TUu.uF=p\T4P4'gK$\T4P4NK? ppT'g T!R 4#\T4pT'g T!R4#R TRTR TR\S4R\TPR4;'gR4P4;'gR\T4 R2R\TPR4;'gR4P4/# \d#p\P RST4Rp?R#Rp?i\P d#p\P RST4Rp?R#Rp?ii;iuupi)z_Parse one bundle YAML; ``None`` (logged) on any error so a broken bundle can't break discovery.z utf-8-sig)encodingzCould not read bundle %s: %sNzInvalid YAML in bundle %s: %sc V^8dQhRRRR/#)rreasonr2rNoner)rs"rr'_load_bundle_file..__annotate__?s??c?d?rc6<\PRSV4R#)zBundle %s %s; skippingN)loggerwarning)r@r;s&r_skip _load_bundle_file.._skip?s/v>rzis not a mappingnamez has no nameskillszhas no skills listzhas empty skills listzyielded empty slugslugr; descriptionzLoad z skills as a bundle instruction)yaml safe_load read_textr7rDrE YAMLError isinstancedictr2rstemstriplist_slugifylen) r;dataexcrFrH raw_skillssrIrJs f r_load_bundle_filer]5s~~dnnknBC?? dD ! !'(( txx,,499 - 3 3 5D ]##(#))rJ j$ ' 'z)**&0 CjCFLLNnc!fllnjF C ,-- D>D )**fdHffc$is488M288b9??AmmuSQW[MYlEms488M288b9??A - 5tSA >>6cBDs5&G!!II I*HIIH<<IcV^8dQhRR/#rrrr)rs"rrrVs/rc\4p\V4p/pVFTp\V4pV'gKRVR, 2pWR9d'\P RWSW%,R,4KPWBV&KV VsVsV#)z\Rebuild the ``"/slug"`` -> bundle info cache; duplicate slugs keep the first (alphabetical)./rJz,Duplicate bundle slug %s from %s; keeping %sr;)r,r9r]rDrErr)r.sigoutr+infokeys r scan_bundlesrfVs  E u C%'C  # $v,  : NNI3SVS[\bSc d CN JrcV^8dQhRR/#r_r)rs"rrrks4rcv\\44p\'d \V8wd \ 4\#)z[Current bundle mapping; rescans only when the set of bundle files or their content changed.)r9r,rrrf) current_mtimes rget_skill_bundlesrjks( !3!56M >1]B rc V^8dQhRRRR/#)rcommandr2rz Optional[str]r)rs"rrrss;;; ;rc*\V\44#)ubResolve a user-typed command to its ``/slug`` key (``_`` ≡ ``-``, as Telegram rewrites hyphens).)r rj)rls&rresolve_bundle_command_keyrnss W&7&9 ::rcV^8dQhRR/#)rrzdict[str, Any]r)rs"rrrxsLLLrcZ\\4p\V\\444#)zgRe-scan and return an ``added``/``removed``/``unchanged``/``total`` diff (same shape as reload_skills).)r rr rf)befores rreload_bundlesrrxs! n -F !&*:<>*J KKrcV^8dQhRR/#)rrzlist[dict[str, Any]]r)rs"rrr~sII*IrcJ\\4P4RR7#)z6Return a sorted list of bundle info dicts for display.cVR,#)rJr)bs&rlist_bundles..sair)re)r'rjvaluesrrr list_bundlesrz~s #%,,.4G HHrc ,V^8dQhRRRRRRRRRR/#) rcmd_keyr2user_instructiontask_idz str | Noneplatformrz*Optional[tuple[str, list[str], list[str]]]r)rs"rrrs;#I#I #I$'#I7A#IT^#I/#Irc aaa\4PV4pV'gR#^RIHpHpHoHpVR,oT!VR,Uu.uFq;'gRP4NK upVV3RlV3RlSV!V4R7wrrV 'gR#T!R S R 2T R S 2.T YPR 4;'gRVR 7p RPV .V O4W3#uupi)uBuild the user message for a bundle invocation: ``(message, loaded_skill_names, missing_skill_names)`` or ``None`` if the bundle wasn't found. Uninstalled members are skipped with a note; disabled ones too, since ``_load_skill_payload`` bypasses the scan-time filter (``platform`` scopes that check — gateway passes it, None resolves from env). Disabled skills are also skipped: bundles load members via ``_load_skill_payload`` directly, bypassing the scan-time disabled filter in ``get_skill_commands()``, so the disabled list must be re-applied here. ``platform`` scopes the check to a specific platform's ``skills.platform_disabled`` config (gateway dispatch passes it explicitly because the gateway handles multiple platforms in one process); when *None*, the platform resolves from session env vars and the global disabled list still applies. Mirrors the stacked-skill gate in gateway dispatch (#58888). N)_disabled_skill_names_load_skill_blocks_load_skill_payload_scaffold_headerrHrIrLc<S!VSR7#))r~r) identifierrr~s&rrw1build_bundle_invocation_message..s .z7Krc<RS R2#)z[Loaded as part of the "z" skill bundle.]r)_name bundle_names&rrwrs0 =MNr)disabled_names"z" skill bundlezBundle: rM) lead_linesmissingdisabledextra_instructionr}z ) rjragent.skill_commandsrrrrrUjoin)r|r}r~rrdrrrskill_id loaded_namesrr skill_blocksheaderrrs&&f& @@rbuild_bundle_invocation_messagers   " "7 +D uuv,K4F26x.A.h..b   !.AKN,X6 51L8   K='Xk]C[B\fmXXm-D-J-J]mF KK/,/ 0, HH Bs CCc V^8dQhRRRR/#rrHr2rrr)rs"rrrs++#+$+rcp\V4pV'g\RV: R24h\4V R2, #)z7Return the canonical filesystem path for a bundle name.z Bundle name z normalizes to an empty slugz.yaml)rW ValueErrorr!)rHrJs& rbundle_path_forrs6 D>D <x/KLMM >tfEN **rc 0V^8dQhRRRRRRRRRRR R /#) rrHr2rIz list[str]rKrM overwriteboolrrr)rs"rrrs9c93RUgkx|rc T;'gRP4pV'g \R4hVUu.uF=p\V4P4'gK$\V4P4NK? ppV'g \R4h\V4pVP 4'dV'g\ RV 24hVP PRRR7RVRV/pTPR V3R V33U U u/uFwrV 'gKWbK up p 4\V\P!VR RR 7RR 7\4V#uupiuup p i)zWrite a bundle to disk and refresh the cache. Raises ``FileExistsError`` if the target exists and not ``overwrite``; ``ValueError`` for unusable inputs.rLzBundle name is requiredz(Bundle must reference at least one skillzBundle already exists at T)parentsexist_okrHrIrKrMF) sort_keys allow_unicode) preserve_mode) rUrr2rr&FileExistsErrorparentmkdirupdater rN safe_dumprf) rHrIrKrMrr\cleaned_skillsr;payloadkvs &&&&& r save_bundlers JJB   D 233.4GfA nc!fllnfNG CDD 4 D {{}}Y 9$@AAKKdT2%tX~FG NN}k&B]T_D`%ag%aTQefDAD%aghdDNN7eSWXhlmN KHhs!E E : E E c V^8dQhRRRR/#rr)rs"rrrsrc\V4pVP4'g\RV 24hVP4\ 4V#)zMDelete a bundle by name and return its path; ``FileNotFoundError`` if absent.z No bundle at )rr&FileNotFoundErrorunlinkrf)rHr;s& r delete_bundlers< 4 D ;;==-v 677KKMN Krc V^8dQhRRRR/#)rrHr2rr<r)rs"rrrs99S959rcL\4PR\V4 24#)z+Look up a bundle by name (slug-normalized).ra)rjrrW)rHs&r get_bundlers"   " "Qx~&6#7 88r)rLNN)rLrLF)/__conditional_annotations____doc__ __future__rr3loggingrpathlibrtypingrrrrr hermes_yamlrNhermes_constantsr utilsr rr r r rrW getLogger__name__rDr__annotations__rr!r,r9r]rfrjrnrrrzrrrrr)rs@rrs# 33,#||   8 $,.).(,o,\ g "B*; L I #IR+*9r