hermes-agent/tests/agent/test_reasoning_stale_timeout_floor.py
DavidMetcalfe 27c486e3b1 feat(agent): apply per-reasoning-model stale-timeout floor in stream + non-stream detectors
Wire get_reasoning_stale_timeout_floor() into both stale detectors so known
reasoning models (Nemotron 3 Ultra, OpenAI o1/o3, Opus 4.x thinking, DeepSeek
R1, Qwen QwQ, Grok reasoning) tolerate multi-minute thinking phases instead of
the upstream gateway idle-killing the socket (BrokenPipeError) before first
token. Applied as max(default, floor) — never overrides explicit user config,
never lowers an existing threshold.

The reasoning_timeouts.py allowlist module already landed on main via #52795,
so this salvage carries only the wiring + tests (the duplicate module and the
stale-base MoA reverts from the original PR branch are dropped).

Salvaged from #52238. Fixes #52217.
2026-06-25 22:12:06 -07:00

373 lines
14 KiB
Python

"""Regression tests for the reasoning-model stale-timeout floor (issue #52217).
Reasoning models (Nemotron 3 Ultra, OpenAI o1/o3, Anthropic Opus 4.x
thinking, DeepSeek R1, Qwen QwQ, xAI Grok reasoning) routinely exceed
the 180s / 90s chat-model stale-timeout defaults during their
thinking phase. Hermes's default cloud-stream stale detector
(``HERMES_STREAM_STALE_TIMEOUT`` = 180s) and non-stream detector
(``HERMES_API_CALL_STALE_TIMEOUT`` = 90s) both fire before the
upstream proxy's idle timeout on a healthy reasoning stream. Result:
the user sees ``API call failed after 3 retries: [Errno 32] Broken
pipe`` for every Nemotron 3 Ultra turn.
These tests pin the floor's behavior:
1. ``get_reasoning_stale_timeout_floor`` returns the right floor for
every key in the allowlist, ``None`` for every negative case
(gpt-4o, olmo-1, etc.), and longest-substring-first wins on
shared prefixes (``o3-mini-`` > ``o3-``).
2. The non-stream resolver at
``run_agent.py:AIAgent._resolved_api_call_stale_timeout_base``
consults the floor at priority 4 (after explicit user config,
provider config, and env var; before the 90s default), and
returns ``uses_implicit_default=False`` so the local-endpoint
short-circuit in ``_compute_non_stream_stale_timeout`` does not
disable stale detection for a reasoning model running on a local
NIM endpoint.
3. The stream stale-timeout resolution (mirrored here as in
``test_stream_read_timeout_floor.py`` because the real builder
lives inside a worker thread) consults the floor after the
context-size scaling block, raising the timeout for reasoning
models without lowering it for non-reasoning models.
"""
from __future__ import annotations
from pathlib import Path
import pytest
# ── pure-function resolver ────────────────────────────────────────────────
@pytest.mark.parametrize("model,expected", [
# NVIDIA Nemotron reasoning family (longest keys first).
("nvidia/nemotron-3-ultra-550b-a55b", 600.0),
("nvidia/nemotron-3-super-120b-a12b", 600.0),
("nvidia/nemotron-3-nano-30b-a3b", 300.0),
# DeepSeek R1 + DeepSeek reasoner.
("deepseek/deepseek-r1", 600.0),
("deepseek/deepseek-r1-distill-llama-70b", 600.0),
("deepseek/deepseek-reasoner", 600.0),
# Qwen QwQ + Qwen3 thinking variants (qwen3 family entry matches all).
("qwen/qwq-32b-preview", 300.0),
("qwen/qwen3-235b-a22b-thinking", 180.0),
("qwen/qwen3-32b", 180.0),
# OpenAI o-series — each variant enumerated explicitly.
# Longest match wins (o3-mini beats o3 on shared prefix).
("openai/o1", 600.0),
("openai/o1-mini", 600.0),
("openai/o1-pro", 600.0),
("openai/o1-preview", 600.0),
("openai/o3", 600.0),
("openai/o3-pro", 600.0),
("openai/o3-mini", 300.0),
("openai/o4-mini", 300.0),
# Anthropic Claude 4.x thinking variants.
("anthropic/claude-opus-4-6", 240.0),
("anthropic/claude-opus-4-20250514", 240.0),
("anthropic/claude-sonnet-4.5", 180.0),
("anthropic/claude-sonnet-4.6", 180.0),
# xAI Grok reasoning variants — explicit, not bare `grok`.
("x-ai/grok-4-fast-reasoning", 300.0),
("x-ai/grok-4.20-reasoning", 300.0),
("x-ai/grok-4-fast-non-reasoning", 180.0),
])
def test_reasoning_stale_timeout_floor_positive_cases(model, expected):
from agent.reasoning_timeouts import get_reasoning_stale_timeout_floor
assert get_reasoning_stale_timeout_floor(model) == expected, (
f"get_reasoning_stale_timeout_floor({model!r}) should return "
f"{expected}; bare substrings and shared prefixes must not "
f"over-match community derivatives."
)
@pytest.mark.parametrize("model", [
# Non-reasoning chat models — no floor.
"gpt-4o",
"gpt-5",
"claude-3-5-sonnet-20240620",
"llama-3.3-70b-instruct",
"gemini-2.5-pro",
# Start-of-slug anchor traps — the slug must be at the START of
# the bare model name (after aggregator-prefix strip). Bare
# substring matching would over-match these.
"olmo-1",
"olmo-13b",
"llama-4-70b-o1-preview", # embedded `o1-preview`, NOT start of slug
"some-model-o3-mini-fork", # embedded `o3-mini`, NOT start of slug
# Bare "grok" must not over-match non-reasoning Grok SKUs.
"x-ai/grok-3",
"x-ai/grok-4",
"x-ai/grok-4-0709",
"x-ai/grok-code-fast-1",
# Qwen2 must not match Qwen3 (different family).
"qwen2-72b-instruct",
# Empty / None / non-string inputs — must return None, not raise.
"",
None,
12345,
[],
])
def test_reasoning_stale_timeout_floor_negative_cases(model):
from agent.reasoning_timeouts import get_reasoning_stale_timeout_floor
assert get_reasoning_stale_timeout_floor(model) is None, (
f"get_reasoning_stale_timeout_floor({model!r}) must return None "
f"for non-reasoning models and start-of-slug-anchor traps."
)
def test_longest_substring_wins_on_shared_prefix():
"""`o3-mini` must beat `o3` so the smaller floor applies."""
from agent.reasoning_timeouts import get_reasoning_stale_timeout_floor
# o3-mini (7 chars) wins over o3 (2 chars) on shared prefix.
assert get_reasoning_stale_timeout_floor("openai/o3-mini") == 300.0
assert get_reasoning_stale_timeout_floor("openai/o3") == 600.0
# Even with deep aggregator prefix chains the model name resolves
# correctly (start-of-slug anchor + rsplit('/') strip).
assert get_reasoning_stale_timeout_floor("openrouter/openai/o3-mini") == 300.0
assert get_reasoning_stale_timeout_floor("openrouter/anthropic/claude-opus-4-6") == 240.0
# ── integration: _resolved_api_call_stale_timeout_base ─────────────────────
def _write_config(tmp_path: Path, body: str) -> None:
(tmp_path / "config.yaml").write_text(body or "{}\n", encoding="utf-8")
def _make_agent(tmp_path: Path, **overrides):
from run_agent import AIAgent
kwargs = dict(
model="gpt-5.5",
provider="openai-codex",
api_key="sk-dummy",
base_url="https://chatgpt.com/backend-api/codex",
quiet_mode=True,
skip_context_files=True,
skip_memory=True,
platform="cli",
)
kwargs.update(overrides)
return AIAgent(**kwargs)
def test_reasoning_floor_applies_to_nemotron_3_ultra(monkeypatch, tmp_path):
"""Nemotron 3 Ultra without explicit config gets the 600s floor."""
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
(tmp_path / ".env").write_text("", encoding="utf-8")
monkeypatch.delenv("HERMES_API_CALL_STALE_TIMEOUT", raising=False)
_write_config(tmp_path, "")
# Clear any cached config from prior tests in this session.
import importlib
from hermes_cli import config as cfg_mod, timeouts as to_mod
importlib.reload(cfg_mod)
importlib.reload(to_mod)
agent = _make_agent(
tmp_path,
provider="nvidia",
base_url="https://integrate.api.nvidia.com/v1",
model="nvidia/nemotron-3-ultra-550b-a55b",
)
base, implicit = agent._resolved_api_call_stale_timeout_base()
assert base == 600.0
assert implicit is False, (
"Reasoning-model floor must return uses_implicit_default=False "
"so the local-endpoint short-circuit in "
"_compute_non_stream_stale_timeout does not disable detection "
"for users running reasoning models on a local NIM endpoint."
)
def test_reasoning_floor_applies_to_opus_4_thinking(monkeypatch, tmp_path):
"""Anthropic Opus 4.x thinking gets the 240s floor without explicit config."""
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
(tmp_path / ".env").write_text("", encoding="utf-8")
monkeypatch.delenv("HERMES_API_CALL_STALE_TIMEOUT", raising=False)
_write_config(tmp_path, "")
import importlib
from hermes_cli import config as cfg_mod, timeouts as to_mod
importlib.reload(cfg_mod)
importlib.reload(to_mod)
agent = _make_agent(
tmp_path,
provider="anthropic",
base_url="https://api.anthropic.com",
model="claude-opus-4-6",
)
base, implicit = agent._resolved_api_call_stale_timeout_base()
assert base == 240.0
assert implicit is False
def test_reasoning_floor_never_overrides_explicit_user_config(monkeypatch, tmp_path):
"""Explicit per-model stale_timeout_seconds wins over the floor.
Regression guard for the invariant: explicit user config > reasoning
floor > env var > default. If a user sets stale_timeout_seconds: 60
on Nemotron 3 Ultra, that's what fires — even though the floor
would otherwise be 600s.
"""
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
(tmp_path / ".env").write_text("", encoding="utf-8")
_write_config(tmp_path, """\
providers:
nvidia:
models:
nvidia/nemotron-3-ultra-550b-a55b:
stale_timeout_seconds: 60
""")
monkeypatch.delenv("HERMES_API_CALL_STALE_TIMEOUT", raising=False)
import importlib
from hermes_cli import config as cfg_mod, timeouts as to_mod
importlib.reload(cfg_mod)
importlib.reload(to_mod)
agent = _make_agent(
tmp_path,
provider="nvidia",
base_url="https://integrate.api.nvidia.com/v1",
model="nvidia/nemotron-3-ultra-550b-a55b",
)
base, implicit = agent._resolved_api_call_stale_timeout_base()
assert base == 60.0, (
"Explicit user stale_timeout_seconds must override the "
"reasoning-model floor; the user knows their environment."
)
assert implicit is False
def test_reasoning_floor_loses_to_env_var_when_no_floor_match(monkeypatch, tmp_path):
"""For a non-reasoning model, env var still wins over the 90s default."""
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
(tmp_path / ".env").write_text("", encoding="utf-8")
monkeypatch.setenv("HERMES_API_CALL_STALE_TIMEOUT", "300")
_write_config(tmp_path, "")
import importlib
from hermes_cli import config as cfg_mod, timeouts as to_mod
importlib.reload(cfg_mod)
importlib.reload(to_mod)
agent = _make_agent(
tmp_path,
provider="openai",
base_url="https://api.openai.com/v1",
model="gpt-5.5", # not in the floor allowlist
)
base, implicit = agent._resolved_api_call_stale_timeout_base()
assert base == 300.0
assert implicit is False
def test_non_reasoning_model_keeps_default(monkeypatch, tmp_path):
"""GPT-5 (non-reasoning) without env var / config -> 90s default, implicit."""
monkeypatch.setenv("HERMES_HOME", str(tmp_path))
(tmp_path / ".env").write_text("", encoding="utf-8")
monkeypatch.delenv("HERMES_API_CALL_STALE_TIMEOUT", raising=False)
_write_config(tmp_path, "")
import importlib
from hermes_cli import config as cfg_mod, timeouts as to_mod
importlib.reload(cfg_mod)
importlib.reload(to_mod)
agent = _make_agent(
tmp_path,
provider="openai",
base_url="https://api.openai.com/v1",
model="gpt-5.5",
)
base, implicit = agent._resolved_api_call_stale_timeout_base()
assert base == 90.0
assert implicit is True
# ── stream-side mirror (the real builder lives in a worker thread) ────────
def _resolve_stream_stale_timeout(
model: str | None,
base_url: str,
est_tokens: int,
stale_base: float = 180.0,
) -> float:
"""Mirror of the stale-stream resolution in agent/chat_completion_helpers.py.
Kept in lockstep with the production code at lines 2539-2575 of
agent/chat_completion_helpers.py. When that block changes, this
mirror must change too — the failing-test signal is the divergence.
"""
from agent.model_metadata import is_local_endpoint
from agent.reasoning_timeouts import get_reasoning_stale_timeout_floor
# Provider-configured stale timeout wins (mirrors get_provider_stale_timeout).
if stale_base != 180.0:
pass # In production this is sourced from config; here we parameterize.
if stale_base == 180.0 and base_url and is_local_endpoint(base_url):
return float("inf")
if est_tokens > 100_000:
timeout = max(stale_base, 300.0)
elif est_tokens > 50_000:
timeout = max(stale_base, 240.0)
else:
timeout = stale_base
# Reasoning-model floor (the new branch this PR adds).
floor = get_reasoning_stale_timeout_floor(model)
if floor is not None:
timeout = max(timeout, floor)
return timeout
def test_stream_stale_timeout_floor_for_nemotron_3_ultra():
"""Small-context Nemotron 3 Ultra without explicit config -> 600s floor.
Without the floor, this would be 180s (the default), which is shorter
than NVIDIA NIM's ~120s upstream idle kill — guaranteeing broken pipe.
"""
timeout = _resolve_stream_stale_timeout(
model="nvidia/nemotron-3-ultra-550b-a55b",
base_url="https://integrate.api.nvidia.com/v1",
est_tokens=10_000,
)
assert timeout == 600.0
def test_stream_stale_timeout_floor_never_lowers_existing():
"""The floor raises; it never lowers the existing context-size tier."""
# 120k-token conversation on a reasoning model -> context tier already
# raises to 300s; floor (600s) takes it to 600s.
timeout = _resolve_stream_stale_timeout(
model="nvidia/nemotron-3-ultra-550b-a55b",
base_url="https://integrate.api.nvidia.com/v1",
est_tokens=120_000,
)
assert timeout == 600.0
# 60k tokens on Opus 4 -> context tier raises to 240s; floor keeps 240s.
timeout = _resolve_stream_stale_timeout(
model="anthropic/claude-opus-4-6",
base_url="https://api.anthropic.com",
est_tokens=60_000,
)
assert timeout == 240.0
def test_stream_stale_timeout_unchanged_for_non_reasoning_models():
"""gpt-4o on a small context still gets the 180s default — no behavior change."""
timeout = _resolve_stream_stale_timeout(
model="gpt-4o",
base_url="https://api.openai.com/v1",
est_tokens=5_000,
)
assert timeout == 180.0