,j}OdZddlmZddlZddlmZmZmZmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZddlmZdZdddZdddZddZddZgdZdS)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_GUIDANCEPLATFORM_HINTSSESSION_SEARCH_GUIDANCESKILLS_GUIDANCESTEER_CHANNEL_NOTETASK_COMPLETION_GUIDANCETOOL_USE_ENFORCEMENT_GUIDANCETOOL_USE_ENFORCEMENT_MODELS)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 8/home/ubuntu/.hermes/hermes-agent/agent/system_prompt.py_rar/s agentrsystem_message Optional[str]returnDict[str, str]c$%t$g}d}jsjs-$}|r||d}|s|t |t tddr!jr|tg}djvr|tdjvr|tdjvr|ttdd}|r||n%|#d jvr|t|r(|d |jr|td jvrd d lm}||$j}|r||jrsj} d} | dus+t)| t*r| dvrd} n| dus+t)| t*r| dvrd} nt)| t.r7jpd%t3%fd| D} n;jpd%t3%fdt4D} | r}|t6jpd} d| vsd| vr|t8d| vsd| vsd| vr|t:t3fddD} | rd$fdjDD} t=} d dlm }|j!tE}n#tF$rt=}YnwxYw$$j| |pd}nd}|r||j%dkrQd jvr j&d d!nj}|d"|d#jd$$'}|r||jrO d d%lm(}|)|j!tEj&n#tF$rYnwxYwtd'dr9 d d(l*m+}|}|r||n#tF$rYnwxYw d d)l,m-}|}n#tF$rd*}YnwxYw|d*kr|d+n|d,|d-|d.j!pd.}|t^vr!|t^|nR|rP d d/l0m1}|2|}|r!|j3r||j3n#tF$rYnwxYwg}|||js:$4tE|0}|r||g}j5rpj6r1j57d}|r||j8r1j57d1}|r||j9rB j9:} | r|| n#tF$rYnwxYwd d2l;m<}!|!}"d3|"=d4}#j>rj?r |#d5j?z }#jr |#d6jz }#j%r |#d7j%z }#||#d8d9|Dd8d:|Dd8d;|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. FT_task_completion_guidancememorysession_search skill_manage_kanban_worker_guidanceN kanban_show computer_user)COMPUTER_USE_GUIDANCE>onyestruealways>noofffalseneverc3nK|]/}t|t|vV0dSN) isinstancestrlower.0p model_lowers r z,build_system_prompt_parts..sA[[q STVYHZHZ[!'')){2[[[[[[rc3 K|]}|vV dSr5r9s rr=z,build_system_prompt_parts..s(PPq!{*PPPPPPrgeminigemmagptcodexgrokc3*K|] }|jvVdSr5)valid_tool_names)r:namers rr=z,build_system_prompt_parts..s+ttd45#99ttttttr) skills_list skill_viewr%ch|]}||Sr?r?)r:toolsets r z,build_system_prompt_parts..s0        rc3BK|]}|VdSr5)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)rRrSmodel_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)rS skip_souluser)nowzConversation started: z %A, %B %d, %Yz Session ID: z Model: z Provider:  c3jK|].}|||V/dSr5stripr:r;s rr=z,build_system_prompt_parts..}<UUaQU17799U UUUUUUrc3jK|].}|||V/dSr5rfrhs rr=z,build_system_prompt_parts..~rirc3jK|].}|||V/dSr5rfrhs rr=z,build_system_prompt_parts..rir)stablecontextvolatile)@rload_soul_identityskip_context_files load_soul_mdappendrr getattrrFrr rrr joinragent.prompt_builderr*build_nous_subscription_prompt_tool_use_enforcementr6r7r8listr[anyrrr r frozensetagent.coding_contextrQrRr Exceptionbuild_skills_system_promptprovidersplitbuild_environment_hintsrZextendtools.env_prober]agent.file_safetyr^rgrgateway.platform_registryr`get platform_hintbuild_context_files_prompt _memory_store_memory_enabledformat_for_system_prompt_user_profile_enabled_memory_managerbuild_system_prompt hermes_timercstrftimepass_session_id session_id)&rr stable_parts _soul_loaded _soul_content tool_guidance_kanban_guidancer*nous_subscription_prompt_enforce_inject _model_lowerhas_skills_toolsavail_toolsets _compact_catsrQ skills_prompt _model_short _env_hintsrZr] _probe_liner^active_profile platform_keyr`_entry context_partscontext_files_promptvolatile_parts mem_block user_block_ext_mem_block _hermes_nowrctimestamp_linerPr<s&` @@rbuild_system_prompt_partsr>s * B!L L  u'? ))     . . .L 423332333u14886U=S64555M5)))_---51114555///_--- u&?FF.-....  !mu7M&M&M_---5CHH]33444 0.//////>>>>>>1222!@@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//117799L~%%N<89999   C C C C C C&**<88F :&. :##F$8999    D  "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$O;;PP!=T T,+T,'U)) U65U6:V VV/>Y.. Y;:Y;0^ ^^r7ct||}dd|d|d|dfDS)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. )rrdc3K|]}||V dSr5r?rhs rr=z&build_system_prompt..s(^^Q\]^q^^^^^^rrlrmrn)rrt)rrpartss rrrsL &eN K K KE ;;^^5?E)4DeJFW"X^^^ ^ ^^rNonecXd|_|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[]functionrG descriptionr3 parametersN)rGrrrequiredF) ensure_ascii)toolsrrrjsondumps)rformatted_toolstoolfuncformatted_tools rformat_tools_for_system_messagers ;tO //JL88M266((<44    ~.... :oE : : ::r)rrrrr5)rrrrrr )rrrrrr7)rrrr)rrrr7)__doc__ __future__rrtypingrrrrrurr r r r r rrrrrrragent.runtime_cwdrrrrrr__all__r?rrrs.#""""" ,,,,,,,,,,,,211111   BBBBBJ _____&----;;;;0   r