epja|*dZddlmZddlZddlZddlZddlmZmZm Z m Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZddlmZddlmZddl m!Z!ej"e#Z$d Z%d!dZ&dZ'd"dZ(d#d$dZ)d#d%dZ*d&dZ+ d#ddd'dZ,d(dZ-gd Z.dS))uSystem-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, alibaba model-name workaround, environment hints, coding guidance, platform hints. * ``context`` — caller-supplied ``system_message`` plus context files (AGENTS.md / .cursorrules / etc.) discovered under ``TERMINAL_CWD``, plus the session's coding-workspace snapshot. * ``volatile`` — skills index, 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 9/home/thesage/.hermes/hermes-agent/agent/system_prompt.py_rar:s 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_hintr6Isx( 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]c:01t0d}tdd}|.t|dd}t|tr|dkr|}g}d}jsjs.0|}|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} || 0j } | r|| j rsj} d} | dus+t| t.r| dvrd} n| dus+t| t.r| dvrd} nt| t2r7jpd1t71fd| D} n;jpd1t71fdt8D} | r}|t:jpd}d|vsd|vr|t<d|vsd|vsd|vr|t>t7fddD}|rd0fdj DD}tA} ddl!m"}|j#tI }n#tJ$rtA}YnwxYw0&j ||pd!}nd}j'd"krQd#jvr j(d#d$nj}|d%|d&jd'0)}|r||g}g}j rU dd(l!m*}|j#tIj)\}}}|+|n#tJ$rYnwxYw|rg}n|+||}td*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}'|r?|'+||'+||'+|||'|jsC0=tI||j#d?v@}(|(r|'|(g})|r|)|j>rpj?r1j>@d }*|*r|)|*jAr1j>@dA}+|+r|)|+jBrB jBC},|,r|)|,n#tJ$rYnwxYwddBlDmE}-|-}.dC|.FdD}/jGrjHr |/dEjHz }/jr |/dFjz }/j'r |/dGj'z }/j#r |/dHj#z }/|)|/dIdJ|DdIdK|'DdIdL|)DdMS)Nu2Assemble the system prompt as three ordered cache tiers. Returns a dict with three keys: * ``stable`` — the cross-session-stable prefix, through the coding operating brief when a workspace snapshot follows. * ``context`` — the workspace snapshot followed by the remaining session-stable guidance, context files, and caller-supplied system_message. * ``volatile`` — skills index, 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_prompt_parts)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: z Platform: 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)2r!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_hintscoding_workspace_partscoding_trailing_partsr{coding_prefix_partspost_workspace_partsr~ _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]s2` @@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    ~""58EK5G5Gu{((--b11U[  :, : :%*[ : : :   ++--J(J''')+')    G G G G G GQkQk'))kRRR N !79N    3 4 4 4 4    D ,*,1222+u*D11  B B B B B B4466K 9$++K888    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 ~:9999.)))KKUU<UUUUUKKUU=UUUUUKKUU>UUUUU  s$Q99RR AV VV'W66 XXX X'&X'+] ] ]B_ _-,_-+0f f)(f)ct||}dd|d|d|dfD}|d|_tD]}|||S)a<Assemble 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 (skills index, memory, USER profile, timestamp). For explicit cache_control backends the whole string is one cached block. For implicit longest-prefix backends the order is what matters: the content most likely to change is rendered last, so when the prompt is rebuilt (on compaction/restore) the unchanged stable scaffold ahead of the change stays in the reused prefix. r>r(c3K|]}||V dSrXr`rs rr^z&build_system_prompt..Cs(``q^_```````r rrr)rr_cached_system_prompt_staticr _emit_status)r!r>partsjoinedwarnings rrr1s" &eN K K KE [[``U8_eI6FjHY$Z``` ` `F).xE&-..$$ 7#### Mr Nonecfd|_d|_|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_promptrrload_from_disk)r!s rinvalidate_system_promptrNsD #'E)-E& - **,,,,,--r restore) log_labelrc"t|ddsdSt|dd}t|tr|sdSt|dd}t|tr|r||rdSt|dd|krdS t ||d}|r%||r||_d|_dSn-#t$r t d |d YnwxYwd|_||_dS) uReconstruct ``_cached_system_prompt_static`` for a stored prompt. The static prefix is not persisted (only the full prompt is), so any path that adopts a stored/kept ``_cached_system_prompt`` — session restore, the compression keep-prompt path, or a failover to a cache-on provider mid-turn (#72626) — must rebuild the stable tier to regain the two-block ``[static, volatile]`` system layout. Safety: the rebuilt stable tier is used ONLY when the stored prompt literally starts with it (checked here AND re-checked by ``_apply_system_cache_markers``'s ``startswith`` gate). If any stable-tier input changed since the prompt was persisted (identity changed, SOUL.md edited), the prefix mismatches, the static stays None, and requests fall back to the legacy layout with the stored prompt bytes untouched — never a rewritten prompt. A failed reconstruction is memoized per stored prompt (``_static_rebuild_failed_for``): ``build_system_prompt_parts`` does real file I/O (SOUL.md, context files, memory), and callers on the retry-loop hot path must not re-run it every attempt when the inputs haven't changed. A legitimately changed stored prompt retries once. _use_prompt_cachingFNrr_static_rebuild_failed_forrrz0static system-prefix reconstruction failed on %sT)exc_info) r+r,r# startswithrrrrloggerdebug)r!r>rstoredexistingstatics rreconstruct_static_prefixrZsa8 5/ 7 7 U3T : :F fc " "&u        *.E&'-E$$$s=C>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_messagers ;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?rr#r%r)r!rr%r#)/__doc__ __future__rrloggingr;typingrrrrrrr r r r r rrrrrrrrrragent.runtime_cwdrhermes_constantsrutilsr getLogger__name__rrr6r:r=rrrrr__all__r`r rrsE2#"""""  ,,,,,,,,,,,,$211111,,,,,,!!!!!!  8 $ $   ....d2////.VVVVVr : - - - -%)3. 3.3.3.3.3.3.l;;;;0   r