i_ dZddlZddlZddlZddlZddlZddlmZm Z m Z m Z m Z ddl mZmZdZdZd.ded efd Zd e eeedfd efd Zd e eee fd efdZefdededed efdZdededeee fd e efdZdZd/deded efdZ d0dedededed ef dZd efdZdddd d!d"d d#d"d$d%dd&d'gd(d)Zdd*l m!Z!m"Z"e!j#dded+ed,-dS)1a Session Search Tool - Long-Term Conversation Recall Searches past session transcripts in SQLite via FTS5, then summarizes the top matching sessions using a cheap/fast model (same pattern as web_extract). Returns focused summaries of past conversations rather than raw transcripts, keeping the main model's context window clean. Flow: 1. FTS5 search finds matching messages ranked by relevance 2. Groups by session, takes the top N unique sessions (default 3) 3. Loads each session's conversation, truncates to ~100k chars centered on matches 4. Sends to Gemini Flash with a focused summarization prompt 5. Returns per-session summaries with metadata N)DictAnyListOptionalUnion)async_call_llmextract_content_or_reasoningii'defaultreturnc ddlm}|}n#t$r|cYSwxYwt|tr|dini}t|tr|dini}t|ts|S|d}||S t |}n#ttf$r|cYSwxYwtdt|dS) z?Read auxiliary.session_search.max_concurrency with sane bounds.r) load_config auxiliarysession_searchmax_concurrencyN) hermes_cli.configr ImportError isinstancedictgetint TypeError ValueErrormaxmin)r rconfigaux task_configrawvalues >/home/ubuntu/.hermes/hermes-agent/tools/session_search_tool.py#_get_session_search_max_concurrencyr$s111111 )3FD)A)A I&**[" % % %rC3=c43H3HP#''*B///bK k4 ( ( //+ , ,C {C z " q#eQ--  s ""0CCCtsc|dS t|ttfr0ddlm}||}|dSt|t r{|ddddr=ddlm}|t|}|dS|Snf#tttf$r"}tj d ||d Yd}~n2d}~wt$r"}tj d ||d Yd}~nd}~wwxYwt |S) zConvert a Unix timestamp (float/int) or ISO string to a human-readable date. Returns "unknown" for None, str(ts) if conversion fails. Nunknownr)datetimez%B %d, %Y at %I:%M %p.-z!Failed to format timestamp %s: %sTexc_infoz,Unexpected error formatting timestamp %s: %s)rrfloatr( fromtimestampstrftimestrreplaceisdigitrOSError OverflowErrorloggingdebug Exception)r%r(dtes r#_format_timestampr;3s  zy\ b3, ' ' 8 ) ) ) ) ) )''++B;;677 7 b#   zz#r""**333;;== <------++E"II66{{#:;;;I    /QQQ 92q4PPPPPPPPP \\\ Db!VZ[[[[[[[[[\ r77Ns1A C#B C# C##E:D E$EEmessagescg}|D]}|dd}|dpd}|d}|dkrI|rGt|dkr|dd d z|d dz}|d |d ||dkr|d}|rt |t rg}|D]k}t |t rT|dp)|didd} || l|r,|dd|d|r|d||d||d|d |d|S)zEFormat session messages into a readable transcript for summarization.roler'contentr* tool_nameTOOLNz ...[truncated]... iz[TOOL:z]: ASSISTANT tool_callsnamefunction?z[ASSISTANT]: [Called: z, ]z [ASSISTANT]: [z )rupperlenappendrlistrjoin) r<partsmsgr>r?r@rEtc_namestcrFs r#_format_conversationrTMs E11wwvy))//11'')$$*GGK(( 6>>i>7||c!!!$3$-*AAGDEENR LL9)9999 : : : : [ ..J 8jT:: 8$..B!"d++.!vvf~~X B1G1G1K1KFTW1X1X ---RLL!P$))H:M:M!P!P!PQQQ<LL!:!:!:;;; 6W667777 LL/T//g// 0 0 0 0 ;;u   full_textquery max_charsct||kr|S|}|}g}tjtj|}d||D}|s|}t|dkri|D]6}dtjtj||D|<7t|fd gD]4tfd|Dr| 5|sj|}|D]S}tjtj||D])} | | *T|s&|d|} |t|krdnd } | | zS| d } d } |D]}td ||d zz |zt|kr/td t||z t|tfd |D}|| kr|} } | }tt|||z}|||} |d krd nd }|t|krdnd } || z| zS)a% Truncate a conversation transcript to *max_chars*, choosing a window that maximises coverage of positions where the *query* actually appears. Strategy (in priority order): 1. Try to find the full query as a phrase (case-insensitive). 2. If no phrase hit, look for positions where all query terms appear within a 200-char proximity window (co-occurrence). 3. Fall back to individual term positions. Once candidate positions are collected the function picks the window start that covers the most of them. c6g|]}|Sstart.0ms r# z,_truncate_around_matches..s JJJQqwwyyJJJrUrc6g|]}|Sr[r\r^s r#raz,_truncate_around_matches..s-%%%"#AGGII%%%rUcJt|gSN)rLr)tterm_positionss r#z*_truncate_around_matches..sc.2D2DQ2K2K.L.LrU)keyc3K|]9}|ktfd|gDV:dS)c3DK|]}t|z dkVdS)N)abs)r_pposs r# z5_truncate_around_matches...s2NNqAG s*NNNNNNrUN)anyr)r_rernrarestrfs r#roz+_truncate_around_matches..sbF{{NNNNN4F4Fq"4M4MNNNNN"{{{rUNz& ...[later conversation truncated]...r*rc3<K|]}|cxkrknndVdS)rNr[)r_rmwewss r#roz+_truncate_around_matches..s7??!",,,,B,,,,,A,,,,??rUz(...[earlier conversation truncated]... )rLlowerstriprecompileescapefinditersplitrrallrMr]sortrsum)rVrWrX text_lower query_lowermatch_positions phrase_pattermsrer` truncatedsuffix best_start best_count candidatecountr]endprefixrnrqrfrtrus @@@@@r#_truncate_around_matchesrosr  9~~""""J++--%%''K!#OBIk2233JJJ**=*=j*I*IJJJO 0!!## u::>>35N  %%'){29Q<<'L'L%%%q!!$L$L$L$LMMMF%))&"55 0 0"0 $**3/// 2!!## 2 2A[1z:: 2 2&&qwwyy1111 2 "jyj) ?H3y>>?Y?Y;;_a6!!JJ$   I Q. / / )^ I  QI233BYB?????????? :  JJ E c)nnei/ 0 0C%)$I=BQYY 9 9BF;>Y;O;O 7 7UWF I  &&rUconversation_text session_metac Kd}|dd}t|d}d|d|d|d|d | }d }t|D]} td d |d d|d gdtd{V} t | } | r| cSt jd|dz|||dz kr!tj d|dzzd{V| cS#t$rt jdYdSt$rS} ||dz kr!tj d|dzzd{Vnt jd|| dYd} ~ dSYd} ~ d} ~ wwxYwdS)zDSummarize a single session conversation focused on the search query.aNYou are reviewing a past conversation transcript to help recall what happened. Summarize the conversation with a focus on the search topic. Include: 1. What the user asked about or wanted to accomplish 2. What actions were taken and what the outcomes were 3. Key decisions, solutions found, or conclusions reached 4. Any specific commands, files, URLs, or technical details that were important 5. Anything left unresolved or notable Be thorough but concise. Preserve specific details (commands, paths, error messages) that would be useful to recall. Write in past tense as a factual recap.sourcer' started_atzSearch topic: z Session source: z Session date: z CONVERSATION TRANSCRIPT: z- Summarize this conversation with focus on: r rsystem)r>r?userg?)taskr< temperature max_tokensNz9Session search LLM returned empty content (attempt %d/%d)rz6No auxiliary model available for session summarizationz2Session summarization failed after %d attempts: %sTr,) rr;rangerMAX_SUMMARY_TOKENSr r6warningasynciosleep RuntimeErrorr8) rrWr system_promptrstarted user_prompt max_retriesattemptresponser?r:s r#_summarize_sessionrsh  R  h 2 2F 0 0 > >??G > > >! > >  > >&7 > >7<  > >K%%!! +%%-@@# << -H38<j j!$r2t3jdd tjddddcYSwxYwg}tE|D]\\} }}}} t| t0rt3jd| | d d} | tG|$d|$dd|$dd }| r| |d!<n|r |dd"d#znd$}d%||d!<||tjd |t#|t#| d&dS#t0$rB}t3j%d'|d td(t|dcYd}~Sd}~wwxYw))a Search past sessions and return focused summaries of matching conversations. Uses FTS5 to find matches, then summarizes the top sessions with Gemini Flash. The current session is excluded from results since the agent already has that context. NzSession database not available.Frr rrc^g|]*}||+Sr[)rw)r_rs r#raz"session_search..hs-PPPqaggiiPPPPrU,2r)rWrrroffsetTzNo matching sessions found.)rrWrrrrrr c2t}|}|r||vr|| |}|snQ|d}|r|}nn6n/#t$r"}t jd||dYd}~nd}~wwxYw|r||v|S)z9Walk delegation chain to find the root parent session ID.rz)Error resolving parent for session %s: %sTr,N)rrrrr8r6r7)rrrsessionrr:rs r#_resolve_to_parentz*session_search.._resolve_to_parent~seeGC #W,, C    nnS11G"$[[)<==F$!MC!%  EEEE #W,,&JsA"A"" B,B  Bz Failed to prepare session %s: %sr,c ^Ktttdt}t j|dt dtt tfdtt ffd fdD}t j |ddid {VS) z0Summarize all sessions with bounded concurrency.rtextmetar cK4d{Vt||d{Vcdddd{VS#1d{VswxYwYdSrd)r)rrrW semaphores r#_bounded_summaryz@session_search.._summarize_all.._bounded_summarys$GGGGGGGG!3D%!F!FFFFFFFGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGs6 AAc2g|]\}}}}||Sr[r[)r__rrrs r#raz:session_search.._summarize_all..s>$Aq$! t,,rUreturn_exceptionsTN) rr$rrLr Semaphorer1rrrgather)rcorosrrrWtaskss @@r#_summarize_allz&session_search.._summarize_alls!"E"G"GQPSTYPZPZI[I[\\O)/::I GS GS#X G8TW= G G G G G G G(-E!G$GGGGGGGG GrU) _run_asyncz0Session summarization timed out after 60 secondszOSession summarization timed out. Try a more specific query or reduce the limit.)rrz"Failed to summarize session %s: %ssession_startedrr'model)rwhenrrsummaryrBu …[truncated]zNo preview available.u,[Raw preview — summarization unavailable] )rrWrrsessions_searchedzSession search failed: %szSearch failed: )&rrrrrrrrwrr|search_messagesrNrrrr1rrLitemsget_messages_as_conversationrrTrrMr8r6rrr model_toolsr concurrentfutures TimeoutErrorzipr;rr)rWrrrr role_list raw_resultsrcurrent_lineage_root seen_sessionsresultraw_sid resolved_sidr match_infor<rrr:rrr summariesrentryrrs` ` @r#rrCs) z;UKKKK eS ! ! JJEE:&   EEE  3ua== ! !E D D$R0BCCC KKMMEeE  Q;,,.. QPPK,=,=c,B,BPPPI((! !899 )   #:8  " ### # 3 3      47I R  1 2 2 2d  !  F\*G--g66L$  8L(L(L! g1C&C&C=00f'3|$.4 l+=!!U**+&3&9&9&;&;   "J  :::FF!~~j99?R $8$B$B!$<=NPU$V$V! j*6GVWWWW   6!   Hd5i+@&A H H H H H H H # / . . . . . j!1!122GG!. # # # OB    : j"### # # #  # FI%QXFYFY $ $ B :Z%6F&),, 8))*..9J*K*KLL$..9==#00 E ]#)i  M^z,TcT25GGGcz#\SZ#\#\i   U # # # #z ^^!$]!3!3      EEE 11tDDDD4CFF44eDDDDDDDDDEs=AA0BO:1BO:H6%O:&AH65O:6 I"IO:I"".O:J+*O:+AK1.O:0K11DO:: Q7Q;QQcd ddlm}|jS#t$rYdSwxYw)z;Requires SQLite state database and an auxiliary text model.rDEFAULT_DB_PATHF) hermes_staterrexistsrrs r#!check_session_search_requirementsr sP000000%,,... uus ! //ru6Search your long-term memory of past conversations, or browse recent sessions. This is your recall -- every past session is searchable, and this tool summarizes what happened. TWO MODES: 1. Recent sessions (no query): Call with no arguments to see what was worked on recently. Returns titles, previews, and timestamps. Zero LLM cost, instant. Start here when the user asks what were we working on or what did we do recently. 2. Keyword search (with query): Search for specific topics across all past sessions. Returns LLM-generated summaries of matching sessions. USE THIS PROACTIVELY when: - The user says 'we did this before', 'remember when', 'last time', 'as I mentioned' - The user asks about a topic you worked on before but don't have in current context - The user references a project, person, or concept that seems familiar but isn't in memory - You want to check if you've solved a similar problem before - The user asks 'what did we do about X?' or 'how did we fix Y?' Don't hesitate to search when it is actually cross-session -- it's fast and cheap. Better to search and confirm than to guess or ask the user to repeat themselves. Search syntax: keywords joined with OR for broad recall (elevenlabs OR baseten OR funding), phrases for exact match ("docker networking"), boolean (python NOT java), prefix (deploy*). IMPORTANT: Use OR between keywords for best results — FTS5 defaults to AND which misses sessions that only mention some terms. If a broad OR query returns nothing, try individual keyword searches in parallel. Returns summaries of the top matching sessions.objectstringuSearch query — keywords, phrases, or boolean expressions to find in past sessions. Omit this parameter entirely to browse recent sessions instead (returns titles, previews, timestamps with no LLM cost).)type descriptionzqOptional: only search messages from specific roles (comma-separated). E.g. 'user,assistant' to skip tool outputs.integerz/Max sessions to summarize (default: 3, max: 5).)rrr )rWrr)r propertiesrequired)rFr parameters)registryrc t|dpd|d|dd|d|dS) NrWr*rrr rr)rWrrrr)rr)argskws r#rgrgKsf~hhw%2HH]++hhw"" 66$<<66"677  9 9 9rUu🔍)rFtoolsetschemahandlercheck_fnemoji)r rd)Nr NN)$__doc__rconcurrent.futuresrrr6rxtypingrrrrragent.auxiliary_clientrr MAX_SESSION_CHARSrrr$r.r1r;rTrrrrrboolrSESSION_SEARCH_SCHEMAtools.registryr rregisterr[rUr#rs5   33333333333333OOOOOOOO!!!S!!!!*%UC 56344S#X#7CF2CR'R'R'R'+.R'R'R'R'R'j==#&=6:38n= c]====F$6Q6QS6Qc6QS6Q6Q6Q6Qv " FEFE FEFE FE  FE  FEFEFEFER4  X.! n ! S "P  #3,,`0///////    9 9 /       rU