From a6ea06e6bf96d7f410aa409e0b568ce7adca2b7c Mon Sep 17 00:00:00 2001
From: Xubin Ren <xubinrencs@gmail.com>
Date: Wed, 15 Apr 2026 16:59:16 +0000
Subject: [PATCH] docs(providers): explain MiniMax thinking endpoint

Document why MiniMax thinking mode uses a separate Anthropic-compatible provider and list the matching base URLs. Add a small registry test so the new provider stays wired to the expected backend and API key.

Made-with: Cursor
---
 README.md                                     |  2 ++
 .../test_minimax_anthropic_provider.py        | 21 +++++++++++++++++++
 2 files changed, 23 insertions(+)
 create mode 100644 tests/providers/test_minimax_anthropic_provider.py

diff --git a/README.md b/README.md
index 7e81d333b..d15db3ee0 100644
--- a/README.md
+++ b/README.md
@@ -930,6 +930,7 @@ IMAP_PASSWORD=your-password-here
 > - **Voice transcription**: Voice messages (Telegram, WhatsApp) are automatically transcribed using Whisper. By default Groq is used (free tier). Set `"transcriptionProvider": "openai"` under `channels` to use OpenAI Whisper instead — the API key is picked from the matching provider config.
 > - **MiniMax Coding Plan**: Exclusive discount links for the nanobot community: [Overseas](https://platform.minimax.io/subscribe/coding-plan?code=9txpdXw04g&source=link) · [Mainland China](https://platform.minimaxi.com/subscribe/token-plan?code=GILTJpMTqZ&source=link)
 > - **MiniMax (Mainland China)**: If your API key is from MiniMax's mainland China platform (minimaxi.com), set `"apiBase": "https://api.minimaxi.com/v1"` in your minimax provider config.
+> - **MiniMax thinking mode**: Use `providers.minimaxAnthropic` when you want `reasoningEffort` / thinking mode. MiniMax exposes that capability through its Anthropic-compatible endpoint, so nanobot keeps it as a separate provider instead of guessing MiniMax-specific thinking parameters on the generic OpenAI-compatible `minimax` endpoint. It uses the same `MINIMAX_API_KEY`. Default Anthropic-compatible base URL: `https://api.minimax.io/anthropic`; for mainland China use `https://api.minimaxi.com/anthropic`.
 > - **VolcEngine / BytePlus Coding Plan**: Use dedicated providers `volcengineCodingPlan` or `byteplusCodingPlan` instead of the pay-per-use `volcengine` / `byteplus` providers.
 > - **Zhipu Coding Plan**: If you're on Zhipu's coding plan, set `"apiBase": "https://open.bigmodel.cn/api/coding/paas/v4"` in your zhipu provider config.
 > - **Alibaba Cloud BaiLian**: If you're using Alibaba Cloud BaiLian's OpenAI-compatible endpoint, set `"apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1"` in your dashscope provider config.
@@ -947,6 +948,7 @@ IMAP_PASSWORD=your-password-here
 | `deepseek` | LLM (DeepSeek direct) | [platform.deepseek.com](https://platform.deepseek.com) |
 | `groq` | LLM + Voice transcription (Whisper, default) | [console.groq.com](https://console.groq.com) |
 | `minimax` | LLM (MiniMax direct) | [platform.minimaxi.com](https://platform.minimaxi.com) |
+| `minimax_anthropic` | LLM (MiniMax Anthropic-compatible endpoint, thinking mode) | [platform.minimaxi.com](https://platform.minimaxi.com) |
 | `gemini` | LLM (Gemini direct) | [aistudio.google.com](https://aistudio.google.com) |
 | `aihubmix` | LLM (API gateway, access to all models) | [aihubmix.com](https://aihubmix.com) |
 | `siliconflow` | LLM (SiliconFlow/硅基流动) | [siliconflow.cn](https://siliconflow.cn) |
diff --git a/tests/providers/test_minimax_anthropic_provider.py b/tests/providers/test_minimax_anthropic_provider.py
new file mode 100644
index 000000000..286b89015
--- /dev/null
+++ b/tests/providers/test_minimax_anthropic_provider.py
@@ -0,0 +1,21 @@
+"""Tests for the MiniMax Anthropic provider registration."""
+
+from nanobot.config.schema import ProvidersConfig
+from nanobot.providers.registry import PROVIDERS
+
+
+def test_minimax_anthropic_config_field_exists():
+    """ProvidersConfig should expose a minimax_anthropic field."""
+    config = ProvidersConfig()
+    assert hasattr(config, "minimax_anthropic")
+
+
+def test_minimax_anthropic_provider_in_registry():
+    """MiniMax Anthropic endpoint should be registered with Anthropic backend."""
+    specs = {s.name: s for s in PROVIDERS}
+    assert "minimax_anthropic" in specs
+
+    minimax_anthropic = specs["minimax_anthropic"]
+    assert minimax_anthropic.env_key == "MINIMAX_API_KEY"
+    assert minimax_anthropic.backend == "anthropic"
+    assert minimax_anthropic.default_api_base == "https://api.minimax.io/anthropic"