ީ^jljdZddlmZddlZddlZddlmZmZmZm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZddlmZddlmZddlm Z d Z!ddZ"dZ#ddZ$dd dZ%dd!dZ&d"dZ'd#dZ(gdZ)dS)$u@System-prompt assembly for :class:`AIAgent`. The agent's system prompt is built once per session and reused across all turns — only context compression triggers a rebuild. This keeps the upstream prefix cache warm. See ``hermes-agent-dev``'s ``references/system-prompt-invariant.md`` for the invariants and ``references/self-improvement-loop.md`` for how the background-review fork inherits the cached prompt verbatim. Three tiers are joined with ``\n\n``: * ``stable`` — identity (SOUL.md or DEFAULT_AGENT_IDENTITY), tool guidance, computer-use guidance, nous subscription block, tool-use enforcement guidance + per-model operational guidance, skills prompt, alibaba model-name workaround, environment hints, platform hints. * ``context`` — caller-supplied ``system_message`` plus context files (AGENTS.md / .cursorrules / etc.) discovered under ``TERMINAL_CWD``. * ``volatile`` — memory snapshot, USER.md profile, external memory provider block, timestamp/session/model/provider line. Pure helpers that read the agent's state. AIAgent keeps thin forwarders. ) annotationsN)AnyDictListOptional)DEFAULT_AGENT_IDENTITY!GOOGLE_MODEL_OPERATIONAL_GUIDANCEHERMES_AGENT_HELP_GUIDANCEKANBAN_GUIDANCEMEMORY_GUIDANCEOPENAI_MODEL_EXECUTION_GUIDANCEPARALLEL_TOOL_CALL_GUIDANCEPLATFORM_HINTSSESSION_SEARCH_GUIDANCESKILLS_GUIDANCESTEER_CHANNEL_NOTETASK_COMPLETION_GUIDANCETELEGRAM_RICH_MESSAGES_HINTTOOL_USE_ENFORCEMENT_GUIDANCETOOL_USE_ENFORCEMENT_MODELSdrain_truncation_warnings)resolve_context_cwd)get_hermes_home)is_truthy_valuecddl}|S)aLazy reference to the ``run_agent`` module. Helpers like ``load_soul_md``, ``build_environment_hints``, ``build_context_files_prompt``, ``build_nous_subscription_prompt``, ``build_skills_system_prompt`` and ``get_toolset_for_tool`` are imported into ``run_agent``'s namespace. Many tests ``patch("run_agent.load_soul_md", ...)``; if we imported them directly here those patches would not reach us. Looking them up through ``run_agent`` on every call preserves the patch contract. rN run_agentrs 5/home/ice/.hermes/hermes-agent/agent/system_prompt.py_rar5s agentr platform_keystr default_hintreturnc|s|St|dd}t|tr|s|S||}||St|tr1|}|r|d|n|St|ts|S|d}t|tr)|r|}n|}|d}t|tr?|r+|d|S|S)uApply a per-platform prompt-hint override to the default hint. Reads ``agent._platform_hint_overrides`` (populated from ``config.yaml`` ``platform_hints`` by ``agent_init``) and resolves the effective hint for *platform_key*: * ``replace`` — substitute the default hint entirely. * ``append`` — keep the default and append the extra text. * a bare string value — treated as ``append`` (convenience shorthand). Precedence: ``replace`` wins over ``append`` if both are present. Override text is added on top of (not instead of) the SOUL/context/ memory tiers — it only affects the platform-hint segment, so other platforms are unaffected and general system instructions still apply. Defensive: any malformed entry falls back to the unmodified default so a bad config value can never break prompt assembly or leak across platforms. _platform_hint_overridesN replaceappend)getattr isinstancedictgetr#strip) r!r"r$ overridesspecextra replace_textbase append_texts r_resolve_platform_hintr6Dsx( 94@@I i & &i == & &D |$O 7<N,++E++11333,N dD ! !88I&&L,$$););)=)=!!##((8$$K+s##: (9(9(;(;:11K--//1177999 Kr u You're in its embedded terminal pane, beside the GUI chat — the user can select your output (Option-drag on macOS, Shift-drag elsewhere) and press Cmd/Ctrl+L to send it to the chat composer.hintcz|s|St|vr|Sttjds|S|tzS)uAppend the desktop-embedded-terminal-pane clarifier to a tui hint. Triggered by ``HERMES_DESKTOP_TERMINAL=1`` (set by ``main.cjs`` only on the shell env of the desktop's embedded TUI PTY — never on the chat backend). This is a runtime-surface qualifier, not a config override, so it lives at the resolution site rather than inside ``_resolve_platform_hint`` (which is purely the config-platform_hints override applier). Byte-stable for the cache: called once per session build, deterministically from env state. Idempotent and empty-safe: re-applying on an already-augmented hint is a no-op, and an empty input returns empty (we never synthesize the clarifier without its tui framing). HERMES_DESKTOP_TERMINAL)_TUI_EMBEDDED_PANE_CLARIFIERrosgetenv)r7s r_tui_embedded_pane_clarifierr=|sM  #t++ 29%>?? @ @ . ..r system_message Optional[str]Dict[str, str]cD,-t,d}tdd}|.t|dd}t|tr|dkr|}g}d}jsjs.,|}|r||d}|s|t|ttddr!j r|ttddr!j r|tg}d j vr|td j vr|td j vr|ttd d} | r|| n%| #d j vr|t |r(|d|j r|t$dj vr#ddlm} || ,j } | r|| j rsj} d} | dus+t| t.r| dvrd} n| dus+t| t.r| dvrd} nt| t2r7jpd-t7-fd| D} n;jpd-t7-fdt8D} | r}|t:jpd}d|vsd|vr|t<d|vsd|vsd|vr|t>t7fddD}|rd,fdj DD}tA} ddl!m"}|j#tI }n#tJ$rtA}YnwxYw,&j ||pd!}nd}|r||j'd"krQd#jvr j(d#d$nj}|d%|d&jd',)}|r||j rO dd(l!m*}|+|j#tIj)n#tJ$rYnwxYwtd*dr9 dd+l,m-}|}|r||n#tJ$rYnwxYw dd,l.m/}|}n#tJ$rd-}YnwxYw|d-kr5|d.t/tazd/zng|d0|d1tad2|d3tad4tad5tad6tad7j#pd1}d}|tdvrtd|}n?|r= dd8l3m4}|5|}|r|j6r|j6}n#tJ$rYnwxYw|d9kr|r dd:l7m8}|} | 5d;pi5d9pi5d<pi}!|!5d=r|9dzttz}n#tJ$rYnwxYwtw||}"|d>kr|"rty|"}"|"r||"g}#||#|jsC,=tI||j#d?v@}$|$r|#|$g}%j>rpj?r1j>@d }&|&r|%|&jAr1j>@dA}'|'r|%|'jBrB jBC}(|(r|%|(n#tJ$rYnwxYwddBlDmE})|)}*dC|*FdD}+jGrjHr |+dEjHz }+jr |+dFjz }+j'r |+dGj'z }+|%|+dHdI|DdHdJ|#DdHdK|%DdLS)MuAssemble the system prompt as three ordered parts. Returns a dict with three keys: * ``stable`` — identity, tool guidance, skills prompt, environment hints, platform hints, model-family operational guidance. * ``context`` — context files (AGENTS.md, .cursorrules, etc.) and caller-supplied system_message. * ``volatile`` — memory snapshot, user profile, external memory provider block, timestamp line. Joined into a single string by :func:`build_system_prompt` and cached on ``agent._cached_system_prompt`` for the lifetime of the AIAgent. Hermes never re-renders parts of this string mid- session — that's the only way to keep upstream prompt caches warm across turns. Ncontext_compressorcontext_lengthrFT_task_completion_guidance_parallel_tool_call_guidancememorysession_search skill_manage_kanban_worker_guidance kanban_show computer_use)computer_use_guidance>onyestruealways>noofffalseneverc3nK|]/}t|t|vV0dSN)r,r#lower.0p model_lowers r z,build_system_prompt_parts..sA[[q STVYHZHZ[!'')){2[[[[[[r c3 K|]}|vV dSrXrZs rr^z,build_system_prompt_parts..s(PPq!{*PPPPPPr geminigemmagptcodexgrokc3*K|] }|jvVdSrX)valid_tool_names)r[namer!s rr^z,build_system_prompt_parts..&s+ttd45#99ttttttr ) skills_list skill_viewrHch|]}||Sr`r`)r[toolsets r z,build_system_prompt_parts..(s0        r c3BK|]}|VdSrX)get_toolset_for_tool)r[ tool_name_rs rr^z,build_system_prompt_parts..*sB7@'' 22r )coding_compact_skill_categories)platformcwd)available_toolsavailable_toolsetscompact_categoriesalibaba/z#You are powered by the model named z. The exact model ID is zt. When asked what model you are, always answer based on this information, not on any model name returned by the API.)coding_system_blocks)rsrtmodel_environment_probe)get_environment_probe_line)_resolve_active_profile_namedefaultzCActive Hermes profile: default. Other profiles (if any) live under z/profiles//. Each profile has its own skills/, plugins/, cron/, and memories/ that affect a different session than this one. Do not modify another profile's skills/plugins/cron/memories unless the user explicitly directs you to.zActive Hermes profile: z . This session reads and writes z /profiles/z'/. The default profile's data lives at z /skills/, z /plugins/, z/cron/, u//memories/ — those belong to a different session run from a different shell. Do NOT modify another profile's skills/plugins/cron/memories unless the user explicitly directs you to. The cross-profile write guard will refuse such writes by default; pass cross_profile=True only after explicit direction.)platform_registrytelegram)load_config_readonly platformsr2 rich_messagestui)clir)rt skip_soulrCallow_install_tree_fallbackuser)nowzConversation started: z %A, %B %d, %Yz Session ID: z Model: z Provider: r(c3jK|].}|||V/dSrXr/r[r\s rr^z,build_system_prompt_parts.. <UUaQU17799U UUUUUUr c3jK|].}|||V/dSrXrrs rr^z,build_system_prompt_parts.. rr c3jK|].}|||V/dSrXrrs rr^z,build_system_prompt_parts.. rr )stablecontextvolatile)Irr+r,intload_soul_identityskip_context_files load_soul_mdr*rr rgrrr rrr joinragent.prompt_builderrMbuild_nous_subscription_prompt_tool_use_enforcementr#rYlistr|anyrrr r frozensetagent.coding_contextrrrsr Exceptionbuild_skills_system_promptprovidersplitbuild_environment_hintsr{extendtools.env_prober~agent.file_safetyrrr/rgateway.platform_registryrr. platform_hinthermes_cli.configrrstriprr6r=build_context_files_prompt _memory_store_memory_enabledformat_for_system_prompt_user_profile_enabled_memory_managerbuild_system_prompt hermes_timerstrftimepass_session_id session_id).r!r>_ctx_len_cc_cc_len stable_parts _soul_loaded _soul_content tool_guidance_kanban_guidancerMnous_subscription_prompt_enforce_inject _model_lowerhas_skills_toolsavail_toolsets _compact_catsrr skills_prompt _model_short _env_hintsr{r~ _probe_lineractive_profiler" _default_hintr_entryr_cfg _tg_extra_effective_hint context_partscontext_files_promptvolatile_parts mem_block user_block_ext_mem_block _hermes_nowrtimestamp_linerqr]s.` @@rbuild_system_prompt_partsrs * B #H %-t 4 4C #/66 gs # # ! H!L L  u'? 11     . . .L 423332333u14886U=S64555u4d;;9@V97888M5)))_---51114555///_--- u&?FF.-....  !mu7M&M&M_---5CHH]33444 0./// ///>>>>>>1133444!@@AWXX64555 E. t   8S 9 9 hnn>N>NRq>q>qGG   :h#<#< AQAQUtAtAtGG $ ' ' Q ;,"3355K[[[[H[[[[[GG!;,"3355KPPPP4OPPPPPG  E    = > > >!K-24466L<''7l+B+B##$EFFF  $$<(?(?6\CYCY##$CDDDttttFsttttt  DIDZ   "  ( L L L L L L;;-@-B-BMM ( ( (%KKMMM (55!2-,46   +M*** ~""58EK5G5Gu{((--b11U[  :, : :%*[ : : :   ++--J(J'''    A A A A A A   $$"^+--+        D u*D11  B B B B B B4466K 1##K000    D #BBBBBB5577 ###"#"" ?,,-- .1       )n ) ))++ ) )7E ) )'6'8'8 ) )DSDUDU ) )   ) )+:*;*; ) ) ) N(b//117799LM~%%&|4   C C C C C C&**<88F 5&. 5 & 4     D z!!m!  > > > > > >''))D((;//52:::FFL"QQRYZZ`^`I}}_-- [ - 4 4 6 6 !1>=5+;=== {43ek333 ~:9999.)))KKUU<UUUUUKKUU=UUUUUKKUU>UUUUU  s$Q99RR=V V*)V*?'W'' W43W48X XX+\22 \?>\? B_ __0d55 eect||}dd|d|d|dfD}tD]}|||S)uAssemble the full system prompt from all layers. Called once per session (cached on ``agent._cached_system_prompt``) and only rebuilt after context compression events. This ensures the system prompt is stable across all turns in a session, maximizing prefix cache hits. Layers are ordered cache-friendly: stable identity/guidance first, then session-stable context files, then per-call volatile content (memory, USER profile, timestamp). The whole string is treated as one cached block — Hermes never rebuilds or reinjects parts of it mid-session, which is the only way to keep upstream prompt caches warm across turns. )r>r(c3K|]}||V dSrXr`rs rr^z&build_system_prompt..s(``q^_```````r rrr)rrr _emit_status)r!r>partsjoinedwarnings rrrs~ &eN K K KE [[``U8_eI6FjHY$Z``` ` `F-..$$ 7#### Mr NonecXd|_|jr|jdSdS)zInvalidate the cached system prompt, forcing a rebuild on the next turn. Called after context compression events. Also reloads memory from disk so the rebuilt prompt captures any writes from this session. N)_cached_system_promptrload_from_disk)r!s rinvalidate_system_promptr)s< #'E - **,,,,,--r c|jsdSg}|jD]T}|d}|d|dd|didd}||Utj|d S) zFormat tool definitions for the system message in the trajectory format. Returns: str: JSON string representation of tool definitions z[]functionrh descriptionrV parametersN)rhrrrequiredF) ensure_ascii)toolsr.r*jsondumps)r!formatted_toolstoolfuncformatted_tools rformat_tools_for_system_messager4s ;tO //JL88M266((<44    ~.... :oE : : ::r )rrrr)r!rr"r#r$r#r%r#)r7r#r%r#rX)r!rr>r?r%r@)r!rr>r?r%r#)r!rr%r)r!rr%r#)*__doc__ __future__rrr;typingrrrrrrr r r r r rrrrrrrrrragent.runtime_cwdrhermes_constantsrutilsrrr6r:r=rrrr__all__r`r rrs.#""""" ,,,,,,,,,,,,$211111,,,,,,!!!!!!   ....d2////.yyyyyx 4----;;;;0   r