test(agent): trim the restart-bound tests to two invariants

Collapse the four class-based tests into two parametrized invariants over both
refunding restart flags and move them to tests/agent/ (the phase modules live in
agent/): a single restart still refunds-and-continues; a re-armed restart breaks
after max_retries refunds. The stub grows the redirect seam the follow-up commit
uses so the queued-correction contract is covered by the same test.
This commit is contained in:
Teknium
2026-09-09 05:04:36 -07:00
parent e9312da68b
commit b24a781b6f
3 changed files with 68 additions and 130 deletions
@@ -0,0 +1,2 @@
yoyodine-industries
# PR #106110 salvage
+66
View File
@@ -0,0 +1,66 @@
"""``apply_retry_restarts`` bounds the refunding restarts (#106108).
The redirect and rebuilt-for-fallback paths refund the iteration budget and re-issue the
iteration; nothing else in the turn loop counts them, so a flag that keeps re-arming
(a request cancelled on every attempt) refunded forever and held the turn lease.
"""
from __future__ import annotations
from types import SimpleNamespace
import pytest
from agent.turn_iteration_prep import apply_retry_restarts
from agent.turn_retry_state import TurnRetryState
RESTART_FLAGS = ["restart_with_redirected_messages", "restart_with_rebuilt_messages"]
MAX_RETRIES = 3
def _apply(agent, flag: str, restart_count: int):
_retry = TurnRetryState()
setattr(_retry, flag, True)
return apply_retry_restarts(
agent, _retry=_retry, response=None, interrupted=False, messages=[],
conversation_history=[], user_message="hi", api_kwargs={}, current_turn_user_idx=0,
final_response=None, retry_count=0, max_retries=MAX_RETRIES, api_call_count=1,
restart_count=restart_count, length_continue_retries=0,
_preflight_compression_blocked=True, _turn_exit_reason="unknown",
)
def _agent():
budget = SimpleNamespace(refunds=0)
budget.refund = lambda: setattr(budget, "refunds", budget.refunds + 1)
agent = SimpleNamespace(iteration_budget=budget, steered=[])
agent._drain_pending_redirect = lambda: "last correction"
agent.steer = agent.steered.append
return agent
@pytest.mark.parametrize("flag", RESTART_FLAGS)
def test_single_restart_still_reissues_the_iteration(flag):
"""A lone correction / fallback activation keeps its refund-and-continue contract."""
agent = _agent()
verdict = _apply(agent, flag, restart_count=0)
assert verdict.action == "continue"
assert (agent.iteration_budget.refunds, verdict.api_call_count) == (1, 0)
if flag == "restart_with_rebuilt_messages":
assert verdict._preflight_compression_blocked is False # still the single consumer
@pytest.mark.parametrize("flag", RESTART_FLAGS)
def test_restart_refunds_are_bounded_per_turn(flag):
"""Re-arming the flag every iteration breaks after ``max_retries`` refunds instead of
refunding forever (the turn ends, so the session turn lease is released)."""
agent = _agent()
restart_count, verdicts = 0, []
while len(verdicts) < MAX_RETRIES + 5 and (not verdicts or verdicts[-1].action != "break"):
verdicts.append(_apply(agent, flag, restart_count))
restart_count = verdicts[-1].restart_count
assert [v.action for v in verdicts] == ["continue"] * MAX_RETRIES + ["break"]
assert agent.iteration_budget.refunds == MAX_RETRIES
assert verdicts[-1]._turn_exit_reason.endswith("restart_limit_exceeded")
# The correction that tripped the redirect cap is handed back as the next user turn.
assert agent.steered == (["last correction"] if flag == "restart_with_redirected_messages" else [])
-130
View File
@@ -1,130 +0,0 @@
"""Bound the refunding restart paths so a runaway turn cannot hold the turn lease.
``apply_retry_restarts`` has three restart paths that refund the iteration
budget and re-issue the iteration. The redirect and rebuilt-for-fallback paths
were unbounded: a runaway interrupt/redirect that keeps re-arming the restart
flag refunded the budget forever, so the turn loop never exited, the durable
turn lease (``turn_facade_lease.py``) never released in the ``finally`` block,
and concurrent processes blocked on the lease for up to ``LEASE_WAIT_SECONDS``.
The compression path was already capped (via the shared per-turn
``compression_attempts`` backstop); this change gives redirect and rebuilt the
same treatment with a per-turn ``restart_count`` accumulator capped at
``max_retries`` (the retry-loop bound).
These tests assert the *behavior contract* — a repeated restart eventually
``break`` s instead of refunding forever — by driving ``apply_retry_restarts``
directly. No source inspection.
"""
from __future__ import annotations
from types import SimpleNamespace
from agent.turn_iteration_prep import apply_retry_restarts
from agent.turn_retry_state import TurnRetryState
class _RefundBudget:
"""Minimal iteration budget that counts refunds (the runaway signal)."""
def __init__(self) -> None:
self.refund_count = 0
def refund(self) -> None:
self.refund_count += 1
def _apply(agent, _retry, restart_count: int):
"""Invoke ``apply_retry_restarts`` with a minimal loop-locals payload."""
return apply_retry_restarts(
agent,
_retry=_retry,
response=None,
interrupted=False,
messages=[],
conversation_history=[],
user_message="hi",
api_kwargs={},
current_turn_user_idx=0,
final_response=None,
retry_count=0,
max_retries=agent._api_max_retries,
api_call_count=1,
restart_count=restart_count,
length_continue_retries=0,
_preflight_compression_blocked=False,
_turn_exit_reason="unknown",
)
def _make_agent(max_retries: int) -> SimpleNamespace:
return SimpleNamespace(iteration_budget=_RefundBudget(), _api_max_retries=max_retries)
def _drive_repeated_restart(agent, arm):
"""Re-arm one restart flag every iteration, threading ``restart_count`` back in."""
restart_count = 0
actions = []
reasons = []
for _ in range(agent._api_max_retries + 5):
_retry = TurnRetryState()
arm(_retry)
verdict = _apply(agent, _retry, restart_count=restart_count)
restart_count = verdict.restart_count
actions.append(verdict.action)
reasons.append(verdict._turn_exit_reason)
if verdict.action == "break":
break
return actions, reasons
class TestRedirectRestartBound:
def test_single_redirect_restart_still_continues(self):
"""A lone user correction must still re-issue the iteration (one refund)."""
agent = _make_agent(max_retries=3)
_retry = TurnRetryState()
_retry.restart_with_redirected_messages = True
verdict = _apply(agent, _retry, restart_count=0)
assert verdict.action == "continue"
assert agent.iteration_budget.refund_count == 1
def test_repeated_redirect_restarts_break_after_bounded_count(self):
"""A runaway redirect must break instead of refunding forever."""
agent = _make_agent(max_retries=3)
actions, reasons = _drive_repeated_restart(
agent, lambda r: setattr(r, "restart_with_redirected_messages", True)
)
assert "break" in actions, "redirect restarts must eventually break, not refund forever"
# Exactly ``max_retries`` refunds are allowed before the cap trips.
assert actions.count("continue") == agent._api_max_retries
assert agent.iteration_budget.refund_count == agent._api_max_retries
assert reasons[-1] == "redirect_restart_limit_exceeded"
class TestRebuiltRestartBound:
def test_single_rebuilt_restart_still_continues(self):
"""A lone fallback activation must still re-issue the iteration (one refund)."""
agent = _make_agent(max_retries=3)
_retry = TurnRetryState()
_retry.restart_with_rebuilt_messages = True
verdict = _apply(agent, _retry, restart_count=0)
assert verdict.action == "continue"
assert agent.iteration_budget.refund_count == 1
# The single consumer still clears the preflight block for the fallback.
assert verdict._preflight_compression_blocked is False
def test_repeated_rebuilt_restarts_break_after_bounded_count(self):
"""A stall that keeps re-escalating to fallback must break, not refund forever."""
agent = _make_agent(max_retries=3)
actions, reasons = _drive_repeated_restart(
agent, lambda r: setattr(r, "restart_with_rebuilt_messages", True)
)
assert "break" in actions, "rebuilt restarts must eventually break, not refund forever"
assert actions.count("continue") == agent._api_max_retries
assert agent.iteration_budget.refund_count == agent._api_max_retries
assert reasons[-1] == "rebuilt_restart_limit_exceeded"