eiyu|dZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z ddl m Z mZmZmZejeZ ddlmZmZmZdZn #e$rdZYnwxYwd efd Zd ed eefd ZddlZe Zed z Z dZ!dZ"ded efdZ#dZ$dZ%ej&dZ'hdZ(ded eefdZ)deed eefdZ*ded eefdZ+dLdeded eefdZ,dMdeded efdZ-ded ee eeffd Z.d!ed eefd"Z/d ed!ed eeeeeffd#Z0dNd!eded%ed dfd&Z1dMdededed e eeffd'Z2deded e eeffd(Z3 dOded)ed*ed!ed+ed e eeff d,Z4ded e eeffd-Z5ded!ed.ed e eeffd/Z6ded!ed e eeffd0Z7 dPd1edededed!ed.ed)ed*ed+ed efd2Z8d3d4e d5d6d7gd8d9d:d7d;d<d7d=d<d7d>d<d7d?d<d@dAd<d7dBd<d7dCd<d7dDd<dE d1dgdFdGZ9ddHl:m;Z;m>>.v66 e  '//FLLLFLL L ?(//F NNQSY Z Z ZLLLFLL L  WWW8)QQUVVVVVVVVW 4s=B3B CB;;Cr@i skill_pathc |tdS#t$rYdSwxYw)zCheck if a skill path is within the local SKILLS_DIR. Skills found in external_dirs are read-only from the agent's perspective. TF)resolve relative_to SKILLS_DIR ValueError)r(s r_is_local_skillr.msZ ((););)=)=>>>t uus>A AAiiz^[a-z0-9][a-z0-9._-]*$>assetsscripts templates referencesnamec|sdSt|tkr dtdSt|sd|dSdS)z>Validate a skill name. Returns error message or None if valid.zSkill name is required.zSkill name exceeds characters.zInvalid skill name 'ze'. Use lowercase letters, numbers, hyphens, dots, and underscores. Must start with a letter or digit.N)lenMAX_NAME_LENGTH VALID_NAME_REmatch)r3s r_validate_namer:sn )(( 4yy?""B_BBBB   t $ $  R4 R R R  4categoryc|dSt|tsdS|}|sdSd|vsd|vrd|dSt|tkr dtdSt |sd|dSdS) zFValidate an optional category name used as a single directory segment.NzCategory must be a string./\zInvalid category 'zn'. Use lowercase letters, numbers, hyphens, dots, and underscores. Categories must be a single directory name.zCategory exceeds r5) isinstancestrstripr6r7r8r9)r<s r_validate_categoryrCst h $ $,++~~H t h$(** Z Z Z Z  8}}&&@?@@@@   x ( (  Z Z Z Z  4r;contentcj|sdS|dsdStjd|dd}|sdS|d|dz} t j|}n!#t j$r}d|cYd}~Sd}~wwxYwt|tsd Sd |vrd Sd |vrd Stt|d tkr dtdS|| dzd}|sdSdS)z Validate that SKILL.md content has proper frontmatter with required fields. Returns error message or None if valid. zContent cannot be empty.z---zPSKILL.md must start with YAML frontmatter (---). See existing skills for format.z \n---\s*\nNzISKILL.md frontmatter is not closed. Ensure you have a closing '---' line.zYAML frontmatter parse error: z6Frontmatter must be a YAML mapping (key: value pairs).r3z&Frontmatter must include 'name' field. descriptionz-Frontmatter must include 'description' field.zDescription exceeds r5zRSKILL.md must have content after the frontmatter (instructions, procedures, etc.).)rB startswithresearchstartyaml safe_load YAMLErrorr@dictr6rAMAX_DESCRIPTION_LENGTHend)rD end_match yaml_contentparsedr%bodys r_validate_frontmatterrVs~ ==??*))   e $ $baa -55I [ZZ1Y__..223L4 -- >4443333333334 fd # #HGG V77F"">> 3vm$ % %&&)???J&<JJJJ 9==??Q&'' ( . . 0 0D dcc 4s/BB"BB"B"SKILL.mdlabelctt|tkr|dt|ddtddSdS)zCheck that content doesn't exceed the character limit for agent writes. Returns an error message or None if within bounds. z content is ,z characters (limit: za). Consider splitting into a smaller SKILL.md with supporting files in references/ or templates/.N)r6MAX_SKILL_CONTENT_CHARS)rDrXs r_validate_content_sizer\sY  7||--- - -#g,, > - -. 5 - - - 4r;c4|r t|z |z St|z S)zFBuild the directory path for a new skill, optionally under a category.)r,)r3r<s r_resolve_skill_dirr^s%,H$t++  r;cddlm}|D]L}|s|dD]}|jj|kr d|jiccS MdS)z Find a skill by name across all skill directories. Searches the local skills dir (~/.hermes/skills/) first, then any external dirs configured via skills.external_dirs. Returns {"path": Path} or None. r)get_all_skills_dirsrWpathN)agent.skill_utilsr`existsrglobparentr3)r3r` skills_dirskill_mds r _find_skillrhs655555))++11   ""  "((44 1 1H#t++000000, 1 4r; file_pathc:ddlm}|sdSt|}||rdS|jr|jdtvr0dt t}d|d|dSt|jd krd |jdd Sd S) z Validate a file path for write_file/remove_file. Must be under an allowed subdirectory and not escape the skill dir. r)has_traversal_componentzfile_path is required.z%Path traversal ('..') is not allowed.z, zFile must be under one of: z. Got: ''z5Provide a file path, not just a directory. Example: 'z /myfile.md'N)tools.path_securityrkrpartsALLOWED_SUBDIRSjoinsortedr6)rirk normalizedr"s r_validate_file_pathrts <;;;;; (''iJy))766  Kz/2/II))F?3344JWJJiJJJJ : q  gzGWXYGZgggg 4r;cDddlm}||z }|||}|rd|fS|dfS)zNResolve a supporting-file path and ensure it stays within the skill directory.r)validate_within_dirN)rnrv)rrirvtargeterrors r_resolve_skill_targetrysL777777  "F   2 2E U{ 4<r;utf-8encodingc|jddtjt |jd|jdd\}} t j|d|5}||d d d n #1swxYwYt j ||d S#t$rE t j |n-#t$r td |d YnwxYwwxYw) au Atomically write text content to a file. Uses a temporary file in the same directory and os.replace() to ensure the target file is never left in a partially-written state if the process crashes or is interrupted. Args: file_path: Target file path content: Content to write encoding: Text encoding (default: utf-8) Tparentsexist_ok.z.tmp.)dirprefixsuffixwr{Nz6Failed to remove temporary file %s during atomic writer)remkdirtempfilemkstemprAr3osfdopenwritereplacerunlinkOSErrorrrx)rirDr{fd temp_pathfs r_atomic_write_textr"sk4$777$   ! !(9>(((MB  Yr3 2 2 2 a GGG                   9i(((((  m Ii  m m m LLQS\gkL l l l l l m sTB.*B  B. BB.BB.. C=9C C='C85C=7C88C=ct|}|rd|dSt|}|rd|dSt|}|rd|dSt|}|rd|dSt |}|rdd|d|dddSt ||}|dd|d z }t||t|}|rtj |d d|dSdd |d t| tt|d }|r||d<d||d<|S)z.Create a new user skill with SKILL.md content.FsuccessrxzA skill named 'z' already exists at rarTr}rW) ignore_errorsSkill 'z ' created.)rmessagerargr<zTo add reference files, templates, or scripts, use skill_manage(action='write_file', name='{}', file_path='references/example.md', file_content='...')hint)r:rCrVr\rhr^rrr&shutilrmtreerAr+r,format) r3rDr<errexistingrrg scan_errorr!s r _create_skillrFs   C 0 3/// X & &C 0 3///  ( (C 0 3///  ) )C 0 3///4  H TtTT&AQTTT   #422I OOD4O000:%Hx)))&i00J7 it4444 :666-T---I))*5566MM F &%z nntntuynznz 6N Mr;ct|}|rd|dSt|}|rd|dSt|}|s dd|ddSt|ds dd|ddS|ddz }|r|d nd }t ||t|d}|r|t ||d|dSd d|d t|dd S)z:Replace the SKILL.md of any existing skill (full rewrite).Frrz7' not found. Use skills_list() to see available skills.rac' is in an external directory and cannot be modified. Copy it to your local skills directory first.rWrzrNTz ' updated.rrra) rVr\rhr.rc read_textrr&rA)r3rDrrrgoriginal_contentrs r _edit_skillrs{  ( (C 0 3///  ) )C 0 3///4  H t +rT+r+r+rsss 8F+ , ,` ,_T,_,_,_`` `*,H?G?P?PZx))7);;;VZx)))&hv&677J7  ' x)9 : : : :666-T---HV$%%  r; old_string new_string replace_allc |sdddS|dddSt|}|s dd|ddSt|ds dd|d dS|d}|r1t|}|rd|dSt||\}}|rd|dSn|d z }|sdd ||dS|d } ddlm} | | |||\} } } }|rS| ddt| dkrdndz}|} ddlm }|||| || z }n#t$rYnwxYwd||dS|sd n|}t| |}|rd|dS|st| }|rdd|dS| }t|| t|}|rt||d|dSdd|sd n|d|d| d| dkrdndd dS) zTargeted find-and-replace within a skill file. Defaults to SKILL.md. Use file_path to patch a supporting file instead. Requires a unique match unless replace_all is True. Fz#old_string is required for 'patch'.rNzOnew_string is required for 'patch'. Use an empty string to delete matched text.r ' not found.rarrWzFile not found: rzrr)fuzzy_find_and_replaceiz...r)format_no_match_hint)rrx file_previewrXz&Patch would break SKILL.md structure: TzPatched z in skill 'z' (z replacementsz).rr)rhr.rtryrcr+rtools.fuzzy_matchrr6rrr\rVrr&)r3rrrirrrrrwrDr new_content match_count _strategy match_errorpreviewerr_msgr target_labelrrs r _patch_skillrs R +PQQQ +|}}}4  H I +GT+G+G+GHHH 8F+ , ,` ,_T,_,_,_`` ` I (!),,  4$s33 3+IyAA   4$s33 3 4Z' ==??_ +]f>P>PQZ>[>[+]+]^^^00G 9888887M7MZ884Ki  $3$-CLL3,>,>55BG  > > > > > > ++KjRYZZ ZGG    D #   &/=::IL L A A AC 0 3/// #K00   G#GG  v{+++&i00J76#3444 :666Z HjjyZZUYZZ^iZZJMNNNwzwzTVZZZ  s D$$ D10D1crt|}|s dd|ddSt|ds dd|ddS|d}tj||j}|t krI|r5t|s| dd|dd S) zDelete a skill.Frrrraz4' is in an external directory and cannot be deleted.Tz ' deleted.r) rhr.rrrer,rcanyiterdirrmdir)r3rrres r _delete_skillrs4  H I +GT+G+G+GHHH 8F+ , ,q +oT+o+o+oppp I M) F  FNNAdd or overwrite a supporting file within any skill directory.Frrzfile_content is required.rzzFile content is rZz bytes (limit: z7 bytes / 1 MiB). Consider splitting into smaller files.rrz2' not found. Create it first with action='create'.rarTr}rN) missing_okFile 'z' written to skill ''.r)rtr6encodeMAX_SKILL_FILE_BYTESr\rhr.ryrerrcrrr&rrA) r3rirr content_bytesrrwrrs r _write_filersX i ( (C 0 3/// HLB.. +FGGG ++G4455M+++:=;::/D:::    !Y ? ? ?C 0 3///4  H o +mT+m+m+mnnn 8F+ , ,` ,_T,_,_,_`` `'(8)DDKFC 0 3/// Mt444=C]]__Vv'''999RVv|,,,&hv&677J7  ' v'7 8 8 8 8 MMTM * * * :666CICC4CCCF   r;c $t|}|rd|dSt|}|s dd|ddSt|ds dd|ddS|d}t||\}}|rd|dS|sg}t D]|}||z }|ra|dD]K} | r5|t| |L}dd|d |d |r|nd d S| |j } | |krI| r5t| s| d d|d|d dS)z2Remove a supporting file from any skill directory.Frrrraz5' is in an external directory and cannot be modified.*rz' not found in skill 'rN)rrxavailable_filesTz' removed from skill 'r)rtrhr.ryrcrprdis_fileappendrAr+rrerrr) r3rirrrrw availablesubdirdrres r _remove_filerRs i ( (C 0 3///4  H I +GT+G+G+GHHH 8F+ , ,r +pT+p+p+pqqq I' 9==KFC 0 3/// ==??   % H HFF"Axxzz HHHAyy{{H!((Q]]9-E-E)F)FGGGGiGGtGGG,5?yy4    MMOOO]F v}}s6>>;K;K7L7L EIEETEEE  r;actionc |dkr%|stddSt|||} n|dkr$|stddSt||} n|dkr:|stddS|td dSt|||||} n|d krt |} nq|d kr8|std dS|tddSt |||} n3|dkr$|stddSt ||} n dd|dd} | dr$ ddlm } | dn#t$rYnwxYwtj | dS)zz Manage user-created skills. Dispatches to the appropriate action handler. Returns JSON string with results. createzVcontent is required for 'create'. Provide the full SKILL.md text (frontmatter + body).F)reditzGcontent is required for 'edit'. Provide the full updated SKILL.md text.patchz=old_string is required for 'patch'. Provide the text to find.NzLnew_string is required for 'patch'. Use empty string to delete matched text.delete write_filezJfile_path is required for 'write_file'. Example: 'references/api-guide.md'z*file_content is required for 'write_file'. remove_filez(file_path is required for 'remove_file'.zUnknown action 'z<'. Use: create, edit, patch, delete, write_file, remove_filerrr) clear_skills_system_prompt_cacheT)clear_snapshot) ensure_ascii) tool_errorrrrrrrragent.prompt_builderrrjsondumps) rr3rDr<rirrrrr!rs r skill_managers6  GvAFGGG GtWh77 6   xgqvwww wT7++ 7   n]glmmm m  lv{||| |dJ I{SS 8  t$$ <   {jtyzzz z  JTYZZZ ZT9l;; =  YHRWXXX XdI..#.E.E.E.EFF zz)  M M M M M M , ,D A A A A A    D  :f5 1 1 11s3E EEruManage skills (create, update, delete). Skills are your procedural memory — reusable approaches for recurring task types. New skills go to u{/skills/; existing skills can be modified wherever they live. Actions: create (full SKILL.md + optional category), patch (old_string/new_string — preferred for fixes), edit (full SKILL.md rewrite — major overhauls only), delete, write_file, remove_file. Create when: complex task succeeded (5+ calls), errors overcome, user-corrected approach worked, non-trivial workflow discovered, or user asks you to remember a procedure. Update when: instructions stale/wrong, OS-specific failures, missing steps or pitfalls found during use. If you used a skill and hit issues not covered by it, patch it immediately. After difficult/iterative tasks, offer to save as a skill. Skip for simple one-offs. Confirm with user before creating/deleting. Good skills: trigger conditions, numbered steps with exact commands, pitfalls section, verification steps. Use skill_view() to see format examples.objectstring)rrrrrrzThe action to perform.)typeenumrGzSkill name (lowercase, hyphens/underscores, max 64 chars). Must match an existing skill for patch/edit/delete/write_file/remove_file.)rrGzFull SKILL.md content (YAML frontmatter + markdown body). Required for 'create' and 'edit'. For 'edit', read the skill first with skill_view() and provide the complete updated text.zText to find in the file (required for 'patch'). Must be unique unless replace_all=true. Include enough surrounding context to ensure uniqueness.zXReplacement text (required for 'patch'). Can be empty string to delete the matched text.booleanzZFor 'patch': replace all occurrences instead of requiring a unique match (default: false).zOptional category/domain for organizing the skill (e.g., 'devops', 'data-science', 'mlops'). Creates a subdirectory grouping. Only used with 'create'.zPath to a supporting file within the skill directory. For 'write_file'/'remove_file': required, must be under references/, templates/, scripts/, or assets/. For 'patch': optional, defaults to SKILL.md if omitted.z0Content for the file. Required for 'write_file'.) rr3rDrrrr<rir)r propertiesrequired)r3rG parameters)registryrc t|dd|dd|d|d|d|d|d|d |d d  S) Nrrr3rDr<rirrrrF) rr3rDr<rirrrr)rr)argskws rr&s|xx"%% XXfb ! !##*%%((;''XXn--88L))88L))HH]E22 4 4 4r;u📝)r3toolsetschemahandleremoji)rW)N)rz)NF)NNNNNNF)>__doc__rloggingrrIrrpathlibrhermes_constantsrrtypingrrrr getLogger__name__rtools.skills_guardr r r r ImportErrorrrrAr&rL HERMES_HOMEr,r7rPr.r[rcompiler8rpr:rCrVr\r^rhrtryrrrrrrrrSKILL_MANAGE_SCHEMAtools.registryrrregisterr;rrsB  AAAAAAAA------------  8 $ $WWWWWWWWWW d     DXc]4 o 8 #       "  455 CBB  #    #8C=2$3$8C=$$$$N  C  Xc]    SC4chtCH~6$38C=8TceHTNT\]`TaDa>b$RVH666c6S6DcN6666r!c!C!DcN!!!!P ^^ ^^^ ^  ^  #s(^ ^^^^BS#X.4c4c44c3h4444n+s+s+tCH~++++j:2:2 :2 :2:2 :2  :2  :2:2:2:2 :2:2:2:2D  Y//11 Y Y Y&!ZZZ7 !a!U!)!2"{ !/!N!Qs= = |v&AAA+WWv0///////    4 4 s AAA