9j>_dZddlmZddlZddlmZmZmZmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZddlmZdZddZdddZdddZddZddZ 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_GUIDANCETOOL_USE_ENFORCEMENT_GUIDANCETOOL_USE_ENFORCEMENT_MODELSdrain_truncation_warnings)resolve_context_cwdcddl}|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 9/home/rurouni/.hermes/hermes-agent/agent/system_prompt.py_rar1s 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) rrr! overridesspecextra replace_textbase append_texts r_resolve_platform_hintr3@sx( 94@@I i & &i == & &D |$O 7<N,++E++11333,N dD ! !88I&&L,$$););)=)=!!##((8$$K+s##: (9(9(;(;:11K--//1177999 Krsystem_message Optional[str]Dict[str, str]c)*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-kr|d.n|d/|d0|d1j#pd0}d}|tbvrtb|}n?|r= dd2l2m3}|4|}|r|j5r|j5}n#tJ$rYnwxYwtm||}|r||g} || |js;)7tI||3}!|!r| |!g}"j8rpj9r1j8:d }#|#r|"|#j;r1j8:d4}$|$r|"|$j<rB j<=}%|%r|"|%n#tJ$rYnwxYwdd5l>m?}&|&}'d6|'@d7}(jArjBr |(d8jBz }(jr |(d9jz }(j'r |(d:j'z }(|"|(d;d<|Dd;d=| Dd;d>|"Dd?S)@uAssemble 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[[[[[[rc3 K|]}|vV dSrNrPs rrTz,build_system_prompt_parts..s(PPq!{*PPPPPPrgeminigemmagptcodexgrokc3*K|] }|jvVdSrN)valid_tool_names)rQnamers rrTz,build_system_prompt_parts..s+ttd45#99ttttttr) skills_list skill_viewr>ch|]}||SrVrV)rQtoolsets r z,build_system_prompt_parts..s0        rc3BK|]}|VdSrN)get_toolset_for_tool)rQ tool_name_rs rrTz,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)rirjmodel_environment_probe)get_environment_probe_line)_resolve_active_profile_namedefaulta6Active Hermes profile: default. Other profiles (if any) live under ~/.hermes/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: z3. This session reads and writes ~/.hermes/profiles/u/. The default profile's data lives at ~/.hermes/skills/, ~/.hermes/plugins/, ~/.hermes/cron/, ~/.hermes/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_registry)rj skip_soulr9user)nowzConversation started: z %A, %B %d, %Yz Session ID: z Model: z Provider: r%c3jK|].}|||V/dSrNr,rQrRs rrTz,build_system_prompt_parts..<UUaQU17799U UUUUUUrc3jK|].}|||V/dSrNr|r}s rrTz,build_system_prompt_parts..r~rc3jK|].}|||V/dSrNr|r}s rrTz,build_system_prompt_parts..r~r)stablecontextvolatile)Crr(r)intload_soul_identityskip_context_files load_soul_mdr'rr r]rrr rrr joinragent.prompt_builderrCbuild_nous_subscription_prompt_tool_use_enforcementr rOlistrranyrrr r frozensetagent.coding_contextrhrir Exceptionbuild_skills_system_promptprovidersplitbuild_environment_hintsrqextendtools.env_probertagent.file_safetyrur,rgateway.platform_registryrwr+ platform_hintr3build_context_files_prompt _memory_store_memory_enabledformat_for_system_prompt_user_profile_enabled_memory_managerbuild_system_prompt hermes_timerzstrftimepass_session_id session_id)+rr4_ctx_len_cc_cc_len stable_parts _soul_loaded _soul_content tool_guidance_kanban_guidancerCnous_subscription_prompt_enforce_inject _model_lowerhas_skills_toolsavail_toolsets _compact_catsrh skills_prompt _model_short _env_hintsrqrt _probe_lineruactive_profiler _default_hintrw_entry_effective_hint context_partscontext_files_promptvolatile_parts mem_block user_block_ext_mem_block _hermes_nowrztimestamp_linergrSs+` @@rbuild_system_prompt_partsrqs * 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 ###"#""       )n ) )-; ) ) ) N(b//117799LM~%%&|4   C C C C C C&**<88F 5&. 5 & 4     D -UL-PPO-O,,, "M!^,,,  # 7 "<<#%%# = % %  7  !5 6 6 6!#N  2   1+DDXNNI 1%%i000  & 2,EEfMMJ 2%%j111  "2FFHHN 6%%n555    D /..... +--CNcll?.K.KMMN >!1>=5+;=== {43ek333 ~:9999.)))KKUU<UUUUUKKUU=UUUUUKKUU>UUUUU  sl$Q99RR=V V*)V*?'W'' W43W48X XX+[ [[0` ``ct||}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. )r4r%c3K|]}||V dSrNrVr}s rrTz&build_system_prompt..s(``q^_```````rrrr)rrr _emit_status)rr4partsjoinedwarnings rrrs~ &eN K K KE [[``U8_eI6FjHY$Z``` ` `F-..$$ 7#### MrNonecXd|_|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)rs rinvalidate_system_promptrs< #'E - **,,,,,--rc|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[]functionr^ descriptionrL parametersN)r^rrrequiredF) ensure_ascii)toolsr+r'jsondumps)rformatted_toolstoolfuncformatted_tools rformat_tools_for_system_messagers ;tO //JL88M266((<44    ~.... :oE : : ::r)rrrr)rrrr r!r r"r rN)rrr4r5r"r6)rrr4r5r"r )rrr"r)rrr"r )"__doc__ __future__rrtypingrrrrrrr r r r r rrrrrrrrragent.runtime_cwdrrr3rrrr__all__rVrrrs.#""""" ,,,,,,,,,,,,"211111   ....bbbbbbJ 4----;;;;0   r