߲jdZddlZddlZddlZddlZddlmZmZddlmZm Z m Z m Z m Z ddl mZdZdZdZd Zd Zej(d ej*Zd d ddZdZdZeZdddefdZdZde eee dfde fdZ!de de"fdZ#de e efde e effdZ$de fdZ%de defd Z&de de'e effd!Z(de de fd"Z)d#e e de efd$Z*d#ede efd%Z+d&e ed'e ed(e edefd)Z,d*ede e fd+Z-d,e e de.e fd-Z/d.e d/e defd0Z0de defd1Z1de e e effd2Z2d3e e e efdefd4Z3defd5Z4 dd6e e efd7e ed8e ede e effd9Z5dde d:e de fd;Z6de d?e e de e e effd@Z8d>e dAe dBe9de fdCZ:dDe e efdEe de e e effdFZ;de dJe e e dKedLe e dAe dMe dNe d'e ed(e ed,e e e de fdOZ=d:e fdPZ>dde dQedRedNe de f dSZ?dTe d:e e de fdUZ@ddKedMe dNe de fdVZAdWedXedYedefdZZBd[e dMe defd\ZC dde d^ed_edMe de f d`ZD dde fdaZE dd>e dJe dKedMe de d^ed_edLe d:e dAe dde dee d,e e e de fdfZFdefdgZGdhdidjdkdldmdndodbdpdkdqdrgdsdtdkdcdugdvdcdwdkdxdmdkdydmdzd{dkid|d}dkd~dmdnddmdndd]dpdkddmdkddmd gddZHddlImJZJmKZKeJjdhdheHdeGdy)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)datetimetimezone)AnyDictListOptionalUnion)_BOUNDARY_END_REASONS)kanbansubagenttool)cronii,z^(\d+)\s*(h|d|w)$iiQi: )hdw)id session_idrolesnippetsourcemodelsession_started)z[CONTEXT COMPACTIONz[CONTEXT SUMMARY]:Fwith_excrc |S#t$r-}tj|g|r||fzn|ddi|cYd}~Sd}~wwxYw)zS``fn()``, or *default* after debug-logging *msg* (+ the exception when *with_exc*).exc_infoTN) Exceptionloggingdebug)fndefaultmsgrlog_argses >/home/ubuntu/.hermes/hermes-agent/tools/session_search_tool.py_quietr':sDt  cWX_hWRVWs ?":??c |dfS#t$r9}tj|g||ddidt|d|dfcYd}~Sd}~wwxYw)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)r!log_msg error_prefixr$r%s r&_loudr/Cs^GtTz G g;;!;d;Z<.1# 6FFFGs A .AA A tsreturncyttr2jddjddjsSt fdtddS) zNUnix timestamp -> readable date; ISO strings pass through; "unknown" for None.unknown.-c^tjtjdS)Nz%B %d, %Y at %I:%M %p)r fromtimestampfloatstrftimer0sr&z#_format_timestamp..Ss"(00r;DDE\]z!Failed to format timestamp %s: %sTr) isinstancestrreplaceisdigitr'r;s`r&_format_timestamprBMs_ z"c2::c2#6#>#>sB#G#O#O#Q ]_bce_f5rD JJr=rc6tfddddxsiS)z4``db.get_session`` that degrades to ``{}`` on error.c&jSN get_sessiondbrsr&r<z#_get_session_meta..Ys"..4r=Nzget_session failed for %s: %sTr)r'rHs``r&_get_session_metarJWs' 4d1: N TQSTr=metact|jd|jd|jd|jddS)N started_atrrtitle)whenrrrN)rBget)rKs r&_session_meta_blockrQ]sB%dhh|&<=RZI[XXg&'1B DDr=c 8tjddi|dS)Nr*TF) ensure_ascii)jsondumps)payloads r&_okrWbs ::y$2'2 GGr=contentcbt|xr#|jjtSrE)boollstrip startswith_COMPACTION_PREFIXES)rXs r&_is_compaction_summaryr^fs$ = NW^^-889MNNr=ct}|d}}|r[||vrW|j|t||}|xs|jddk(}|jds ||fS|d}|r||vrW||fS)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)setaddrJrP)rIrvisitedcurhas_compressionss r&_resolve_to_parentrijsG%uC #W$ C b# &)QQUU<-@M-Quu()   #$ #W$  r=c t||dS)Nr)rirHs r&_resolve_lineagerkzs b* -a 00r=valuec<|yt|j}|sytj|x}r_t t j t |j dt|j djzz S tj|jdd}|j |jtj}t |j!S#t$rtd|ddwxYw) 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. NZz+00:00zinvalid time bound: zV (expected ISO date/datetime like 2026-07-01, or a relative duration like 7d, 24h, 2w))tzinfo)r?strip_RELATIVE_BOUND_REmatchinttimegroup_RELATIVE_UNIT_SECONDSlowerr fromisoformatr@ ValueErrorrqrutc timestamp)rltextrelparseds r&_parse_iso_boundr~s } u:   D  &&t,,s,499;#ciil"36LSYYWX\M_M_Ma6b"bbb['' S((CD}}x||4 v! "" [/y9PPQVZ [[s %DDc0||dk(st|tryt|ttfr t|St |j } tt|S#t tf$rYnwxYw t|S#t$rYywxYw)zY``sessions.started_at`` as an int unix timestamp (numeric or ISO text); None if unusable.Nr5) r>rZrur9r?rr TypeErrorr{r)rlr~s r&_coerce_started_tsrs } z%'>%#u&5z u:   D 5; z "   %% s$A((A:9A:> B BB started_tsafter_ts before_tscB||y|y|duxs||k\xr |duxs||kS)zI``after_ts <= started_ts < before_ts``; an unknown start fails any bound.NTF)rrrs r&_in_time_windowrsDI-   6 h 6 iY$=N=hR\_hRhir=rawc t|tr|gn"t|ttfr t|ng}g}|D]P}t|tr|j nd}|r||vr|j |t |tk\sO|S|S)zYDeduped, stripped session ids from a str or list, capped at ``_EXCLUDE_SESSION_IDS_CAP``.r5)r>r?listtuplerrappendlen_EXCLUDE_SESSION_IDS_CAP)ritemsoutitemsids r&_normalize_exclude_session_idsrsS)SEJsTSXM JJsO s8/ /  J  Jr=exclude_session_idsct}|D]2}|j||jt||xs|4|S)zUThe excluded ids plus their lineage roots, so a child id also hides its parent chain.)rcrdrk)rIrrootsrs r&_excluded_lineage_rootsrsCeE"4 # "2s+2s34 Lr=abcRt||}t|xr|t||k(SrE)rkrZ)rIrra_roots r& _same_lineagers+ b! $F <6%5b!%<< ==r=cf|xrt||jdxsd}|dk(xs|tvS)a>True 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.r`Nra)rJrP_FRESH_RESET_END_REASONS)rIrr`s r&_session_left_live_contextrs= T!22z!B!F!F|!T]Y]J  & P*8P*PPr=cTfd}xrt|dd}|r t|SdS)zMOwning session and visibility flags for *message_id* (None if missing/error).cj5jjdfjcdddS#1swYyxYw)Nz?SELECT session_id, active, compacted FROM messages WHERE id = ?)_lock_connexecutefetchonerI message_idsr&_lookupz+_get_message_storage_state.._lookupsH XX m88##QT^S`bbjbjbl m m ms +AA Nz*message storage-state lookup failed for %s)r'dict)rIrrrows`` r&_get_message_storage_staters3m  h/[]ghC49%%r=statec2|duxr|ddk(xr|ddk(S)z{Compaction archives are ``active=0, compacted=1``; rewind/undo rows are ``active=0, compacted=0`` and must stay hidden.Nactiver compactedrnr)rs r&_is_compacted_staters-   QxA!5 Q% :LPQ:QQr=c,tt||S)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"jI JJr=m anchor_idmax_content_lenc `|jd}t|trd|vrddlm}||}|jd|jd||jdd}|j d Dcic]&}|j|s||j|(c}||jd|k(rd |d <|r3|r1t ||kDr#|j |d |d zd t ||jDcic]\}}||dk(s||c}}Scc}wcc}}w)zMSlim a message row; keeps ``content`` even when empty (tool-call-only turns).rXr) strip_ansirrr})rrrXr}) tool_name tool_calls tool_call_idNTanchoru…)rXcontent_truncatedoriginal_content_chars)rPr>r?tools.ansi_striprupdaterr)rrrrXrentrykvs r&_shape_messagerseeIG'3Fg$5/W%55;f 'XYX]X]^iXj kE LL'R_!VWV[V[\]V^!QUU1X+_`t !9h7s7|o'E W%5o6>RV,/L  :"[[] NTQamqI~AqD NN ` Os7D%D% D*D*profilecld}|xsdjxs t|dd}|rd|d|Sd|S)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).c.ddlm}|}|dk(rdS|S)Nr)get_active_profile_namecustomr5)hermes_cli.profilesr)rresolveds r&_activez_session_link.._actives?*,)r7x7r=r5z/get_active_profile_name failed for session linkz @session:/)rrr')rrrnames r& _session_linkrsK8 Mr " lfWb:k&lD.2YtfAj\ *P)J<8PPr= lineage_rootc TdDcic]}||| }}|r ||dk7r||d<|Scc}w)zMCanonical key order; ``parent_session_id`` set when the hit lives in a child.rrOrrrN matched_rolematch_message_idr bookend_startmessages bookend_endmessages_beforemessages_afterdetailrrbr)rfieldsrrs r&_discovery_entryr sP$c daQq \ dE d l(;;%1!" L  ds %querycurrent_lineage_rootc@ |jjd xrt fddd  syt |r|k(r t syt fddd xsi}|j dt vryt fdgd }|r|d j d ndint fd id  |j dxs }d" fd }it  t|j d|j dd|j dxsd|dd||d|dd|d|ddd|d|dd j dd  j dtt|dz d d d!iS)#zJDiscovery-shaped result when the query matches a session title, else None.z`'"c&jSrE)resolve_session_by_title)rI title_querysr&r<z%_title_match_result..s0K0KK0Xr=Nz&resolve_session_by_title failed for %rcLjxsjSrErF)rIrrsr&r<z%_title_match_result..s"..">"\"..Q[B\r=z%get_session failed for title match %src&jSrE get_messagesrHsr&r<z%_title_match_result..#booj9r=z&get_messages failed for title match %srrc.jddS)Nwindowbookend)get_anchored_view)rrIrsr&r<z%_title_match_result..&s$$Z1a$Pr=z.get_anchored_view failed for title match %s/%srNclj|xs|Dcgc]}t|||c}Scc}w)Nrr)rPr)keyfallbackrrrviews r&shapez"_title_match_result..shape*s9((3-386qFOT6 66s1rMr3r session_titlezSession title matched: rrrrrrrrfullr _lineage_root)N) rrr'rkrrP_HIDDEN_SESSION_SOURCESrrBmaxr) rIrr session_metarrNrrrrrrs ` @@@@@r&_title_match_resultrs++-%%f-K_(XZ^(PR]"_J #B 3L 0D DMghjlvMw\^bA:OURT!%<<92?gistH)1 %tI"2PRT8*i)QD   W % 4E6 '2CLDTDTUaDb2c)4LBhhsm>Qr A)!%% 2*>? 1d 3 AA As/A  match_info result_detailc|jdxs||jd}} |j||dd}t |||d k(} }t ||t|jd xs|jd |jd xs|jd d|jdxs|jdxsd|jdxsd |jd||jdxsd| r t|dng|jdxsgD cgc]&} | s| jd|k(rt| |d(c} | r t|dng|jdd|jdd|S#t$r$}tjd|||dYd }~y d }~wwxYwcc} w)zQDiscovery result from a surviving FTS row; None (dropped) if the view can't load.rrrrrz&get_anchored_view failed for %s/%s: %sT)rNrrMrrr3rrNrrr5rrrrrrrrr) rPrrrwarningrJrrBrr) rIrrrhit_sidmsg_idrr%rrrs r& _hydrate_hitrIs nn\2BlJNNSWDXVG##GVAq#I+2|U$L  |// =bPaAb c)PZ^^Hi-Pw'O:>>'+BOiw'/4jnnV>T )B)Hb9=ht_52 HHX.4"XtPVAV!fdKX59HT=1r!2A6txxP`bcGd   @'6ST_cdXsF++G F=F88F= role_filterlimitsortcurrent_session_id link_profilec  |r t|nd} t| xsg} t| } | re| d| jdxs| d}}t t |xs t |jd}||h| zs t | sd} t fddd\}}|r|St|d }|s| st|gd Si}| r| gng}| r| jddx}rd d i||<|D]}t||k\rnr|dt|d}}|| vs|| vr0t|jd}| r|| k(rt|s|sa|r||k(r|sk|j|i|d|i|jD]B\}}|jd rt!|||dk(s|sdnd}|2|j#|D|D]}t%|d||d<t||t|dS)z=Discovery shape: FTS5 plus adaptive or full result hydration.NrrrMc njxsddgtttdt S)Nuser assistantr) rrexclude_sourcesroffsetrrrr)search_messagesrr_DISCOVER_SCAN_LIMIT_DISCOVER_SEARCH_FIELDS)rrrIrrrsr&r<z_discover..ps@R%7%7!E0E45=QZ[bf&Y&8&Pr=zFTS5 search failed: %sz Search failedc8|jdxsdtvS)Nrr5)rP_DEMOTED_SESSION_SOURCES)rs r&r<z_discover..ysQUU8_5JOg4gr=)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)rkrrrPrrJrr/sortedrpoprrr setdefaultrrrr)rIrrrrrrr rrrrexcluded_roots title_result title_sid title_root title_started raw_resultserr seen_sessionsr title_lineager,raw_sid resolved_sidis_compacted_hitrrrs``` ` `` r& _discoverrBas HZ+B0BC_c,R1D1JKN&r52FGL ,\ :L>- ( RzVvEU]d6jst   NN5 ! "I%eL&9<Hf I R3}K] N PPr=c|t|jsyddlm}ddlm}|j |}|j||j|std|d||j|dz d S) zTAnother profile's ``state.db`` opened read-only (safe on a live DB); None = current.Nr)profiles) SessionDB profile 'z' does not existzstate.dbT)db_path read_only) r?rr hermes_clirD hermes_staterEnormalize_profile_namevalidate_profile_nameprofile_existsr{get_profile_dir)r profiles_modrEcanons r&_resolve_profile_dbrQs~c'l0023&  / / 8E&&u-  & &u -9UG+;<== \99%@:MY] ^^r=headtailc ~t}|stddStfddd\}}|r|S|Dcgc]}t|t} }t | t | ||zkD} } t ddt|t|| | | r | d || | d zn| d | rd d | d |d|diSiScc}w)zQRead shape: whole session, or ``head`` + ``tail`` messages with a scroll pointer.session_id not found: Fr)c&jSrErrHsr&r<z_read_session..rr=zget_messages failed for %s: %szfailed to load sessionrreadN)r rr0r message_count truncatedrr-z Session has z messages; showing first z + last z=. Pass around_message_id (any id above) to scroll the middle.r) rJr,r/r_READ_MAX_CONTENTrrWrrQ) rIrrRrSr rKrowsr<rshapedr rYs `` r& _read_sessionr]s R ,D 2:,?OO9;[]u "ID#  LP QqnQ0AB QF Q6{CK$+$=9E  vFz jR^8_/5UV_:Cu uv6 vcleW4MdVS[\`[ab] ]_ vvrt  vvRsB:rct|||}tj|jddus|r|St d|ddS)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=``. r r*Fz&session_id not found in this profile: z^. If it belongs to another profile, pass profile= (or the @session:/ link).r))r]rTloadsrPr,)rIrrresults r& _read_scopedrbs[2s 9F zz&i(5 >seD\\ej llr=cFfd}t|dd\}}|xs|S)zFBrowse shape: metadata for the most recent sessions (no LLM, no FTS5).c t dd}| td| dzttd} r t nd\}} |r|r|ndh}|Dcgc]}|j dd|vs|c}d Dcgc]}|j ddt |j dd |j d xsdd d Dcic]}||j |dc}|j d d |j ddd}}}td|t|dt|dScc}wcc}wcc}}w)Nlist_recent_sessions_boundedz?session database does not support bounded recent-session browseg@)rr%timeout_seconds)NFrr5rN)rr0rN)rrM last_activerXrpreview)rXribrowsezShowing zZ most recent sessions. Pass a query= to search, or session_id+around_message_id to scroll.)r rr r-) getattr RuntimeErrorrrrirPrrWr) bounded_listsessions current_roothas_compression_hophiddenxrhrrrrIrr s r&_browsez&_list_recent_sessions.._browsesvr#A4H  `a a"* !893P;M r#5 6R_ * )%6Ill`de "*KAQUU4_F-JaKFUS U%%b/=tRR^3_UU7^+tYIp/qA155B</qYUU?A6155TVCWYUU 'Ws7|n%9 9; ;L0rUs%D72D7?A E D<$+E<Ez!Error listing recent sessions: %szFailed to list recent sessions)r/)rIrrr rsrr<s```` r&_list_recent_sessionsrts(;6WACcdHC :#r=r"lohict t|}t|t ||S#ttf$r|}Y)wxYwrE)rurr{rmin)rlr"rurvs r& _clamp_intrys@E  r3ub> "" z "s #77 anchor_sidcnt|||r t|ry|duxr|ddk(xs t|| S)aOTrue 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.FNrr)rrr)rI anchor_staterzrs r&_anchor_in_live_contextr}sI Z); <@ST`@a  $ Dh)?1)D wMghjlvMwIwwr=raround_message_idrcZ tt dddt }|xsij d |rt| xs|r tddSt}|std dStfd d d \}}|r|S|j d xsg} i} | sg re k7r`t xrt fdddd} | r:| j d r)dd dd| d<| | d  c}} t xs|}| stdddStd dt|| D cgc]} t| c} |j dd|j dddd | S#ttf$rtddcYSwxYwcc} w)!zDScroll shape: a window centered on an anchor (no FTS5, no bookends).z)scroll requires integer around_message_idFr)rrnrrz]scroll rejected: anchor lives in the current session lineage (already in your active context)rUc,jSN)rget_messages_around)r~rIrrsr&r<z_scroll.."sb44ZAR[a4br=zget_messages_around failed: %szfailed to load messagesrc,jSrr)r~rIowningrsr&r<z_scroll..,sB**63DV*Tr=Nz%rebind get_messages_around failed: %sTrzaround_message_id z lives in z (child of z); rebound transparentlyrz not in session_id scroll)rrrrzScroll 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 rr~rrrrrhintr)rurr{r,ryrrPr}rJr/rr'rWrQr)rIrr~rrr|rrr<rr rebind_viewrrs```` @r&_scrollrs*V 121b )F-b2CDL b % %l 3F5b,H\R\^pqyDIJ J$R4L 2:,?OOb68QSID#  xx!'RH E 6Z#7$B F;J T 9DAJ  ;??84"45F4GzRXQYZ--7L8P!RE) )4k(6KV &D(J,R8HLL ./@.AATU_T`akpqq  E *@Q(6vJRSQ..?@S!2A6txxP`bcGd:  E?D EE= z "VEuUUVBTs FF(F%$F%ct|trr? partitionrrrQrr,rrrbryrtryrr{rBsplitr)rrrrIrrr~rrrr owned_dbsafterbeforer emb_profile_emb_id profile_dbr% sort_normrrr,s r& _dispatchr@s6*c"sj'8!+!5!5c!: Q Js7|7I7I7K%F(1 !+T $*c"z'7'7'9  (2z//13DfN`a aB 0 0 2G<< uaB 'E  5#.ekkm$R0BQXYY(24(= ""$4I1.u57G7O)  U[[]%9PdCdijnZdepruZv):):3)?MA1779aggiMUQU}A#FC0V\\^5I5I5Kv5Uv[e-Ghbk:;NO  QQ# FIgYc!5uEEF 1#a&%001NsH H:H1I&I H.H)#H.)H.1 I:IIIrrrrcRddlm}ddlm}mg}|2t |dd}|t |dS|j| t|||||||||| | || | | t|D]t fd dd S#t|D]t fd dd wxYw) zRun session search, closing DBs opened here. Positional order is frozen for old callers; new parameters are appended after ``detail``.r)format_session_db_unavailable)acquirerelease_or_closeNz(SessionDB unavailable for session_searchFr))rrrcSrEr)owned_dbrsr&r<z session_search..~s +H5r=z(Failed to close session_search SessionDB) rJrhermes_state_registryrrr'r,rrreversed)rrrrIrrr~rrrrrrrrrrrrs @@r&session_searchrjs ;?I z GT#M N :;=uM Mi UB8JJ*FD'69$VI\^!+ iH 5t=g h i+ iH 5t=g h is B#B&cl ddlm}|jjS#t$rYywxYw)z#Requires the SQLite state database.r_default_db_pathF)rJrparentexists ImportErrorrs r&!check_session_search_requirementsrs41!((//11 s $' 33ru[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).objectstringzSearch 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).)type descriptionintegeruDiscovery 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.)rrr"rrzDiscovery 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".)renumrrzDiscovery 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.)rrrr"zDiscovery 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.zDiscovery 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.arrayrzDiscovery 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.)rrrzScroll shape. Session to read inside. Use the session_id returned from a prior discovery call. Must be paired with around_message_id.uScroll shape. Message id to center the window on — use match_message_id from a discovery result, or any id from a prior window.zScroll shape only. Messages to return on each side of the anchor (anchor itself always included). Clamped to [1, 20]. Default 5.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.zOptional. 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.) rrrrrrrrr~rrr)r propertiesrequired)rr parameters)registryr,c .td |jdxsd|jdd|jdd|jdd|jd |jd d d Dcic]}||j|c}Scc}w)Nrr5rrrrrrrIr)rrrrrIr)rrr~rrrrrr)rrP)argskwrs r&r<r<s~ Phhw%2TXXgq-A$((S[]^J_xx*-"&&,SUSYSYZnSo P$N Oa1dhhqk> O P Os4B u🔍)rtoolsetschemahandlercheck_fnemoji)NNrE)NNNNN)rrN)rN)NNN)r5NrNNNNrNNrNNN)M__doc__rTrrervrrtypingrrrrr hermes_state_commonr rr+rZr(rcompile IGNORECASErsrxr)r]rrZr'r/rur9r?rBrrJrQrWr^rrirkrrrrrcrrrrrrrrrrrrrrrBrQr]rbrtryr}rrrrSESSION_SEARCH_SCHEMAtools.registryrr,registerrr=r&rs[  '3359%RZZ 4bmmD#%f=gD1:?$GJ%UC 56J3JTcTdT Dd38nDc3hD HcHOCODO  s  uS$Y/?  1S1S1#HSM#hsm#4chsm"j j#jS[\_S`jeij  S T#Y3s8>>>> QsQtQ&(4S>2J&RxS#X7RDR KTK BF48Od38nO#O$,SMO=A#s(^O" Qc QC Q3 Q8C=tCH~#'3#'hsm#'PXY]^acf^fYgPh#'LuucuDucuA4S>AAT#s(^0DA 3DcNSV[cdhilnqiqdr[s2PTIM9=MPMP8DI+>MPsMPRZ[^R_MPMP/2MPILMP  MP9A#MP$,DI#6MPCFMP` _ _v#vSvSvUXvdgv$ l# l l# lScX[gjB#s####x#xSVx[_xHI&*+EC+EC+E+E #+E/2+E`<@'QDG'QTQUdhYceii#iiCi'*i?Bi^aii*-i?BiSVii/2iPXX\]`XaObiori.4  0!&"A!!8,R !#V,8 & !I!8  (+J $!)"$""V !G!7Gl Z_p#BJ0    P /  r=