+ Wj$Rt^RIHt^RIHtHtHtHtHt^t ^dt RRlt RRlt RRlt R R ltR R ltR RltR#)uBoundary-aware partial compression — "summarize up to here". * **Role alternation.** The compressed head ends with summary/handoff content (assistant- or user- role, possibly a trailing todo snapshot). The verbatim tail must begin with a ``user`` message so the rejoined history keeps the user↔assistant alternation that providers validate. * **No silent context mutation.** Manual, user-invoked; rotates the session exactly like ``/compress`` (via the caller), so the prompt-cache reset is explicit and expected. ) annotations)AnyDictListOptionalTuplec V^8dQhRRRR/#)raw_argsstrreturnztuple[bool, int, Optional[str]])formats"OC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\partial_compress.py __annotate__rs22#22Q2cT;'gRP4pV'g R\R3#VP4pVPR4'dV\ R4RpV\ R4RpVP 4pV'd V^,MRpVR8Xd.\ V4^8d\ V^,4M\pRVR3#VR 9d&\ V4^8dR\ V^,4R3#VPR4'd&R\ VP R ^4^,4R3#R\T;'gR3#) aParse the argument string after ``/compress`` into ``(partial, keep_last, focus_topic)``. ``here [N]`` / ``up to here [N]`` / ``--keep N`` / ``-k N`` / ``--keep=N`` select the boundary-aware form; anything else is a focus topic for full ``/compress ``. FNz up to herezup to hereTz--keep==)z--keepz-k)stripDEFAULT_KEEP_LASTlower startswithlensplit _coerce_keep)r textloweredtokensheadkeeps& rparse_partial_compress_argsr"s NN ! ! #D '--jjlG,''#h-/*CMO$ ]]_F6!9BD v~*-f+*:|F1I&@QT4 CK1$4\&),d22 y!!\$**S!"4Q"78$>> #T\\T 11rc V^8dQhRRRR/#)r r r r ztuple[str, bool, bool]r )rs"rrr2s//S/-C/rcRpRp.pT;'gRP4F:pVP4pVR9dRpKVR8XdRpK)VPV4K< RPV4W3#)ajStrip ``--preview``/``--dry-run``/``--aggressive`` (anywhere in the string) and return ``(remaining_args, preview, aggressive_requested)``. ``preview`` means report what WOULD be compressed and change nothing. No surface implements an LLM-free hard-truncate path, so callers surface "not supported" for ``--aggressive`` instead of treating it as a focus topic. FrTz --aggressive )z --previewz --dry-runz--dryrun)rrappendjoin)r preview aggressivekepttoklows& rextract_compress_flagsr-2ssGJDB%%'iik 8 8G N "J KK ( 88D>7 ..rc 0V^8dQhRRRRRRRRR RR R /#) r historylist[dict[str, Any]]partialbool keep_lastint focus_topicz Optional[str] approx_tokensr zdict[str, Any]r )rs"rrrHsD** !* ** *  *  *rc \V4p\V4.rvRpV'd\W4wrg\V4pRR\V4 RV RVR R2.p V'd#V P RV R \V4 R 24MV'dV P R 4V'dV P R V R 24V P R4R\V4R\V4RVRVRV /#)uBuild the ``/compress --preview`` report — pure, no side effects. Shared by the CLI and the gateway slash handler so both report the numbers the real run would use. Returns ``head_count``/``tail_count``/``total``/``partial``/``lines`` (ready to print). FuPreview — no changes made.zWould compress z of z message(s) (~,z tokens currently in context).zBoundary: keeping the last z exchange(s) (z message(s)) verbatim.uRBoundary: 'here' split would keep everything — falling back to full compression.zFocus topic: ""z1Run the command again without --preview to apply. head_count tail_counttotalr1lines)rlist"split_history_for_partial_compressr2r&) r/r1r3r5r6r<r taileffective_partialr=s &&&&& rsummarize_compress_previewrBHs LEg$7K  J ' #d)D0 1 ; = E  ))5D {0 2   ij ~k]!45 LLDE c$ic$i$  rc V^8dQhRRRR/#)r valuer r r4r )rs"rrrus))))rc\V4p\ ^\ T\ 44# \\3d \u#i;i)z9Parse a keep-count token, clamping to [1, MAX_KEEP_LAST].)r4 TypeError ValueErrorrmaxmin MAX_KEEP_LAST)rDns& rrrusB! J q#a' (( z "!  !s 'AAc$V^8dQhRRRRRR/#)r r/r0r3r4r z1tuple[list[dict[str, Any]], list[dict[str, Any]]]r )rs"rrr~s&22 !2272rc \V^4pV'g..3#Rp^p\\V4^, RR4F4pW,PR4R8XgK!TpV^, pW18gK4M V'g\ V4.3#VRVWR3#)aSplit ``history`` into ``(head, tail)``: head is summarized, tail is the last ``keep_last`` exchanges kept verbatim. Exchanges are counted by ``user`` messages so the tail always starts on a user turn and ``compressed_head + tail`` keeps alternation valid. Returns ``(history, [])`` when the head would be empty (or there are no user turns), signaling the caller to fall back to full compression rather than rotating the session for a no-op. Nroleuser)rHrangergetr>)r/r3boundaryseenidxs&& rr?r?~sIq!I 2v H DS\A%r2. <  F #v -H AID  / G}b  9H wy1 11rc$V^8dQhRRRRRR/#)r compressed_headr0r@r r )rs"rrrs&) rc"V'g \V4#V'g \V4#\V4p\V4pVR,V^,rTVPR4VPR4rvWg8XdVR 9dVPR4pVPR4p \V\4'd8\V \4'd"/VCRV RV 2/CVR&VR,pW#,#TP RVR8XdRMRRR/4W#,#) u)Concatenate a compressed head with the verbatim tail, defending the seam's role alternation. The head compressor's output shape isn't contractually guaranteed (a plugin engine could end on a user turn). If the last head message and first tail message share a user/assistant role, the tail's first string content is folded onto the head's last message; non-string (multimodal) content gets a minimal bridging turn instead so nothing is lost. ``tool`` messages are left alone — consecutive tool entries are the one legal repetition (parallel results). rNrO assistantcontentz :NNrrP)rOrY)r>rR isinstancer r&) rWr@r restlastfirst last_role first_role last_content first_contents && rrejoin_compressed_head_and_tailrds O$$ Dz  D :Dr(DG% HHV,eii.?z90E#Exx *  ), lC ( (Z s-K-KP$P l^4 +OPDH8D ; KK f0D&R[]_` a ;rN)__doc__ __future__rtypingrrrrrrrJr"r-rBrr?rdr rrrhsC#33 2:/,*Z)2>r