An organization with no fast allocation for a model gets a 429 whose anthropic-fast-*-tokens-limit header is 0, with no retry-after. Hermes treated it as a rate limit: backoff, credential rotation that benched a key that works at standard speed, then provider fallback, so /fast failed every turn. The pre-classification recovery now stops sending `speed` to that model for the rest of the session and retries once. A 429 with a real fast limit still takes the retry-after path.
197 lines
9.1 KiB
Python
197 lines
9.1 KiB
Python
"""Bounded /fast auto|cold windows and the shared route-aware gate."""
|
|
|
|
from types import SimpleNamespace
|
|
|
|
from agent import fast_mode
|
|
|
|
|
|
def _agent(**kw):
|
|
base = dict(
|
|
service_tier="auto",
|
|
model="gpt-5.4",
|
|
provider="openai",
|
|
base_url="https://api.openai.com/v1",
|
|
api_mode="chat_completions",
|
|
request_overrides={"extra_body": {"keep": 1}},
|
|
fast_auto_seconds=60,
|
|
)
|
|
base.update(kw)
|
|
return SimpleNamespace(**base)
|
|
|
|
|
|
def test_bounded_fast_window_policy(monkeypatch):
|
|
clock = [1000.0]
|
|
monkeypatch.setattr(fast_mode.time, "monotonic", lambda: clock[0])
|
|
|
|
# auto: window open -> fast override layered over existing overrides
|
|
agent = _agent()
|
|
fast_mode.begin_turn(agent, conversation_history=[])
|
|
assert fast_mode.effective_request_overrides(agent) == {
|
|
"extra_body": {"keep": 1},
|
|
"service_tier": "priority",
|
|
}
|
|
assert agent.request_overrides == {"extra_body": {"keep": 1}} # never mutated
|
|
|
|
# window expired -> override absent
|
|
clock[0] += 61
|
|
assert fast_mode.effective_request_overrides(agent) == {"extra_body": {"keep": 1}}
|
|
|
|
# auto re-opens on the next turn
|
|
fast_mode.begin_turn(agent, conversation_history=[{"role": "user", "content": "x"}])
|
|
assert "service_tier" in fast_mode.effective_request_overrides(agent)
|
|
|
|
# cold: prior history -> no window at all
|
|
cold = _agent(service_tier="cold")
|
|
fast_mode.begin_turn(cold, conversation_history=[{"role": "user", "content": "x"}])
|
|
assert "service_tier" not in fast_mode.effective_request_overrides(cold)
|
|
fast_mode.begin_turn(cold, conversation_history=None)
|
|
assert fast_mode.effective_request_overrides(cold)["service_tier"] == "priority"
|
|
|
|
# Anthropic route uses the speed param
|
|
anth = _agent(
|
|
service_tier="auto",
|
|
model="claude-opus-5",
|
|
provider="anthropic",
|
|
base_url="https://api.anthropic.com",
|
|
api_mode="anthropic_messages",
|
|
)
|
|
fast_mode.begin_turn(anth, conversation_history=[])
|
|
assert fast_mode.effective_request_overrides(anth)["speed"] == "fast"
|
|
|
|
# unsupported routes never get fast params, in auto or static mode
|
|
from hermes_cli.models import resolve_fast_mode_overrides
|
|
|
|
for provider, base_url in (
|
|
("openrouter", "https://openrouter.ai/api/v1"),
|
|
("nous", "https://inference-api.nousresearch.com/v1"),
|
|
("copilot", "https://api.githubcopilot.com"),
|
|
("azure", "https://foo.openai.azure.com"),
|
|
("custom", "http://10.0.0.1:8000/v1"),
|
|
("openai", "https://proxy.example.com/v1"),
|
|
):
|
|
proxied = _agent(provider=provider, base_url=base_url)
|
|
fast_mode.begin_turn(proxied, conversation_history=[])
|
|
assert "service_tier" not in fast_mode.effective_request_overrides(proxied), provider
|
|
assert resolve_fast_mode_overrides("gpt-5.4", provider=provider, base_url=base_url) is None
|
|
assert resolve_fast_mode_overrides(
|
|
"claude-opus-5", provider="bedrock", base_url="https://bedrock-runtime.us-east-1.amazonaws.com"
|
|
) is None
|
|
# first-party routes (and the legacy model-only call) still resolve
|
|
assert resolve_fast_mode_overrides("gpt-5.4", provider="openai-codex", base_url="https://chatgpt.com/backend-api/codex")
|
|
assert resolve_fast_mode_overrides("grok-4.6", provider="xai", base_url="https://api.x.ai/v1")
|
|
assert resolve_fast_mode_overrides("gpt-5.4") == {"service_tier": "priority"}
|
|
|
|
# normal / static modes are untouched by the window logic
|
|
static = _agent(service_tier="priority", request_overrides={"service_tier": "priority"})
|
|
fast_mode.begin_turn(static, conversation_history=[])
|
|
assert fast_mode.effective_request_overrides(static) == {"service_tier": "priority"}
|
|
off = _agent(service_tier=None)
|
|
fast_mode.begin_turn(off, conversation_history=[])
|
|
assert fast_mode.effective_request_overrides(off) == {"extra_body": {"keep": 1}}
|
|
|
|
|
|
def test_fast_auto_and_cold_parse_and_slash_command(monkeypatch):
|
|
import hermes_cli.config as config_mod
|
|
|
|
if not hasattr(config_mod, "save_env_value_secure"):
|
|
config_mod.save_env_value_secure = lambda key, value: {"success": True}
|
|
import cli as cli_mod
|
|
from gateway.run import GatewayRunner
|
|
from hermes_cli.commands import COMMAND_REGISTRY
|
|
from hermes_cli.config import DEFAULT_CONFIG
|
|
|
|
# config parsing: CLI, gateway, TUI all accept auto/cold; default stays off
|
|
for raw, expected in (("auto", "auto"), ("COLD", "cold"), ("fast", "priority"), ("", None), ("bogus", None)):
|
|
assert cli_mod._parse_service_tier_config(raw) == expected
|
|
monkeypatch.setattr(
|
|
"gateway.run._load_gateway_config", lambda: {"agent": {"service_tier": raw}}
|
|
)
|
|
assert GatewayRunner._load_service_tier() == expected
|
|
assert DEFAULT_CONFIG["agent"]["service_tier"] == ""
|
|
assert DEFAULT_CONFIG["agent"]["fast_auto_seconds"] == 60
|
|
|
|
# /fast auto — session-scoped, agent rebuilt, status reports the mode
|
|
fast_cmd = next(c for c in COMMAND_REGISTRY if c.name == "fast")
|
|
assert {"auto", "cold"} <= set(fast_cmd.subcommands)
|
|
printed = []
|
|
monkeypatch.setattr(cli_mod, "_cprint", lambda *a, **k: printed.append(" ".join(map(str, a))))
|
|
monkeypatch.setattr(cli_mod, "save_config_value", lambda *a, **k: (_ for _ in ()).throw(AssertionError("no config write")))
|
|
stub = SimpleNamespace(
|
|
service_tier=None, model="gpt-5.4", agent=object(), _fast_command_available=lambda: True
|
|
)
|
|
cli_mod.HermesCLI._handle_fast_command(stub, "/fast auto")
|
|
assert stub.service_tier == "auto"
|
|
assert stub.agent is None
|
|
cli_mod.HermesCLI._handle_fast_command(stub, "/fast status")
|
|
assert any("auto" in line for line in printed)
|
|
cli_mod.HermesCLI._handle_fast_command(stub, "/fast cold")
|
|
assert stub.service_tier == "cold"
|
|
|
|
# auto/cold do NOT pin a static override into the turn route
|
|
route_stub = SimpleNamespace(
|
|
model="gpt-5.4", api_key="k", base_url="https://api.openai.com/v1", provider="openai",
|
|
api_mode="chat_completions", acp_command=None, acp_args=[], _credential_pool=None,
|
|
service_tier="auto",
|
|
)
|
|
assert cli_mod.HermesCLI._resolve_turn_agent_config(route_stub, "hi")["request_overrides"] is None
|
|
route_stub.service_tier = "priority"
|
|
assert cli_mod.HermesCLI._resolve_turn_agent_config(route_stub, "hi")["request_overrides"] == {
|
|
"service_tier": "priority"
|
|
}
|
|
route_stub.base_url = "https://openrouter.ai/api/v1"
|
|
route_stub.provider = "openrouter"
|
|
assert cli_mod.HermesCLI._resolve_turn_agent_config(route_stub, "hi")["request_overrides"] is None
|
|
|
|
|
|
class _FastRateLimitError(Exception):
|
|
"""A fast-mode 429 shaped like the live API's: documented limit headers, no retry-after."""
|
|
|
|
def __init__(self, limit="0"):
|
|
super().__init__("This request would exceed your organization's rate limit of 0 fast mode input tokens per minute.")
|
|
self.status_code = 429
|
|
self.body = {"type": "error", "error": {"type": "rate_limit_error", "message": str(self)}}
|
|
self.response = SimpleNamespace(headers={
|
|
"anthropic-fast-input-tokens-limit": limit, "anthropic-fast-output-tokens-limit": limit,
|
|
})
|
|
|
|
|
|
_FAST_KWARGS = {"model": "claude-opus-5", "extra_body": {"speed": "fast"}}
|
|
|
|
|
|
def test_unprovisioned_detects_only_zero_limit_fast_429s():
|
|
assert fast_mode.fast_mode_unprovisioned(_FastRateLimitError("0"), _FAST_KWARGS) is True
|
|
# A real limit that ran out is transient: the retry-after path handles it.
|
|
assert fast_mode.fast_mode_unprovisioned(_FastRateLimitError("2000000"), _FAST_KWARGS) is False
|
|
# The request has to have asked for fast speed.
|
|
assert fast_mode.fast_mode_unprovisioned(_FastRateLimitError("0"), {"model": "claude-opus-5"}) is False
|
|
assert fast_mode.fast_mode_unprovisioned(RuntimeError("boom"), _FAST_KWARGS) is False
|
|
|
|
|
|
def test_unavailable_model_drops_speed_for_the_session_and_only_that_model():
|
|
agent = _agent(
|
|
service_tier="priority", model="claude-opus-5", provider="anthropic",
|
|
api_mode="anthropic_messages", request_overrides={"speed": "fast"},
|
|
)
|
|
assert fast_mode.effective_request_overrides(agent) == {"speed": "fast"}
|
|
assert fast_mode.mark_fast_mode_unavailable(agent) is True
|
|
assert fast_mode.mark_fast_mode_unavailable(agent) is False # one retry per model
|
|
assert fast_mode.effective_request_overrides(agent) == {}
|
|
agent.model = "claude-opus-5-5"
|
|
assert fast_mode.effective_request_overrides(agent) == {"speed": "fast"}
|
|
|
|
|
|
def test_recovery_retries_at_standard_speed_before_classification():
|
|
from agent.turn_recovery import recover_before_classification
|
|
|
|
printed = []
|
|
agent = SimpleNamespace(
|
|
model="claude-opus-5", provider="anthropic", log_prefix="", _fast_mode_unavailable_models=set(),
|
|
_vprint=lambda *a, **k: printed.append(" ".join(str(x) for x in a)),
|
|
)
|
|
retry, prompt = recover_before_classification(
|
|
agent, _FastRateLimitError("0"), messages=[], api_messages=[], api_kwargs=_FAST_KWARGS, active_system_prompt="sys",
|
|
)
|
|
assert (retry, prompt) == (True, "sys")
|
|
assert agent._fast_mode_unavailable_models == {"claude-opus-5"}
|
|
assert any("standard speed" in line for line in printed)
|