NousResearch/hermes-agent

Gateway session lifecycle and state.db cleanup

Cluster 54189 · agent. Data as of

Nothing open on GitHub. Fix merged in #101316 on 2 Sep 2026. Check it covers your case.

The short answer

0open issues
0open PRs
4items grouped
Known?
Yes. 4 related items grouped here, 1 issue already closed.
Fix event
A fix was merged to main in PR #101316. Check it covers your case. No release data is tracked.
Tracker
The maintainers' tracker marks this resolved, deciding PR #101316. That is separate from the fix event.
Still open
Nothing open on GitHub.

These items address unbounded growth of state.db by adding session expiry tracking and a CLI subcommand to expose backend session lifecycle management commands.

Open issues0

No open issues.

Open PRs0

No open pull requests.

Fixes on record

Merged to main. A stamp counts the issues a fix is linked to.

  • #101316 fix(sessions): state.db auto-prunes ended sessions by default (90d) and VACUUM only runs above 25% freelist (#54189)

    merged to main

    files: cli-config.yaml.example, hermes_cli/config_defaults.py, hermes_state.py, tests/test_hermes_state.py, tests/test_session_vacuum_config.py, website/docs/user-guide/sessions.md

2 PRs closed without merging

From the close comments: done elsewhere 2

  • #56603 fix(gateway): set ended_at on expired gateway sessions to bound state.db growth · done elsewhere → 9fc0074
  • #56998 feat(cli): add hermes sessions subcommand exposing backend session lifecycle commands · done elsewhere → 040a5e3
Closed issues · 1
  • Closed#54189state.db unbounded growth: no session lifecycle/cleanup mechanism
How this cluster was grouped
  • Link evidence (structural links throughout): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
  • Pairwise link density 0.50: the share of item pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. 1.00 means every pair is linked.

Pick up a Lab task

Check whether a fix covers the open issues here, with your own agent. Bring back evidence for maintainers.

Open the Lab

At a glance

Subsystem
agent
Merged PRs
#101316
Closed issues
1
Attempts
2 PRs closed without merging
Fix link checked
2 Sep 2026

For your agent

The same facts, typed.