Timmy_Foundation/hermes-agent
15
0
Fork 0
Code Issues 277 Pull Requests 94 Actions 1 Packages Projects Releases Wiki Activity
4,334 Commits 593 Branches 3 Tags
93a855d4e3c31506e4b7d8a5151f4f03262385cd
Commit Graph

1 Commits

Author SHA1 Message Date
Alexander Whitestone
ab968e910c feat: tool fixation detection — break repetitive loops (#886)
Some checks failed
Contributor Attribution Check / check-attribution (pull_request) Failing after 37s
Details
Docker Build and Publish / build-and-push (pull_request) Has been skipped
Details
Supply Chain Audit / Scan PR for supply chain risks (pull_request) Successful in 43s
Details
Tests / e2e (pull_request) Successful in 1m57s
Details
Tests / test (pull_request) Failing after 18m57s
Details 
Marathon sessions show tool fixation: agent latches onto one tool
and calls it repeatedly. Observed streaks of 8-25 identical calls.

New agent/tool_fixation_detector.py:
- ToolFixationDetector: tracks consecutive tool calls
- record(tool_name): returns nudge prompt when threshold reached
- Default threshold: 5 consecutive calls (configurable via
  TOOL_FIXATION_THRESHOLD env var)
- Nudge prompt explains the fixation and suggests alternatives:
  1. Read error carefully
  2. Try different tool
  3. Ask user for clarification
  4. Check if task is complete
- get_streak_info(): current streak state
- format_report(): human-readable fixation events
- Singleton via get_fixation_detector()

Config:
- TOOL_FIXATION_THRESHOLD (default: 5)
- TOOL_FIXATION_WINDOW (default: 10)

Tests: tests/test_tool_fixation_detector.py (9 tests)

Closes #886
 2026-04-17 01:57:37 -04:00