Files
hermes-agent/agent/repetition_guard.py
teknium1 55a26c9983 fix: only drop an interrupted partial for the runaway repetition shape
is_repetition_dominated is tuned for the truncated-continuation nudge, where a
false positive merely skips a continuation. At the interrupt checkpoints the
same verdict DROPS the partial from history and tells the model the reply
degenerated, so a legitimately repetitive but correct reply - twelve distinct
INSERT rows sharing a long prefix trip the 60-char window scan - was erased and
mislabelled. Gate the two checkpoints on is_runaway_repetition: dominated AND,
when the text has line structure, at most half of its non-empty lines distinct.
Byte-identical repeated lines (the #112764 shape) still qualify; distinct batch
rows no longer do. The continuation path keeps the looser predicate.

The plain interrupt site now mirrors the redirect placeholder (empty content,
display_kind=hidden, api_content=[response interrupted]) so the bracketed
placeholder no longer surfaces as an assistant bubble in transcript replays.
2026-09-16 17:10:13 -07:00

89 lines
4.2 KiB
Python

"""Cheap content-sanity checks for the truncated-response continuation path.
A model in a degenerate repetition loop can spend its ENTIRE output budget echoing one fragment;
the ``finish_reason=length`` continuation would then stitch it into the final response with a
"continue" nudge (one incident: a 60k-char turn delivered as 31 Discord messages). This detects
repetition-dominated fragments BEFORE the nudge so the turn aborts with a clear error. Deliberately
conservative: only LONG verbatim repeats (60+ chars) covering a majority of the fragment trip it.
"""
from __future__ import annotations
import math
from collections import Counter
# Below this length the check doesn't run: short truncations trivially
# contain repeated tokens and are legitimately continued.
MIN_FRAGMENT_LENGTH = 400
# Exact-repeat window; far beyond ordinary phrasing reuse (citations, headings, similar code).
_REPEAT_WINDOW = 60
# A window repeating at least this often is a signal even for short fragments.
_MIN_REPEAT_COUNT = 5
# "Repetition-dominated" = repeated windows cover at least this fraction.
_DOMINANCE_RATIO = 0.5
# What an interrupt checkpoint says INSTEAD of a repetition-dominated partial. Replaying the
# looped bytes (as the redirect's api_content or as the interrupted assistant row) re-seeds the
# loop on the next request and the corruption survives restarts (#112764); the model only needs
# to know the reply degenerated and was cut off.
REPETITION_LOOP_INTERRUPTED = "[the reply degenerated into a repetition loop and was interrupted]"
# ``is_runaway_repetition``: a multi-line partial must be mostly copies of a few lines. Batch-style
# output (distinct INSERT rows, similar table rows) shares long prefixes and trips the window
# scan, but every line is distinct; a loop re-emits the same line(s).
_RUNAWAY_DISTINCT_LINE_RATIO = 0.5
def is_repetition_dominated(text: str) -> bool:
"""True when a single 60+ char substring recurs often enough to cover at least half
of ``text`` — the signature of a repetition loop. Fail-open for non-string/short input.
That shape is the signature of a model repetition loop (issue #86581), and continuing such a fragment is
pointless — the continuation nudge would just stitch more repeated text into the final response.
"""
if not isinstance(text, str):
return False
n = len(text)
if n < MIN_FRAGMENT_LENGTH:
return False
# Fast path: one normalized line duplicated enough to cover half the fragment (the common echo shape).
if _line_repetition_dominated(text, n):
return True
# General path: fixed-size windows sliding one char at a time, catching loops that
# don't align to line boundaries. A window must appear ``needed`` times to cover
# >= _DOMINANCE_RATIO (and >= _MIN_REPEAT_COUNT).
window = _REPEAT_WINDOW
needed = max(_MIN_REPEAT_COUNT, math.ceil(n * _DOMINANCE_RATIO / window))
counts: dict[str, int] = {}
for i in range(n - window + 1):
key = text[i : i + window]
c = counts.get(key, 0) + 1
if c >= needed:
return True
counts[key] = c
return False
def is_runaway_repetition(text: str) -> bool:
"""Stricter than :func:`is_repetition_dominated`: also require the runaway shape.
An interrupt checkpoint DROPS the partial when this fires, so a legitimately repetitive but
correct reply (distinct batch rows) must not qualify: repeated windows have to dominate AND,
when the text has line structure, at most half of its non-empty lines may be distinct.
"""
if not is_repetition_dominated(text):
return False
lines = [line.strip() for line in text.splitlines()]
lines = [line for line in lines if line]
if len(lines) < _MIN_REPEAT_COUNT:
return True # no line structure to judge by: a dominated single-line loop
return len(set(lines)) <= len(lines) * _RUNAWAY_DISTINCT_LINE_RATIO
def _line_repetition_dominated(text: str, n: int) -> bool:
"""True when a single normalized line covers half the fragment via repeats."""
counts = Counter(norm for norm in (line.strip() for line in text.splitlines()) if norm)
return any(c >= _MIN_REPEAT_COUNT and c * len(line) >= n * _DOMINANCE_RATIO for line, c in counts.items())