FjHdZddlmZddlZddlZddlmZmZmZm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZmZdZddd ZdddZddZddZgdZdS)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_GUIDANCETASK_COMPLETION_GUIDANCETOOL_USE_ENFORCEMENT_GUIDANCETOOL_USE_ENFORCEMENT_MODELScddl}|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 2/usr/local/lib/hermes-agent/agent/system_prompt.py_rar.s agentrsystem_message Optional[str]returnDict[str, str]cj"#t"g}d}jsjs-"}|r||d}|s|t |t tddr!jr|tg}djvr|tdjvr|tdjvr|ttdd}|r||n%|#d jvr|t|r(|d |d jvrd d lm}||"j}|r||jrsj} d} | dus+t'| t(r| dvrd} n| dus+t'| t(r| dvrd} nt'| t,r7jpd#t1#fd| D} n;jpd#t1#fdt2D} | r}|t4jpd} d| vsd| vr|t6d| vsd| vsd| vr|t8t1fddD} | r:d"fdjDD} "j| }nd}|r||jdkrQdjvr jddnj}|d |d!jd"" }|r||td#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'}|tPvr!|tP|nR|rP d d+l)m*}|+|}|r!|j,r||j,n#tF$rYnwxYwg}|||jsDt[j.d,pd}"/||-}|r||g}j0rpj1r1j02d}|r||j3r1j02d.}|r||j4rB j45}|r||n#tF$rYnwxYwd d/l6m7}|} d0| 8d1}!j9rj:r |!d2j:z }!jr |!d3jz }!jr |!d4jz }!||!d5d6|Dd5d7|Dd5d8|Dd9S):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 dSr3r7s rr;z,build_system_prompt_parts..s(PPq!{*PPPPPPrgeminigemmagptcodexgrokc3*K|] }|jvVdSr3)valid_tool_names)r8namers rr;z,build_system_prompt_parts..s+ttd45#99ttttttr) skills_list skill_viewr#ch|]}||Sr=r=)r8toolsets r z,build_system_prompt_parts..s0        rc3BK|]}|VdSr3)get_toolset_for_tool)r8 tool_name_rs rr;z,build_system_prompt_parts..sB7@'' 22r)available_toolsavailable_toolsetsalibaba/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._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 TERMINAL_CWD)cwd skip_souluser)nowzConversation started: z %A, %B %d, %Yz Session ID: z Model: z Provider:  c3jK|].}|||V/dSr3stripr8r9s rr;z,build_system_prompt_parts..V<UUaQU17799U UUUUUUrc3jK|].}|||V/dSr3r`rbs rr;z,build_system_prompt_parts..Wrcrc3jK|].}|||V/dSr3r`rbs rr;z,build_system_prompt_parts..Xrcr)stablecontextvolatile);rload_soul_identityskip_context_files load_soul_mdappendrr getattrrDrr rrr joinagent.prompt_builderr(build_nous_subscription_prompt_tool_use_enforcementr4r5r6listmodelanyrrr r build_skills_system_promptprovidersplitbuild_environment_hintstools.env_proberU Exceptionagent.file_safetyrVplatformrargateway.platform_registryrXget platform_hintosgetenvbuild_context_files_prompt _memory_store_memory_enabledformat_for_system_prompt_user_profile_enabled_memory_managerbuild_system_prompt hermes_timer]strftimepass_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 skills_prompt _model_short _env_hintsrU _probe_linerVactive_profile platform_keyrX_entry context_parts _context_cwdcontext_files_promptvolatile_parts mem_block user_block_ext_mem_block _hermes_nowr]timestamp_linerNr:s$` @@rbuild_system_prompt_partsr=s * B!L L  u'? ))     . . .L 423332333u14886U=S64555M5)))_---51114555///_--- u&?FF.-....  !mu7M&M&M_---5CHH]33444///>>>>>>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   55!2-6   +M*** ~""58EK5G5Gu{((--b11U[  :, : :%*[ : : :   ++--J(J'''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 y008D !<<  = 6 6  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  sH5'R R*)R*.R?? S S#>V"" V/.V/0[ [[r5ct||}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. )rr^c3K|]}||V dSr3r=rbs rr;z&build_system_prompt..ls(^^Q\]^q^^^^^^rrfrgrh)rrn)rrpartss rrr\sL &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_promptros< #'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[]functionrE descriptionr1 parametersN)rErrrequiredF) ensure_ascii)toolsr~rljsondumps)rformatted_toolstoolfuncformatted_tools rformat_tools_for_system_messagerzs ;tO //JL88M266((<44    ~.... :oE : : ::r)rrrrr3)rrrrrr)rrrrrr5)rrrr)rrrr5)__doc__ __future__rrrtypingrrrrrorr r r r r rrrrrrrrrrr__all__r=rrrsn.#""""" ,,,,,,,,,,,,                               \\\\\~_____&----;;;;0   r