+ iHjRt^RIHt^RIt^RIHtHt^RIHt^RI H t H t ]P!R4t RtRt^tR R ltR R ltR RltRRltRRltRRltR#)uSurface switch without a prompt rebuild (#104414). A surface switch (desktop <-> TUI, a session resumed under a different host) changes only which interface renders the reply, but the surface guidance and the ``Platform:`` trailer are embedded in the persisted system prompt. Rebuilding for it diverged the prompt within its first blocks, so the ENTIRE request behind it re-prefilled — a 220K-token session came back at a 1% cache hit. The stored bytes are therefore kept and the CURRENT surface's guidance is delivered on the per-turn user-message channel instead: that lands after the cached prefix and is stamped into the byte-stable ``api_content`` sidecar so later turns replay it unchanged. The prompt itself converges at the next rebuild boundary (compaction). ) annotationsN)AnyList)flatten_message_text)RUNTIME_ENVIRONMENT_ENDRUNTIME_ENVIRONMENT_HEADING run_agentzK[System: This conversation is now being answered on a different interface: u# — any earlier interface guidancec V^8dQhRRRR/#)promptstrreturntuple)formats"9/home/ubuntu/.hermes/hermes-agent/agent/surface_switch.py __annotate__rsqq3q5qcVPR\ R24wrpVP\4'dWV3#VRR3#)z``(identity, runtime_marker, runtime)`` of a persisted prompt. Legacy prose may quote the runtime heading, but only the new renderer ENDS in the boundary; when the marker is empty the whole prompt is identity. ) rpartitionrendswithr)r identityruntime_markerruntimes& rsplit_runtime_boundaryrsN)/(9(9DA\@]]a:b(c%Hg28//BY2Z2ZHg .pagikmo`pprc$V^8dQhRRRRRR/#r r r labelr r)rs"rrr's!  s 3 3 rc\V4wr#pV R2pV'dVPR^4^,MTP4p\V4FnwrxVP R4'gKWg^,V^,F:p V P V4'gKV \ V4RP 4uu# Kp R#)z``Label: value`` from the host lines of a persisted prompt (``Current working directory``); new prompts delimit runtime hints, legacy prompts put them before context. "" when absent.:rzUser home directory:Nr)rsplit splitlines enumerate startswithlenstrip) r r _identityrrprefix host_linesidxline candidates && rruntime_host_valuer.'s*@)G&Iwwa[F1?'--*1-VWWYJz*  ??1 2 2'aq9 ''//$S[\288:::+ rc$V^8dQhRRRRRR/#rr)rs"rrr5s!***C*C*rc0V R2p\V4^,PR^4R,pVP4Uu.uF7qDPV4'gKV\ V4RP 4NK9 ppV'd VR,#R#uupi)aK``Label: value`` from the trailer paragraph that ends the identity portion (the final runtime block is embedder prose, never identity). Memory, context files and plugin prose come earlier and may hold ``Label:`` lines of their own; they are never read as identity, even when the trailer omits the label because its value is empty.r!rNr)rrsplitr#r%r&r')r rr)trailerr,matchess&& ridentity_line_valuer55s wa[F$V,Q/66vqA"EG6=6H6H6Jf6Jdoo^dNe)tCKL!'')6JGf!72;)r)gs B Bc V^8dQhRRRR/#)r conversation_historyrr r r)rs"rrr@s##rc\T;'g.\)R4Fp\V\4'dVP R4R8wdK1VP R4p\V\ 4'dTMRR,\ VP R44,p\V9gKVP\^4^,pVP\^4^,P4u# R#)u_The surface named by the NEWEST switch note in the transcript ("" when none). Once a switch has been announced, that note — not the stored prompt's ``Platform:`` trailer — is the last thing the model was told it runs on. Reading it back is also what keeps a fresh AIAgent per turn (the gateway shape) from stacking one copy of the note per turn.Nroleuser api_contentr content) reversed_NOTE_SCAN_TAIL isinstancedictgetr r_SURFACE_SWITCH_NOTE_PREFIXr2r"_SURFACE_NAME_ENDr')r7msgsidecartexttails& r_last_announced_surfacerI@s -33o5E5FGH#t$$6(A ''-(%gs33tCFZ[^[b[bcl[mFnn &$ .;;:A>qAD::/3A6<<> >I rc$V^8dQhRRRRRR/#)r agentrbuilt_for_this_surfacez list[str]r Noner)rs"rrrSs!3 drc^RIHp\V4pV!V4Uu.uF qDV9gK VNK pp\VRR4;'gRpV'd V'gR#VRRP V4 R2,VnR#uupi)uName, at the end of the staged note, the pinned tools THIS surface did not build. The freeze keeps a previous surface's tools on the wire deliberately — removing them is the one thing that would still re-prefill the request behind the preserved prompt — so the model has to be TOLD they are inert here, or it plans around a ``focus_pane`` a terminal turn can only answer with ``tool_error("desktop only")``.)agent_tool_names_surface_switch_noterNu [System: These tools stay listed for this conversation (dropping them would discard the cached request prefix) but were not loaded for this interface — expect a call to one of them to fail: z, z.])tools.mcp_tool_agentrOsetgetattrjoinrP)rKrLrO surface_namesnameinertnotes&& rnote_inert_pinned_toolsrYSs6./M.u5 S5d]9RTT5E S 50" 5 ; ;D !% $ % 01 5"E Ts A=A=c(V^8dQhRRRRRRRR/#)r rKrr r r7r boolr)rs"rrrgs)%%S%#%S%UY%rc\VRR4R8Xg\VRR4R8XdR#\\VRR4;'gR4P4pV'gR#\VR 4p\ V4;'gTpV'dWS8XdR#^R IHpWC8wd V!V4MRpV'dR MR p\ V \ R V R2p V'dV RV 2MT Vn \PRVPWS4R#)uStage a one-shot correction when the request would otherwise misdescribe the surface. Compares the runtime surface against what the model was last told — the newest switch note if one exists, else ``prompt``'s own ``Platform:`` trailer. Consulting the note matters in both directions: switching BACK to the prompt's surface (desktop -> tui -> desktop) leaves the trailer agreeing with the runtime while a stale note still says otherwise, and a rebuild for an unrelated reason (a model switch) refreshes the prompt but not that note. The full surface guidance is attached only when the prompt itself is out of date; otherwise the note just retires the stale one. Returns whether it staged. MoA and codex_app_server turns never stamp the ``api_content`` sidecar, so the note could not be read back and would be re-sent every turn; those modes keep the stored prompt and skip the note entirely.providerNmoaapi_modecodex_app_serverFplatformrPlatform) platform_hintzthe guidance belowz0the interface section in the system prompt aboveu/ in this conversation is superseded — follow zF for formatting, file delivery and any interface-specific capability.]r<zSession %s switched surface %s -> %s; keeping the stored system prompt and delivering the new surface guidance as a turn note (prefix cache preserved).T) rSr r'r5rIagent.system_promptrcrCrDrPloggerinfo session_id) rKr r7current describedtoldrchintwhererXs &&& rstage_surface_switch_notermgsuj$'50GE:t4TXj4j'%R066B7==?G #FJ7I "#7 8 E EID 4?1#,#7= RD$( .`E & 'y1B0CD!!&(  7;D6D6!2E KK L $ r)__doc__ __future__rloggingtypingrragent.message_contentragent.prompt_builderrr getLoggerrerCrDr?rr.r5rIrYrmrrrrus_ #6U   ; 'k:q *&(%r