i7 UdZddlZddlZddlZddlmZddlmZddlmZm Z m Z ddl m Z ej eZiae ee eeffed<ejdZejd Zejd Z d#dd d ededzdefdZd$dededzdeeeefedzefdzfdZdeeefdeeddfdZ d%deeefdedzded ededef dZde ee eefffdZde ee eefffdZdede efdZ d&ded ededzdede ef d Z! d$d!eededzdeeeeeeffd"Z"dS)'zShared slash command helpers for skills and built-in prompt-style modes. Shared between CLI (cli.py) and gateway (gateway/run.py) so both surfaces can invoke skills via /skill-name commands and prompt-only built-ins like /plan. N)datetime)Path)AnyDictOptional)display_hermes_home_skill_commandsz [^a-z0-9]+z [^a-z0-9-]z-{2,})nowuser_instructionr returnc"|r.|pddnd}td|d}|rUdd|dddDddd}|pd}|ptj d }td d z |d|d z S) aReturn the default workspace-relative markdown path for a /plan invocation. Relative paths are intentional: file tools are task/backend-aware and resolve them against the active working directory for local, docker, ssh, modal, daytona, and similar terminal backends. That keeps the plan with the active workspace instead of the Hermes host's global home directory. r r-c3K|]}||V dSN.0parts z"build_plan_path..)s'EEEEEEEEEN0zconversation-planz%Y-%m-%d_%H%M%Sz.hermesplansz.md) strip splitlines _PLAN_SLUG_REsublowerjoinsplitrr strftimer)r r slug_sourceslug timestamps rbuild_plan_pathr's GW^#)r0022==??BB\^K   S+"3"3"5"5 6 6 < #e***;K LL3c33k33 4 4 4 4 S U      s%AC= C=& C=5BC== D  D r2activation_note runtime_notec(ddlm}t|dpd}|d|g}t |||dr|ddgn|dr"|dd|dd gnK|d r6|d r!|dd|d d gg}|d pi} | D],} t| tr|| -|s|rd D]} || z } | rt| dD]a} | rK| s7t| |}||b|r|r t||}n#t"$r |j}YnwxYw|d|d|D]}|d||d|d|r-|d|d||r.|d|d|d d|S)z9Format a loaded skill into a user/system message payload.r)r+rMr 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: rN setup_needed setup_note linked_files) references templatesscriptsassets*zH[This skill has supporting files you can load with the skill_view tool:]z- z- To view any of these, use: skill_view(name="z", file_path="")zPThe user has provided the following instruction alongside the skill invocation: z[Runtime note:  )r3r+r6r=rr[rRvalues isinstancelistexistssortedrglobis_file is_symlinkr8rQ ValueErrorr0r!)rBr2r\r r]r+rMrG supportingrcentriessubdir subdir_pathfrelskill_view_targetsfs r_build_skill_messager{s-,,,,,,""9--344G b'--// 2Eu---((  ^       . / /   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 _``` $ $B LLb # # # # f=N f f f   | R zhxzz{{{8 R 6|666777 99U  s"H))H=<H=cia ddlm}m}m}m}ddlm}|}t}g}| r| || ||D]}| dD]} td| jDr" | d} || \} } || sS| d| jj} | |vrx| |vr}| d d }|sa| d D]9}|}|r!|d s |d d}n:|| | dddd}t2d |}t6d|d}|s| |pd| dt9| t9| jdtd|<#t:$rYwxYwn#t:$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)r+_parse_frontmatterskill_matches_platform_get_disabled_skill_names)get_external_skills_dirszSKILL.mdc3K|]}|dvV dS))z.gitz.githubz.hubNrrs rrz&scan_skill_commands..s(VVtt::VVVVVVrzutf-8)encodingr0 descriptionr ri#NP rrTz Invoke the z skill)r0r skill_md_pathr2r-)r r3r+r}r~rrOrsetrmrQrRroanyrG read_textr=r>r0rr" startswithaddr replace_SKILL_INVALID_CHARSr_SKILL_MULTI_HYPHENr6r9)r+r}r~rrdisabled seen_names dirs_to_scanscan_dirskill_mdrMrSbodyr0rlinecmd_names rscan_skill_commandsrs O5 wwwwwwwwwwww>>>>>>,,..%%       ,    + + +4466777$' ' H$NN:66& & VVx~VVVVV#&00'0BBG(:(:7(C(C%K11+>>! &??68?3GHHDz)) x'' "-//-"D"DK&&$(JJLL$6$6t$<$<&&D#'::<=I>c:tsttS)z@Return the current skill commands mapping (scan first if empty).)r rrrrget_skill_commandsrs  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-rTr)rr)rcmd_keys rresolve_skill_command_keyrsG t-'//#s++--G!3!5!555774?rrct}||}|sdSt|d|}|s d|ddS|\}}} d| 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. Nr2r.z[Failed to load skill: r0rNz#[SYSTEM: The user has invoked the "zf" skill, indicating they want you to follow its instructions. The full skill content is loaded below.])r r])rr=rFr{) rr r)r]commands skill_infoloadedrBr2rCr\s rbuild_skill_invocation_messager,s"##Hg&&J t K!8' J J JF ?>F);>>>>*0'L)Z Sj S S S )!    rskill_identifierscg}g}g}t}|D]}|pd}|r||vr||t||}|s||]|\} } } d| d} |t | | | || d|||fS)zLoad one or more skills for session-wide CLI preloading. Returns (prompt_text, loaded_skill_names, missing_identifiers). r r.z6[SYSTEM: 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.]z )rrrrFrQr{r!) rr) prompt_parts loaded_namesmissingseenr? identifierrrBr2rCr\s rbuild_preloaded_skills_promptrRs !L LGUUD+(($*1133  Z4//  $ZAAA  NN: & & & .4+ i 7Z 7 7 7         J'''' ;;| $ $lG ;;r)r r)r r )r Nr )#__doc__r;loggingrerpathlibrtypingrrrhermes_constantsr getLogger__name__loggerr r6__annotations__compilerrrr'tupledictrFrlr[r{rrrrrrrrrs  &&&&&&&&&&000000  8 $ $-/c4S>)*/// =)) !rz-00 bj**@ @@@@ D@ @@@@*)/)/#)/d )/eTXY\^aYaTbdhkodoqtTtNux|N|)/)/)/)/X$ tCH~$ d3i$ D$ $ $ $ V LLsCx.Ld{LL L  L  LLLL^>T#tCH~"56>>>>BDd38n!45@s@x}@@@@* ## ##4Z# # c] ####P'<'<Cy'< 4Z'< 3S 49 $%'<'<'<'<'<'