Your lightweight open-source personal agent.
Python agent-frameworkai-agentai-agentschatbotchatopsdiscord-botllm-agentsllmslocal-llmmcpmodel-context-protocolmulti-agentopenai-compatibleopenclawpersonal-ai-assistantpythonself-hostedtelegram-bot-ai-assistantwebuiworkflow-automation
fix(anthropic): support Opus 5 effort controls (#5236)
chengyongru4e8702a47bbf
diff --git a/nanobot/config/schema.py b/nanobot/config/schema.pyindex 965f0514c..83f6aa46e 100644--- a/nanobot/config/schema.py+++ b/nanobot/config/schema.py@@ -139,7 +139,7 @@ class AgentDefaults(Base):validation_alias=AliasChoices("toolHintMaxLength"),serialization_alias="toolHintMaxLength",) # Max characters for tool hint display (e.g. "$ cd …/project && npm test")- reasoning_effort: str | None = None # low / medium / high / adaptive / none — LLM thinking effort; None preserves the provider default+ reasoning_effort: str | None = None # low / medium / high / xhigh / max / adaptive / none — LLM thinking effort; None preserves the provider defaulttimezone: str = "UTC" # IANA timezone, e.g. "Asia/Shanghai", "America/New_York"bot_name: str = "nanobot" # Display name shown in CLI prompts (e.g. "{name} is thinking...")bot_icon: str = "🐈" # Short icon (emoji or text) shown next to the bot name in CLI; "" to omitdiff --git a/nanobot/providers/anthropic_provider.py b/nanobot/providers/anthropic_provider.pyindex 943a46038..6e24b4ba4 100644--- a/nanobot/providers/anthropic_provider.py+++ b/nanobot/providers/anthropic_provider.py@@ -31,6 +31,36 @@ def _gen_tool_id() -> str:_VALID_TOOL_ID = re.compile(r"^[a-zA-Z0-9_-]+$")+_CLAUDE_MODEL_VERSION = re.compile(+ r"claude-(?P<family>[a-z]+)-(?P<major>\d+)"+ r"(?:-(?P<minor>\d{1,2})(?=-|$))?"+)+_ADAPTIVE_ONLY_MIN_VERSIONS = {+ "opus": (4, 7),+ "sonnet": (5, 0),+ "fable": (5, 0),+ "mythos": (5, 0),+}+_THINKING_DISABLE_MIN_VERSIONS = {+ "opus": (5, 0),+ "sonnet": (5, 0),+}+_SAMPLING_DEPRECATED_MODELS = {"claude-mythos-preview"}+++def _model_version_at_least(+ model_name: str,+ minimum_versions: dict[str, tuple[int, int]],+) -> bool:+ match = _CLAUDE_MODEL_VERSION.search(model_name.lower())+ if match is None:+ return False+ minimum = minimum_versions.get(match.group("family"))+ if minimum is None:+ return False+ version = (int(match.group("major")), int(match.group("minor") or 0))+ return version >= minimum+def _sanitize_tool_id(tid: str) -> str:"""Ensure tool_use/tool_result IDs match Anthropic's required pattern.@@ -562,13 +592,13 @@ class AnthropicProvider(LLMProvider):)max_tokens = max(1, max_tokens)- thinking_enabled = bool(reasoning_effort) and reasoning_effort.lower() != "none"-- # Several Anthropic models (opus-4-7, opus-4-8, sonnet-5, fable) deprecated the- # `temperature` parameter — the API returns 400 if it is present.- _model_lower = model_name.lower()- omit_temperature = any(- m in _model_lower for m in ("opus-4-7", "opus-4-8", "sonnet-5", "fable")+ reasoning_effort_lower = reasoning_effort.lower() if reasoning_effort else None+ thinking_enabled = reasoning_effort_lower not in (None, "", "none")+ adaptive_only = _model_version_at_least(model_name, _ADAPTIVE_ONLY_MIN_VERSIONS)+ # Mythos Preview rejects sampling parameters but still accepts manual+ # thinking budgets, so it is not part of the adaptive-only capability.+ omit_temperature = (+ adaptive_only or model_name.lower() in _SAMPLING_DEPRECATED_MODELS)kwargs: dict[str, Any] = {@@ -580,16 +610,26 @@ class AnthropicProvider(LLMProvider):if system:kwargs["system"] = system- if reasoning_effort == "adaptive":+ if reasoning_effort_lower == "none" and _model_version_at_least(+ model_name, _THINKING_DISABLE_MIN_VERSIONS+ ):+ # These models think by default, so omission would not honor an+ # explicit request to disable thinking.+ kwargs["thinking"] = {"type": "disabled"}+ elif reasoning_effort_lower == "adaptive":# Adaptive thinking: model decides when and how much to think- # Supported on claude-sonnet-4-6 and claude-opus-4-6.# Also auto-enables interleaved thinking between tool calls.kwargs["thinking"] = {"type": "adaptive"}if not omit_temperature:kwargs["temperature"] = 1.0+ elif thinking_enabled and adaptive_only:+ # Newer Claude models removed manual token budgets. Their effort+ # control is independent from the adaptive thinking mode.+ kwargs["thinking"] = {"type": "adaptive"}+ kwargs["output_config"] = {"effort": reasoning_effort_lower}elif thinking_enabled:budget_map = {"low": 1024, "medium": 4096, "high": max(8192, max_tokens)}- budget = budget_map.get(cast(str, reasoning_effort).lower(), 4096)+ budget = budget_map.get(reasoning_effort_lower, 4096)kwargs["thinking"] = {"type": "enabled", "budget_tokens": budget}kwargs["max_tokens"] = max(max_tokens, budget + 4096)if not omit_temperature:diff --git a/pyproject.toml b/pyproject.tomlindex d2be96b23..a4056afdf 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -24,7 +24,7 @@ license-files = [dependencies = ["typer>=0.20.0,<1.0.0",- "anthropic>=0.45.0,<1.0.0",+ "anthropic>=0.100.0,<1.0.0","pydantic>=2.12.0,<3.0.0","pydantic-settings>=2.12.0,<3.0.0",# Feishu's lark-oapi currently requires websockets<16; core supports 15 and 16.diff --git a/tests/providers/test_anthropic_thinking.py b/tests/providers/test_anthropic_thinking.pyindex 0672709e4..de5e9ffbe 100644--- a/tests/providers/test_anthropic_thinking.py+++ b/tests/providers/test_anthropic_thinking.py@@ -4,6 +4,8 @@ from __future__ import annotationsfrom unittest.mock import patch+import pytest+from nanobot.providers.anthropic_provider import AnthropicProvider@@ -65,17 +67,24 @@ def test_none_does_not_enable_thinking() -> None:assert kw["temperature"] == 0.7+def test_empty_effort_does_not_enable_thinking() -> None:+ kw = _build(_make_provider(), "")+ assert "thinking" not in kw+ assert kw["temperature"] == 0.7++def test_opus_4_7_omits_temperature_adaptive() -> None:kw = _build(_make_provider("claude-opus-4-7"), "adaptive")assert "temperature" not in kwassert kw["thinking"] == {"type": "adaptive"}-def test_opus_4_7_omits_temperature_enabled() -> None:- """Enabled thinking (high) must also omit temperature for opus-4-7."""+def test_opus_4_7_high_uses_adaptive_effort() -> None:kw = _build(_make_provider("claude-opus-4-7"), "high", max_tokens=4096)assert "temperature" not in kw- assert kw["thinking"]["type"] == "enabled"+ assert kw["thinking"] == {"type": "adaptive"}+ assert kw["output_config"] == {"effort": "high"}+ assert kw["max_tokens"] == 4096def test_opus_4_7_omits_temperature_none() -> None:@@ -90,9 +99,11 @@ def test_opus_4_8_omits_temperature_adaptive() -> None:assert "temperature" not in kw-def test_opus_4_8_omits_temperature_enabled() -> None:+def test_opus_4_8_high_uses_adaptive_effort() -> None:kw = _build(_make_provider("claude-opus-4-8"), "high", max_tokens=4096)assert "temperature" not in kw+ assert kw["thinking"] == {"type": "adaptive"}+ assert kw["output_config"] == {"effort": "high"}def test_opus_4_8_omits_temperature_none() -> None:@@ -105,9 +116,11 @@ def test_fable_omits_temperature_adaptive() -> None:assert "temperature" not in kw-def test_fable_omits_temperature_enabled() -> None:+def test_fable_high_uses_adaptive_effort() -> None:kw = _build(_make_provider("claude-fable-5"), "high", max_tokens=4096)assert "temperature" not in kw+ assert kw["thinking"] == {"type": "adaptive"}+ assert kw["output_config"] == {"effort": "high"}def test_fable_omits_temperature_none() -> None:@@ -121,16 +134,67 @@ def test_sonnet_5_omits_temperature_adaptive() -> None:assert kw["thinking"] == {"type": "adaptive"}-def test_sonnet_5_omits_temperature_enabled() -> None:+def test_sonnet_5_high_uses_adaptive_effort() -> None:kw = _build(_make_provider("claude-sonnet-5"), "high", max_tokens=4096)assert "temperature" not in kw- assert kw["thinking"]["type"] == "enabled"+ assert kw["thinking"] == {"type": "adaptive"}+ assert kw["output_config"] == {"effort": "high"}def test_sonnet_5_omits_temperature_none() -> None:- kw = _build(_make_provider("anthropic/claude-sonnet-5"), None)+ kw = _build(_make_provider("anthropic/claude-sonnet-5"), "none")+ assert "temperature" not in kw+ assert kw["thinking"] == {"type": "disabled"}+ assert "output_config" not in kw+++def test_mythos_preview_omits_temperature_but_keeps_manual_budget() -> None:+ kw = _build(_make_provider("claude-mythos-preview"), "high", max_tokens=4096)assert "temperature" not in kw+ assert kw["thinking"] == {"type": "enabled", "budget_tokens": 8192}+ assert "output_config" not in kw+++ "reasoning_effort", [None, "none", "adaptive", "low", "medium", "high", "xhigh", "max"]+)+def test_opus_5_omits_temperature(reasoning_effort: str | None) -> None:+ kw = _build(_make_provider("claude-opus-5"), reasoning_effort)+ assert "temperature" not in kw+++def test_opus_5_none_disables_default_thinking() -> None:+ kw = _build(_make_provider("claude-opus-5"), "none")+ assert kw["thinking"] == {"type": "disabled"}+ assert "output_config" not in kw+++def test_opus_5_unset_preserves_provider_default() -> None:+ kw = _build(_make_provider("claude-opus-5"), None)assert "thinking" not in kw+ assert "output_config" not in kw++[email protected]("reasoning_effort", ["low", "medium", "high", "xhigh", "max"])+def test_opus_5_uses_adaptive_thinking_with_effort(reasoning_effort: str) -> None:+ kw = _build(_make_provider("claude-opus-5"), reasoning_effort, max_tokens=4096)+ assert kw["thinking"] == {"type": "adaptive"}+ assert kw["output_config"] == {"effort": reasoning_effort}+ assert kw["max_tokens"] == 4096+++def test_dated_opus_5_model_uses_family_capabilities() -> None:+ kw = _build(_make_provider("claude-opus-5-20260724"), "medium")+ assert "temperature" not in kw+ assert kw["thinking"] == {"type": "adaptive"}+ assert kw["output_config"] == {"effort": "medium"}+++def test_dated_opus_4_model_does_not_treat_date_as_minor_version() -> None:+ kw = _build(_make_provider("claude-opus-4-20250514"), "high")+ assert kw["temperature"] == 1.0+ assert kw["thinking"] == {"type": "enabled", "budget_tokens": 8192}+ assert "output_config" not in kwdef test_ordinary_model_sends_temperature() -> None: