mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-06-23 10:42:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 7

docs(session-search): document source-first retrieval limits

Browse source 
Clarify that session_search is secondary context and direct source identifiers must be inspected first when accessible. Add regression coverage for the tool description.
This commit is contained in:
lkz-de 2026-06-15 02:52:39 +02:00 • committed by Teknium
parent 1eb2959309
commit 6403ed06b3
2 changed files with 25 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

8
tests/tools/test_session_search.py
View file

@ -98,6 +98,14 @@ class TestSchema:
desc = SESSION_SEARCH_SCHEMA["description"].lower()
assert "no llm" in desc
def test_schema_description_enforces_source_first_limit(self):
desc = SESSION_SEARCH_SCHEMA["description"].lower()
assert "source-first limit" in desc
assert "conversation history only" in desc
assert "direct source" in desc
assert "session_search as secondary" in desc
assert "not found" in desc
class TestHiddenSources:
def test_tool_source_hidden(self):

21
tools/session_search_tool.py
View file

@ -631,6 +631,17 @@ SESSION_SEARCH_SCHEMA = {
"Search past sessions stored in the local session DB, or scroll inside one. "
"FTS5-backed retrieval over the SQLite message store. No LLM calls — every "
"shape returns actual messages from the DB.\n\n"
"SOURCE-FIRST LIMIT\n\n"
" This tool searches Hermes conversation history only. It is not evidence "
"about the current contents of external sources. If the user provided a "
"direct source such as a URL, phone number/contact, app/thread, file path, "
"account, website, or live system, inspect that original source before or "
"instead of session_search when accessible. Use session_search as secondary "
"context for what was previously said, not as primary proof of what the "
"source currently contains. If the original source is inaccessible, say so "
"and why before falling back to session history. Do not conclude 'not found' "
"or 'no prior correspondence' from session_search alone when a direct source "
"was provided.\n\n"
"FOUR CALLING SHAPES\n\n"
" 1) DISCOVERY — pass `query`:\n"
" session_search(query=\"auth refactor\", limit=3)\n"
@ -673,10 +684,12 @@ SESSION_SEARCH_SCHEMA = {
"(`\"docker networking\"`), boolean (`python NOT java`), or prefix wildcards "
"(`deploy*`).\n\n"
"WHEN TO USE\n\n"
" Reach for this on any \"what did we do about X\" / \"where did we leave Y\" / "
"\"find the session where Z\" question — before gh, web search, or filesystem "
"inspection. The session DB carries what was said when; external tools show "
"current world state."
" Reach for this on questions about Hermes conversation history itself, such "
"as \"what did we do about X\", \"where did we leave Y\", or \"find the "
"session where Z\". If the user provided a direct source identifier, inspect "
"that source first when accessible; session_search can then supply historical "
"context. The session DB carries what was said when; external tools show "
"current source/world state."
),
"parameters": {
"type": "object",