feat: session handoff — auto-load continuity files between sessions - #61840
Open
k-QRedHacker wants to merge 1 commit into
Open
feat: session handoff — auto-load continuity files between sessions#61840k-QRedHacker wants to merge 1 commit into
k-QRedHacker wants to merge 1 commit into
Conversation
Reads all *.md files from ~/.hermes/session_handoff/ at session build time and injects them into the system prompt volatile_parts tier. Use case: place handoff notes before starting a new session (/new). The agent automatically reads and incorporates them, providing continuity without explicit user action. Cache safety: read once at build_system_prompt_parts() time, byte-stable for the session lifetime. Same tier as memory and user profile — volatile at session boundary, stable within. Co-Authored-By: Claw F (量子红客组织)
alt-glitch
added
type/feature
teknium1
reviewed
Jul 10, 2026
teknium1
left a comment
teknium1
left a comment
Contributor
There was a problem hiding this comment.
Thanks for separating the session-handoff proposal into a focused change. The feature is not already present on current main: agent/system_prompt.py:457-500 has no handoff source.
Problems
- The new raw read at
agent/system_prompt.py:484bypasses_scan_context_content()(agent/prompt_builder.py:50-66). Existing tests show the scanner blocks prompt-injection text before system-prompt insertion (tests/agent/test_prompt_builder.py:69-73); this path would inject it verbatim. - The loop loads every
*.mdfile with no per-file or aggregate cap, unlike existing context sources, whose cap is defined inagent/prompt_builder.py:1171-1219. - The PR changes prompt assembly but adds no coverage for loading, profile scoping, injection blocking, truncation, or cache stability.
Suggested changes
- Add a bounded, scanner-backed handoff loader next to the existing prompt-context loaders, then test it against a temporary
HERMES_HOME. - Preserve deterministic file ordering and expose truncation through the existing warning path.
Automated hermes-sweeper review.
| if _sh_dir.is_dir(): | ||
| _sh_parts = [] | ||
| for _sh_f in sorted(_sh_dir.glob("*.md")): | ||
| if _sh_f.is_file(): |
Contributor
There was a problem hiding this comment.
This inserts arbitrary file content directly into the system prompt. Existing context sources call _scan_context_content() first (agent/prompt_builder.py:50-66); route handoff content through the same scanner before appending it.
| from hermes_constants import get_hermes_home as _SHget_hh | ||
| _sh_dir = _SHPath(_SHget_hh()) / "session_handoff" | ||
| if _sh_dir.is_dir(): | ||
| _sh_parts = [] |
Contributor
There was a problem hiding this comment.
Please enforce a per-file or aggregate character budget here. Existing context sources use the bounded truncation path in agent/prompt_builder.py; this unbounded glob can consume the session context window.
Author
|
来件已收悉，谢谢。
|
teknium1
added
sweeper:risk-security-boundary
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Session Handoff: Auto-Load Continuity Files Between Sessions
This PR adds a lightweight session handoff mechanism to Hermes Agent. Users can place
*.mdfiles in~/.hermes/session_handoff/before starting a new session (/new), and the agent automatically reads and incorporates them into its system prompt.What This Does
~/.hermes/session_handoff/for all*.mdfiles at session build timevolatile_parts(same tier as memory and user profile)Cache Safety
Does NOT break prompt caching: files are read once at
build_system_prompt_parts()time. The result is byte-stable for the session lifetime — same behavior as existing memory and user profile injection.File Changed
agent/system_prompt.pybuild_system_prompt_parts()Total: 1 file, 26 insertions.
Note
This was originally bundled inside #61731/#61738 alongside the time awareness feature. It has been separated into its own PR per reviewer feedback (#61837 is the clean time-awareness-only PR).