+ lHjƬ#Rt^RIt^RIt^RIt^RIt^RIHtHtHt^RIH t H t H t H t H t ^RIHt^RIHtRtRtRtRt^t]P.!R]P04tR R R R R R/tRtRt]tRR/RRlltRtRRlt RRlt!RRlt"RRlt#RRlt$RR lt%R!R"lt&R#R$lt'R%R&lt(R'R(lt)R)R*lt*R+R,lt+R-R.lt,R/R0lt-R1R2lt.R3R4lt/R5R6lt0RR7R8llt1RR9R:llt2R;R<lt3R=R>lt4R?R@lt5RARBlt6RCRDlt7RRERFllt8RGRHlt9RRIRJllt:RKRLlt;RRMRNlltRRSRTllt?RRURVllt@RRXRYlltARZR[ltBR\R]R^R_R`RaRbRcRdRaReR^Rf/RgRaRhR^RiRj^/RkRaReRlRmRn.R^Ro/RpRaReRlRWRq.R^RrRjRW/RsRaReR^Rt/RuRaReR^Rv/RwRaRxRyRaRe/R^Rz/RRaReR^R{/R|RaRhR^R}/R~RaRhR^RRj^/RRaReR^R/RRaReR^R// R.//tC^RIDHEtEHFtF]EP!R]R]]CR]BRR7R#)uSession Search Tool - long-term conversation recall over the SQLite session DB. Single-shape tool; the mode is inferred from the args: DISCOVERY (``query``; FTS5 deduped by lineage, adaptive detail hydrates only the top result), SCROLL (``session_id`` + ``around_message_id``; ±window around the anchor), READ (``session_id`` alone; whole session or head/tail), BROWSE (no args). No LLM calls — every shape returns actual DB messages. N)datetimetimezoneUTC)AnyDictListOptionalUnion)_BOUNDARY_END_REASONS) safe_strftimeii,z^(\d+)\s*(h|d|w)$hidiQwi: session_idwith_excFc$V^8dQhR\/#)rbool)formats">/home/ubuntu/.hermes/hermes-agent/tools/session_search_tool.py __annotate__r;s$cV!4# \d8p\P!T.T'd YE3,MTO5RR/TuRp?#Rp?ii;i)zS``fn()``, or *default* after debug-logging *msg* (+ the exception when *with_exc*).exc_infoTN) Exceptionloggingdebug)fndefaultmsgrlog_argses&&&$* r_quietr#;sBt  cWX_hWRVWs A ,AA A cV!4R3# \d;p\P!T.TOTN5RR/R\T RT 2RR73uRp?#Rp?ii;i)u|``(fn(), None)``, or ``(None, tool_error_json)`` after an error-level log — for DB calls whose failure the model must see.NrTz: Fsuccess)rrerror tool_error)rlog_msg error_prefixr!r"s&&&* r_loudr+Ds^GtTz G g;;!;d;Z<.1# 6FFFGs A/A A AcTV^8dQhR\\,R,R\/#)rtsNreturn)floatstr)rs"rrrNs'JJ%#+,JJrcaSfR#\S\4'd9SPRR4PRR4P4'gS#\ V3Rl\S4RSRR7#) zNUnix timestamp -> readable date; ISO strings pass through; "unknown" for None.unknown.-cV<\\P!\S44R4#)z%B %d, %Y at %I:%M %p)r r fromtimestampr/r-sr#_format_timestamp..Ts-(>(>uRy(IKbcrz!Failed to format timestamp %s: %sTr) isinstancer0replaceisdigitr#r8sfr_format_timestampr?Nse z"c2::c2#6#>#>sB#G#O#O#Q#Q cehikel5rD JJrc0V^8dQhR\R\/#rrr.)r0dict)rs"rrrXsTTcTdTrcDaa\VV3RlRRSRR7;'g/#)z4``db.get_session`` that degrades to ``{}`` on error.c&<SPS4#N get_sessiondbrsrr9#_get_session_meta..Zs"..4rNzget_session failed for %s: %sTr;)r#rHsffr_get_session_metarKXs- 4d1: N T TQSTrctV^8dQhR\\\3,R\\\3,/#)rmetar.)rBr0r)rs"rrr^s.DDd38nDc3hDrc R\VPR44RVPR4RVPR4RVPR4/#)when started_atsourcemodeltitle)r?get)rMs&r_session_meta_blockrU^sK %dhh|&<=xRZI[ TXXg&'1B DDrc$V^8dQhR\/#rr.r0)rs"rrrcsHHcHrc :\P!RR/VCRR7#)r&TF) ensure_ascii)jsondumps)payloads,r_okr^cs ::y$2'2 GGrc0V^8dQhR\R\/#)rcontentr.r0r)rs"rrrgsOOCODOrcn\V4;'d$VP4P\4#rE)rlstrip startswith_COMPACTION_PREFIXES)r`s&r_is_compaction_summaryrfgs' = N NW^^-889MNNrcRV^8dQhR\R\\\3,/#rA)r0tupler)rs"rrrks#   s  uS$Y/?  rc\4pTRrCV'dgW29daVPV4\W4pT;'gVPR4R8HpVPR4'gW43#VR,pKnW43#)zWalk parent_session_id to the root -> ``(root_id, has_compression_hop)``; the flag separates a compression-split lineage (parent summarised away) from a delegation lineage (child still visible to the parent).F end_reason compressionparent_session_id)setaddrKrT)rIrvisitedcurhas_compressionss&& r_resolve_to_parentrsks}G%u #$ C b &)QQQUU<-@M-Quu())   #$  rc0V^8dQhR\R\/#rArX)rs"rrr{s11S1S1rc&\W4^,#))rsrHs&&r_resolve_lineagerw{s b -a 00rc\V^8dQhR\\,R\\,/#rvaluer.)rr0int)rs"rrrs"##HSM#hsm#rcNVfR#\V4P4pV'gR#\PV4;p'dm\ \ P !44\ VP ^44\VP ^4P4,,, #\P!V4pTPfTP\R7p\ TP44# \d\RT: R24Rhi;i)aParse an ISO date/datetime OR a relative duration into a UTC unix timestamp. ISO: a date-only value (``YYYY-MM-DD``) is midnight UTC on that day (the SQL ``before`` predicate is exclusive, so ``before=2026-07-01`` keeps June and drops July 1 00:00). Relative: ``"7d"``, ``"24h"``, ``"2w"`` = now minus N hours/days/weeks, so ``after="7d"`` is the last week and ``before="7d"`` is everything older than a week. Nzinvalid time bound: zV (expected ISO date/datetime like 2026-07-01, or a relative duration like 7d, 24h, 2w))tzinfo)r0strip_RELATIVE_BOUND_REmatchr{timegroup_RELATIVE_UNIT_SECONDSlowerr fromisoformat ValueErrorr}r=r timestamp)rztextrelparseds& r_parse_iso_boundrs } u:   D  &&t,,s,499;#ciil"36LSYYWX\M_M_Ma6b"bbb[''-}}s+ v! "" [/y9PPQVZ [[s 4DD$cFV^8dQhR\R\\,/#ry)rrr{)rs"rrrschsmrc\VeVR8Xg\V\4'dR#\V\\34'd \V4#\ V4P 4p\\V44# \ \3dMi;i\T4# \dR#i;i)zY``sessions.started_at`` as an int unix timestamp (numeric or ISO text); None if unusable.Nr4) r<rr{r/r0r~ TypeErrorrr)rzrs& r_coerce_started_tsrs } z%'>'>%#u&&5z u:   D 5; z "   %% s$%A99B  B  B B+*B+cV^8dQhR\\,R\\,R\\,R\/#)r started_tsafter_ts before_tsr.)rr{r)rs"rrrs>jj j#jS[\_S`jeijrcrVfVfR#VfR#VRJ;'g W8;'dVRJ;'gW8#)zI``after_ts <= started_ts < before_ts``; an unknown start fails any bound.NTF)rrrs&&&r_in_time_windowrsHI-   6 6 6 i iY$=N=h=hR\RhircFV^8dQhR\R\\,/#)rrawr.)rlistr0)rs"rrrs   S rc\\V\4'dV.M(\V\\34'd \V4M.p.pVFap\V\4'dVP 4MRpV'dWB9dVP V4\ V4\8gK`V# V#)zYDeduped, stripped session ids from a str or list, capped at ``_EXCLUDE_SESSION_IDS_CAP``.r4)r<r0rrhr~appendlen_EXCLUDE_SESSION_IDS_CAP)ritemsoutitemsids& r_normalize_exclude_session_idsrsS))SEJsTSXM JJsO s8/ /  J  Jrc\V^8dQhR\\,R\\,/#)rexclude_session_idsr.)rr0rm)rs"rrrs"T#Y3s8rc\4pVF8pVPV4TP\W4;'gT4K: V#)zUThe excluded ids plus their lineage roots, so a child id also hides its parent chain.)rmrnrw)rIrrootsrs&& r_excluded_lineage_rootsrs?eE" # "2+22s3# Lrc<V^8dQhR\R\R\/#)rabr.ra)rs"rrrs!>>>>>rcZ\W4p\T;'dV\W48H4#rE)rwr)rIrra_roots&&& r _same_lineagers* b $F <<6%5b%<< ==rc0V^8dQhR\R\/#rAra)rs"rrrsQQsQtQrcT;'d#\W4PR4;'gRpVR8H;'g V\9#)a2True when the transcript left everyone's live context: ``compression`` (summarised into the child) or a fresh reset (child starts empty). Live delegation children (``end_reason is None``) and ``branched`` parents (copied verbatim into the branch) ARE the current context, so they stay excluded from recall.rjNrk)rKrT_FRESH_RESET_END_REASONS)rIrrjs&& r_session_left_live_contextrsD TT!22!B!F!F|!T]]Y]J  & P P*8P*PPrc\V^8dQhR\\\\3,,/#rW)rrBr0r)rs"rrrs &&(4S>2J&rcnaaVV3RlpS;'d\VRRS4pV'd \V4#R#)zMOwning session and visibility flags for *message_id* (None if missing/error).c<SP;_uu_4SPPRS34P4uuRRR4# +'giR#;i)z?SELECT session_id, active, compacted FROM messages WHERE id = ?N)_lock_connexecutefetchonerI message_idsr_lookup+_get_message_storage_state.._lookups= XXX88##QT^S`bbjbjblXXXs +A  A Nz*message storage-state lookup failed for %s)r#rB)rIrrrowsff r_get_message_storage_staters6m  h h/[]ghC49%%rchV^8dQhR\\\\3,,R\/#)rstater.)rrBr0rr)rs"rrrs+RRxS#X7RDRrcZVRJ;'d!VR,^8H;'d VR,^8H#)zwCompaction archives are ``active=0, compacted=1``; rewind/undo rows are ``active=0, compacted=0`` and must stay hidden.Nactive compactedr)rs&r_is_compacted_staters3   Q QxA!5 Q Q% :LPQ:QQrc$V^8dQhR\/#rWr)rs"rrrsKKTKrc*\\W44#)zTrue for a compaction-archived row: no longer in live context, so discoverable even on the current session. False on any error.)rrrs&&r_is_compacted_messagers 9"I JJrc V^8dQhR\\\3,R\\,R\\,R\\\3,/#)rm anchor_idmax_content_lenr.)rBr0rrr{)rs"rrrsHOOd38nO#O$,SMO=A#s(^Orc VPR4p\V\4'dRV9d^RIHpV!V4pRVPR4RVPR4RVRVPR4/pTP R Uu/uF,q`PV4'gKW`PV4bK. up4VeVPR4V8XdRVR &V'd@V'd8\ V4V8d(VP VRVR ,R\ V4R 7VP4UUu/uFwrgVf VR8XgKWgbK upp#uupiuuppi) zMSlim a message row; keeps ``content`` even when empty (tool-call-only turns).r`) strip_ansiidrolerNTanchoru…)r`content_truncatedoriginal_content_chars) tool_name tool_calls tool_call_id)rTr<r0tools.ansi_striprupdaterr)rrrr`rentrykvs&&& r_shape_messagers+eeIG'3Fg$5/W% 155;f y';XYX]X]^iXj kE LL'R_'R!V[V[\]V^+!UU1X+'R_`t !9h7s7|o'E W%5o6>RV,/L  :"[[] N]TQamqI~DAD] NN ` OsE E5E EcJV^8dQhR\R\R,R\/#)rrprofileNr.rX)rs"rrrs* Q Qc QC$J Q# QrcRpT;'gRP4;'g\VRR4pV'd RV RV 2#RV 2#)uThe reference the agent writes for a session — same value the desktop composer emits, so it renders as a titled link. The profile segment is omitted when it can't be named confidently (a bare id still resolves, just not across profiles).c2^RIHpV!4pVR8XdR#T#)rv)get_active_profile_namecustomr4)hermes_cli.profilesr)rresolveds r_active_session_link.._actives?*,)r7x7rr4z/get_active_profile_name failed for session linkz @session:/)r~r#)rrrnames&& r _session_linkrsP8 MMr " l lfWb:k&lD.2YtfAj\ *P)J<8PPrchV^8dQhR\\,R\\\3,/#)r lineage_rootr.)rr0rBr)rs"rrr s&8C=tCH~rc pRUu/uF q"W,bK ppV'dWR,8wdWR&V#uupi)zMCanonical key order; ``parent_session_id`` set when the hit lives in a child.rrlrrOrQrRrS matched_rolematch_message_idsnippet bookend_startmessages bookend_endmessages_beforemessages_afterdetailr)rfieldsrrs&, r_discovery_entryr sN$c d$ca \$cE d l(;;%1!" L  ds3c V^8dQhR\R\\,R\\\\3,,/#)rquerycurrent_lineage_rootr.)r0rrBr)rs"rrrs8#'#'3#'hsm#'PXY]^acf^fYgPh#'rcaaaa a a VP4PR4o S ;'d\VV 3RlRRS 4o S 'gR#\SS 4oV'dSV8Xd\SS 4'gR#\VVV 3RlRRS 4;'g/pVP R4\ 9dR#\VV 3Rl.R S 4pV'dV^,P R 4MRoSf/M\VVV 3R l/R S S4o VP R 4;'gS pR V 3Rllp/\ SS \VP R44VP RR4VP R4;'gRVRSRV 2V!RVR,4V!RVR,SRR7V!RVR!R4S P R^4S P R\\V4^, ^44RR7CRS/C#)"zJDiscovery-shaped result when the query matches a session title, else None.z`'"c&<SPS4#rE)resolve_session_by_title)rI title_querysrr9%_title_match_result..s0K0KK0XrNz&resolve_session_by_title failed for %rcX<SPS4;'gSPS4#rErF)rIrrsrr9r s#"..">"\"\"..Q[B\"\rz%get_session failed for title match %srQc&<SPS4#rE get_messagesrHsrr9r$booj9rz&get_messages failed for title match %src.<SPSS^^R7#)windowbookend)get_anchored_view)rrIrsrr9r's$$Z1a$Prz.get_anchored_view failed for title match %s/%srSc z<SPV4;'gTUu.uFp\WBVR7NK up#uupi)rr)rTr)keyfallbackrrrviews&&&& rshape"_title_match_result..shape+sB((3-338363AqOT36 66s8rPr2rR session_titlezSession title matched: r:NNr :NrNrrrrfullr _lineage_root)N) r~r#rwrrT_HIDDEN_SESSION_SOURCESrr?maxr) rIrr session_metarrSrrrrrrs f&& @@@@@r_title_match_resultrs++-%%f-K__(XZ^(PR]"_J #B 3L 0D DMghjlvMwMw\^bA:OUURT!%<<92?gistH)1 %tI"2PRT8*i)QD   W % 4 4E6 '2CLDTDTUaDb2c)4LAAT#s(^0DArc VPV4;'g.Uu.uF3p\VPRR44'dK&\VRR7NK5 up#uupi)r`r4rr)rTrfr)rrrs&& r_bookendr2EsZ>Bhhsm>Q>Qr>Q A>Q)!%% 2*>? 4N1d 3>Q AA As #AAc V^8dQhR\R\\\3,R\R\\\\3,,/#)rr match_info result_detailr.)r0rBrr)rs"rrrJsD3DcNSV[cdhilnqiqdr[srcVPR4;'gTVPR4rTVPWE^^R7p\ Y4TR8Hr\ Y\TPR 4;'gTPR 44TPR 4;'gTPR R 4TPR 4;'gTPR 4;'gR TPR4;'gRTPR4YRPR4;'gRT 'd \TR4M.TPR4;'g.U u.uF/q'gT PR4T8XgK"\YRR7NK1 up T 'd \TR4M.TPR^4TPR^4TR7# \d&p\P!RYETRR7Rp?R#Rp?ii;iuup i)zQDiscovery result from a surviving FTS row; None (dropped) if the view can't load.rrrz&get_anchored_view failed for %s/%s: %sTrNrrPsession_startedrQr2rRrSrrr4rr rr rrrr) rTr rrwarningrKrr?r2r) rIrr4r5hit_sidmsg_idrr"rrrs &&&& r _hydrate_hitr<Js nn\2BBlJNNSWDXV##GAq#I+2U$  |// =bbPaAb c)PPZ^^Hi-Pw'OO:>>'+BOOiw'//4jnnV>T )B)H)Hb9=ht_52 HHX.44"4X4atPVAVL.dK4X59HT=1r!2A6txxP`bcGd   @'ST_cdXs#GH?H HG;;HcRV^8dQhR\R\\\,,R\R\\,R\R\R,R\R,R \\,R \\,R \\\,,R \/ #) rr role_filterlimitsortrcurrent_session_idN link_profilerrrr.)r0rrr{)rs"rrrbsMPMPMP8DI+>MPsMPRZ[^R_MPMP/2TzMPPSVZPZMP  MP9A#MP$,DI#6MPCFMPrc paaaaaa V'd \SV4MRp \ST ;'g.4p \SSV 4p V 'dV R,V PR4;'g V R,r\ \ SV4;'g \ SV4PR44pW0V ,'g\ VSS 4'gRp \VV VVVV3RlRR4wppV'dV#\VRR 7pV'gV 'g\SSV.R R 7#/pV 'dV .M.pV 'd"V PRR4;p'dR R /VV&VFp\V4V8dMVR,\SVR,4ppVV 9gVV 9dKA\SVPR44pV 'd$VV 8Xd\SV4'g V'gKV'dVV8Xd V'gKVPV/VCRV/C4K VP4FUwppVPR 4'dK\!STTVR8Xg V'gRMR4pVfKDVP#V4KW VFp\%VR,V4VR&K \SSVV\V4RR7#)z=Discovery shape: FTS5 plus adaptive or full result hydration.NrrrPc z<SPSS;'gRR.\\4\^S\SSR7 #)user assistant) rr>exclude_sourcesr?offsetr@rrr)search_messagesrr_DISCOVER_SCAN_LIMIT_DISCOVER_SEARCH_FIELDS)rrrIrr>r@srr9_discover..qsAR%7%7!E!E0E45=QZ[bf&Y&8&PrzFTS5 search failed: %sz Search failedcFVPR4;'gR\9#)rQr4)rT_DEMOTED_SESSION_SOURCES)rs&rr9rLzsQUU8_5J5JOg4gr)ruNo matching sessions found. FTS5 ANDs all terms by default — broaden with OR (`alpha OR beta`), exact-match with quoted phrases, exclude with NOT, or prefix-match with `deploy*`.)message _title_onlyTrrcompactlinku=When referring the user to a session, write its `link` value verbatim inline mid-sentence (it renders as a titled link) — never as markdown, in backticks, on its own line, or next to the title/id/date. To read more around a compact result, scroll: session_search(session_id=..., around_message_id=match_message_id).)sessions_searched link_hint)rwrrrTrrKrr+sortedr/poprrr setdefaultrr<rr)rIrr>r?r@rrArBrrrrexcluded_roots title_result title_sid title_root title_started raw_resultserr seen_sessionsr  title_lineagerOraw_sid resolved_sidis_compacted_hitrr4rsfff&f&&&ff& r _discoverrebs HZ+B0BC_c,R1D1J1JKN&r52FGL ,\ :L>- ( ( RzVvEU]d6jst   NN5 ! %:%eL&9<Hf  R3}K] N PPrc$V^8dQhR\/#)rrrX)rs"rrrs _ _ _rc4Ve \V4P4'gR#^RIHp^RIHpVP V4pVPV4VPV4'g\RV R24hV!VPV4R, RR7#) zTAnother profile's ``state.db`` opened read-only (safe on a live DB); None = current.N)profiles) SessionDB profile 'z' does not existstate.dbTdb_path read_only) r0r~ hermes_clirh hermes_staterinormalize_profile_namevalidate_profile_nameprofile_existsrget_profile_dir)r profiles_modricanons& r_resolve_profile_dbrwsc'l00223&  / / 8E&&u-  & &u - -9UG+;<== \99%@:MY] ^^rc bV^8dQhR\R\R\R\R,R\/#)rrheadtailrBNr.r0r{)rs"rrrs>vv#vSvSvUX[_U_vknvrcaa\SS4pV'g\RS 2RR7#\VV3RlRRS4wrgV'dV#VUu.uFp\V\R7NK p p\ V 4\ V 4W#,8r\ RRR R SR \SV4R \V4R T RT RV 'dV RVW)R,MT /V 'dRRV RV RV R2/B#/B#uupi)zQRead shape: whole session, or ``head`` + ``tail`` messages with a scroll pointer.session_id not found: Fr%c&<SPS4#rErrHsrr9_read_session..rrzget_messages failed for %s: %szfailed to load sessionrr(readrrSr message_count truncatedrNrPz Session has z messages; showing first z + last z=. Pass around_message_id (any id above) to scroll the middle.r) rKr(r+r_READ_MAX_CONTENTrr^rrU) rIrryrzrBrMrowsr_rshapedr'rs ff&&& r _read_sessionrs: R ,D 2:,?OO9;[]u "ID  LP QDqnQ0ABDF Q6{CK$+$=9  vF vz v jR^8_ v/5 vEJ vV_ v:Cu uv6 vcleW4MdVS[\`[ab] ]_ vvrt  vvRs CcRV^8dQhR\R\\,R\/#)rrrr.)r0r)rs"rrrs* l l# l l# lrc\WVR7p\P!V4PR4RJg V'dV#\ RV R2RR7#)uRead shape scoped to ONE store: the caller's profile, or the profile it named. A miss is a miss. Profiles are isolated islands, so a bare id never falls through to a scan of every other profile's ``state.db`` — that returned another profile's full transcript to any caller holding the id (#106761). The hint tells the model how to ask properly: ``@session:/`` or ``profile=``. rBr&Fz&session_id not found in this profile: z^. If it belongs to another profile, pass profile= (or the @session:/ link).r%)rr[loadsrTr()rIrrresults&&& r _read_scopedrsY2 9F zz&i(5 >seD\\ej llrcdV^8dQhR\R\R,R\R,R\/#)rr?rANrBr.)r{r0)rs"rrrs4ScDj_bei_iuxrcRaaaaVVVV3Rlp\VRR4wrVT;'gT#)zFBrowse shape: metadata for the most recent sessions (no LLM, no FTS5).c <\S RR4pVf \R4hV!S ^,\\4RR7pS 'd \ S S 4MRwr#S V'd V'dTMR0pVUu.uFqUP RR4V9gKVNK upRS UUu.uFpRVP RR4R\ VP RR4S 4R VP R 4;'gR/RUu/uFqwVP VR4bK upCR VP R ^4R VP R R4/CNK ppp\R V\V4R \V4 R2R7#uupiuupiuuppi)list_recent_sessions_boundedNz?session database does not support bounded recent-session browseg@)r?rGtimeout_secondsrr4rrSrSrpreviewbrowsezShowing zZ most recent sessions. Pass a query= to search, or session_id+around_message_id to scroll.)r(r r*rP)NF)rQrP last_active) getattr RuntimeErrorrrrsrTrr^r) bounded_listsessions current_roothas_compression_hophiddenxrrrr rArIr?rBs r_browse&_list_recent_sessions.._browsesr#A4H  `a a"* !893P;M r#5 6R_ * %6Ill`de "*KAUU4_F-JaaKFUS UT !%%b/6=tRR^3_ QUU7^++tYIp/qIpA155B<Ip/qY QUU?A6 155TVCWYT U 'Ws7|n%9 9; ;L0rUs+/E EA E)'E).E$ .E)$E)z!Error listing recent sessions: %szFailed to list recent sessions)r+)rIr?rArBrrr_sffff r_list_recent_sessionsrs-;;6WACcdHC ::#rcHV^8dQhR\R\R\R\/#)rrlohir.)r{)rs"rrrs(##s####rcv\V4p\V\ W44# \\3dTpL*i;irE)r{rrrmin)rzrrrs&&&&r _clamp_intrs>E  r3u> "" z "s "88c<V^8dQhR\R\R\/#)r anchor_sidrAr.ra)rs"rrr s(xx#xSVx[_xrc\WV4'd\V4'dR#VRJ;'dVR,^8H;'g\W4'*#)aCTrue when the scroll anchor is still in the caller's active context (reject). Same-lineage history that LEFT live context (compacted rows, compression-ended parents, /new-reset predecessors) passes, so scroll never rejects a discovery result. Rewind/undo rows (active=0, compacted!=1) never count as out-of-context history.FNr)rrr)rI anchor_staterrAs&&&&r_anchor_in_live_contextr sP ); < <@ST`@a@a  $ D Dh)?1)D w wMghjMwIwwrc bV^8dQhR\R\R\R\R,R\/#)rraround_message_idr rANr.r{)rs"rrrs<+E+EC+EC+E+E #d +E69+Erc$aaaaa \S4o\ S^^^4o\ SS4pT;'g/P R4o T'd,\STS ;'gST4'd\RRR7#\SS4pT'g\RS 2RR7#\TTTT3RlRR 4wrxT'dT#TP R 4;'g.p /p T 'gS 'dS S8wd|\SSS 4;'d\TTT T3R lR R RR7p T 'dIT P R 4'd2RS RS RS R2T R&YR ,S uryo\SS 4;'gTpT 'g\RS RS 2RR7#\R RRRSRSR\T4R SRT U u.uFp \T SR7NK up RTP R^4RTP R^4RR/ T B# \\3d\RRR7u#i;iuup i)!zDScroll shape: a window centered on an anchor (no FTS5, no bookends).z)scroll requires integer around_message_idFr%rz]scroll rejected: anchor lives in the current session lineage (already in your active context)r}c,<SPSSSR7#)r get_messages_around)rrIrr srr9_scroll..#sb44ZAR[a4brzget_messages_around failed: %szfailed to load messagesr c,<SPSSSR7#rr)rrIowningr srr9r-sB**63DV*TrNz%rebind get_messages_around failed: %sTr;zaround_message_id z lives in z (child of z); rebound transparentlyr9z not in session_id r(scrollrrr)rrrhintzScroll forward: re-call with around_message_id = the LAST message's id; backward: the FIRST message's id (the boundary message repeats as an orientation marker). messages_before/messages_after < window means you've hit that end of the session.r)r{rrr(rrrTrrKr+rr#r^rUr)rIrrr rArrrr_rr, rebind_viewrrsffff& @r_scrollrs}V 121b )F-b2CDL  b % %l 3F5b,H\H\R\^pqqyDIJ J$R4L 2:,?OOb68QSID  xx!''RH E 6Z#7$B F;JJ T 9DAJ  ;??844"45F4GzRXQYZ--7L8P!RE) )4(6KV &DJ,R8HHLL ./@.AATU_T`akpqq  E  E", E@Q E(6 E?E EKSS(Q..?@(S E!2A6  EHLxxP`bcGd  E :  E?D EE= z "VEuUUVBTs G)&H )H  H c$V^8dQhR\/#rWrX)rs"rrrAsQQDGQrc\V\4'dPVP4'd:Ve\W5P4WgV4#\ W5P4V 4#\ V^^^ 4pV'd-\V\4'dVP4'g\ W2WIR7#\V\4'dVP4P4MRp\V 4\V 4pp\Y0P4Y.R 9dTMR\T\4'dRTPR4Uu.uF+pTP4'gKTP4NK- up;'gRMR\T \4'd&T P4P4R8XdRMRYITT\T 4R7 # \d!p\\T4RR7uRp?#Rp?ii;iuupi) zHMode dispatch (see module docstring); scroll wins when an anchor is set.NrFr%r&radaptive) rIrr?r@r>rrArBrrr)newestoldest)r<r0r~rrrrrrrr(resplitr)rr>r?rIrArrr r@rrafterbeforer sort_normrrr"rOs&&&&&&&&&&&&&& r _dispatchrAs*c""z'7'7'9'9  (2//13DN`a aB 0 0 2G<< uaB 'E  5#..ekkmm$R0BYY(24(=(= ""$4I1.u57G7O)  [[]%PdCdijnZdepruZvZv):):3)?M)?A1779iaggi)?MUUQU}A#FC00V\\^5I5I5Kv5Uv[e-hbk:;NO  QQ 1#a&%001Ns*,G H&H H"G=7H=Hrc\V^8dQhR\R\R,R\R\R,R\R,R\R,R\R \R,R \R,R \R \R,R \R,R\\\,,R\/#)rrr>Nr?rArrr r@rrrrrr.)r0r{rr)rs"rrrYs1i1i#1it1i31i'*Tz1iFIDj1ilorvlv1i1i*-*1iFIDj1iad1i*1i694Z1i^ffjknfo]p1i}@1ircHaaaa^RIHo^RIHoHp^RIHo.p\V\4'dTRV9dMVPR4wpppV'd0TpV'd&V e \V 4P4'gTp \V 4pTeTRrCTP!T4^R IHp\TT4'dRpTf:\'TT3RlRR4pTf\T!4R R 7#TP!T4\)YY#YEYgYT YT R7\+T4Fo\'TT3RlRR4K # \d7p\P!RT RR7\R T R T 2R R 7uRp?#Rp?ii;i \+T4Fo\'TT3RlRR4K i;i)zRun session search, closing DBs opened here. Positional order is frozen for old callers; new parameters are appended after ``detail``.)get_hermes_home)riformat_session_db_unavailable)release_or_closerNz&session_search: cannot open profile %rTr7rjz': Fr%)RuntimeSessionStorec0<S!S!4R, RR7#)rkTrlr)rirsrr9 session_search..~sIo&7*&DPTUrz(SessionDB unavailable for session_search)rrrc<S!S4#rEr)owned_dbrsrr9rs +H5rz(Failed to close session_search SessionDB)hermes_constantsrrprirhermes_state_registryrr<r0 partitionr~rwrrrr(ragent.runtime_session_storerr#rreversed)rr>r?rIrArrr r@rrrrrr owned_dbs emb_profile_emb_id profile_dbr"rrirrrs&&&&&&&&&&&&&& @@@@rsession_searchrYs 1E6I*c""sj'8!+!5!5c!: Q Js7|7I7I7K7K%F(1 !+T $ @")**  z  U <  :;=uM MiU8J*D6$I\^!+H 5t=g h,5 F >RVWIgYc!5uEEF4!+H 5t=g h,s* D7E;7 E8+E3-E83E8;&F!c$V^8dQhR\/#rWr)rs"rrrs4rcr^RIHpV!4PP4# \dR#i;i)z#Requires the SQLite state database._default_db_pathF)rprparentexists ImportErrorrs r!check_session_search_requirementsrs41!((//11 s $' 66rr descriptionu[Recall past conversations: search or read old Hermes sessions (FTS5), or scroll inside one. Four shapes, picked by args: `query` = discovery (top-N matching sessions, top result fully hydrated); `session_id` + `around_message_id` = scroll (window of messages around an anchor); `session_id` alone = read a whole session — how you resolve an `@session:/` link (split on '/' into profile + id); no args = browse recent sessions. Results are actual DB messages, no LLM. Searches conversation history ONLY — when the user gave a direct source (URL, file, contact, live system), inspect that first; never conclude 'not found' from history alone. Use for questions about past conversations: 'what did we do about X', 'where did we leave Y'. When referring the user to a session, write its `link` value verbatim inline (it renders as a titled link). parameterstypeobject propertiesrstringzSearch query (discovery shape). Keywords, phrases, or boolean expressions to find in past sessions. Omit to browse recent sessions. Ignored when session_id + around_message_id are set (scroll shape).r?integeruDiscovery shape only. Max sessions to return (default 3, max 10). Bump to 5–10 when the topic likely spans several sessions and you want to pick the right one to scroll into.rr@enumrrzDiscovery shape only. Temporal bias on top of FTS5 ranking: omit for relevance-only (exploratory recall), 'newest' for "where did we leave X", 'oldest' for "how did X start".rrzDiscovery shape only. 'adaptive' (default) fully hydrates the top-ranked result and returns only the exact anchor message for lower-ranked results. 'full' returns bookends and the complete anchored window for every result.rzDiscovery shape only. Inclusive lower bound on session start time. ISO date/datetime (e.g. 2026-06-01) or relative duration (7d, 24h, 2w = within the last N). Use only when the user names a time frame. sort is a ranking bias, not a bound.rzDiscovery shape only. Exclusive upper bound on session start time. ISO date/datetime (a date-only value is midnight UTC that day) or relative duration (7d = older than a week). Use only when the user names a time frame.rarrayrzDiscovery shape only. Session ids already inspected this task. Those sessions and their lineage are omitted so a later query explores instead of repeating the same hit. Cap 20.zScroll shape. Session to read inside. Use the session_id returned from a prior discovery call. Must be paired with around_message_id.ruScroll shape. Message id to center the window on — use match_message_id from a discovery result, or any id from a prior window.r zScroll shape only. Messages to return on each side of the anchor (anchor itself always included). Clamped to [1, 20]. Default 5.r>zOptional. Comma-separated roles to include. Discovery defaults to 'user,assistant' (tool output is usually noise). Pass 'user,assistant,tool' to include tool output (debugging tool behaviour) or 'tool' to search tool output only.rzOptional. Read sessions from another Hermes profile's database (read-only). Use when resolving an `@session:/` link: pass the profile segment here with session_id as the id segment. Omit to use the current profile.required)registryr(c F\RRVPR4;'gRRVPR^4RVPR^4RVPRR4RVPR4RVPR4/R Uu/uFq"VPV4bK upB#uupi) rr4r?r rrrIrAr)r>rrr@rrrr)rrT)argskwrs&, rr9r9!s~ Phhw%%2 P-1XXgq-A PJN((S[]^J_ Pxx*- P24&&, PSUSYSYZnSo P$N O$Nadhhqk>$N O P Os?B u🔍)rtoolsetschemahandlercheck_fnemoji)kanbansubagenttool)cron)rrrrrQrRr8)z[CONTEXT COMPACTIONz[CONTEXT SUMMARY]:)NNrE)NNNNN) N)rN)NNN)r4NrNNNNrNNrNNN)H__doc__r[rrerrrrtypingrrrrr hermes_state_commonr hermes_timer rrNrrJrcompile IGNORECASErrrKrerr#r+r?rKrUr^rfrsrwrrrrrrrrrrrrrrr/r2r<rerwrrrrrrrrrSESSION_SEARCH_SCHEMAtools.registryrr(registerrrrrs  ,,335%9%ZZ 4bmmDtS%f=gD1GJT D HO  1#4"j > Q&R K O" Q#'LuA 0MP` _v$ lB#x+E\Q01ih  0 &  A1 8,R  V,8 :  I 8 "&(+J $ )  $"  V1  G 7Gl Z B_p#BJ0    P /  r