Update service env names

.env.example

@@ -2,8 +2,8 @@
 API_KEY="your_openai_compatible_key"                     # API key for your OpenAI-compatible LLM provider.
 API_BASE="https://your-openai-compatible-endpoint/v1"    # Base URL for the OpenAI-compatible chat-completions endpoint.
 MODEL_NAME="gpt-5.5"                                     # Main model used by the agent and WebFetch summarization.
-SERPER_KEY_ID="your_serper_key"                          # https://serper.dev/
-JINA_API_KEYS="your_jina_key"                            # https://jina.ai/
+SERPER_KEY="your_serper_key"                             # https://serper.dev/
+JINA_KEY="your_jina_key"                                 # https://jina.ai/
 MINERU_TOKEN="your_mineru_token"                         # https://mineru.net/
 
 # Optional

README.md

@@ -30,8 +30,8 @@ Configure these as Hugging Face Space secrets before starting the app:
 | `API_KEY` | API key for your OpenAI-compatible LLM provider. |
 | `API_BASE` | OpenAI-compatible `/v1` endpoint. |
 | `MODEL_NAME` | Main model used by ResearchHarness. |
-| `SERPER_KEY_ID` | WebSearch / ScholarSearch key from <https://serper.dev/>. |
-| `JINA_API_KEYS` | WebFetch key from <https://jina.ai/>. |
+| `SERPER_KEY` | WebSearch / ScholarSearch key from <https://serper.dev/>. |
+| `JINA_KEY` | WebFetch key from <https://jina.ai/>. |
 | `MINERU_TOKEN` | ReadPDF key from <https://mineru.net/>. |
 
 ## Optional Runtime Variables

agent_base/provider_compat.py

@@ -13,6 +13,14 @@ def model_rejects_sampling_params(model_name: str) -> bool:
     return any(part.startswith("claude") for part in parts)
 
 
+def model_rejects_presence_penalty(model_name: str) -> bool:
+    normalized = str(model_name or "").strip().casefold()
+    if not normalized:
+        return False
+    parts = [part for part in _MODEL_NAME_SPLIT_RE.split(normalized) if part]
+    return any(part.startswith("gpt-5.5") for part in parts)
+
+
 def apply_sampling_params(
     request_kwargs: dict[str, Any],
     *,
@@ -27,5 +35,5 @@ def apply_sampling_params(
         request_kwargs["temperature"] = temperature
     if top_p is not None:
         request_kwargs["top_p"] = top_p
-    if presence_penalty is not None:
+    if presence_penalty is not None and not model_rejects_presence_penalty(model_name):
         request_kwargs["presence_penalty"] = presence_penalty

agent_base/tools/README.md

@@ -290,7 +290,7 @@ Arguments:
 Behavior:
 
 - Calls Serper's Google Search endpoint.
-- Reads `SERPER_KEY_ID` at runtime.
+- Reads `SERPER_KEY` at runtime.
 
 Returns:
 
@@ -312,7 +312,7 @@ Arguments:
 Behavior:
 
 - Calls Serper's Google Scholar endpoint.
-- Reads `SERPER_KEY_ID` at runtime.
+- Reads `SERPER_KEY` at runtime.
 
 Returns:
 
@@ -341,7 +341,7 @@ Behavior:
 
 Dependencies:
 
-- `JINA_API_KEYS`
+- `JINA_KEY`
 - `API_KEY`
 - `API_BASE`
 - `MODEL_NAME`

agent_base/tools/tool_web.py

@@ -130,9 +130,9 @@ class WebSearch(ToolBase):
                 "gl": "us",
                 "hl": "en",
             }
-        serper_key = os.getenv("SERPER_KEY_ID", "").strip()
+        serper_key = os.getenv("SERPER_KEY", "").strip()
         if not serper_key:
-            return "[WebSearch] SERPER_KEY_ID is not set."
+            return "[WebSearch] SERPER_KEY is not set."
         headers = {
             "X-API-KEY": serper_key,
             "Content-Type": "application/json",
@@ -229,9 +229,9 @@ class ScholarSearch(ToolBase):
 
     def google_scholar_with_serp(self, query: str):
         payload = {"q": query}
-        serper_key = os.getenv("SERPER_KEY_ID", "").strip()
+        serper_key = os.getenv("SERPER_KEY", "").strip()
         if not serper_key:
-            return "[ScholarSearch] SERPER_KEY_ID is not set."
+            return "[ScholarSearch] SERPER_KEY is not set."
         headers = {
             "X-API-KEY": serper_key,
             "Content-Type": "application/json",
@@ -449,9 +449,9 @@ class WebFetch(ToolBase):
     def jina_readpage(self, url: str, runtime_deadline: Optional[float] = None) -> str:
         max_retries = 3
         timeout = 50
-        jina_api_key = os.getenv("JINA_API_KEYS", "").strip()
+        jina_api_key = os.getenv("JINA_KEY", "").strip()
         if not jina_api_key:
-            return "[WebFetch] JINA_API_KEYS is not set."
+            return "[WebFetch] JINA_KEY is not set."
 
         last_error = "unknown page-fetch error"
         for attempt in range(max_retries):

agent_base/tools/tooling.py

@@ -65,8 +65,8 @@ BLOCKED_COMMAND_PATTERNS: list[tuple[re.Pattern[str], str]] = [
 ]
 SENSITIVE_ENV_EXACT = {
     "API_KEY",
-    "SERPER_KEY_ID",
-    "JINA_API_KEYS",
+    "SERPER_KEY",
+    "JINA_KEY",
     "MINERU_TOKEN",
     "OPENAI_API_KEY",
     "ANTHROPIC_API_KEY",

agent_base/utils.py

@@ -16,8 +16,8 @@ REQUIRED_ENV_VARS = (
     "API_KEY",
     "API_BASE",
     "MODEL_NAME",
-    "SERPER_KEY_ID",
-    "JINA_API_KEYS",
+    "SERPER_KEY",
+    "JINA_KEY",
     "MINERU_TOKEN",
 )
 IMAGE_INPUT_REL_DIR = Path("inputs") / "images"

docs/tutorial_en.md

@@ -32,8 +32,8 @@ Required variables:
 | `API_KEY` | API key for your OpenAI-compatible LLM provider. |
 | `API_BASE` | Base URL for the OpenAI-compatible chat-completions endpoint. |
 | `MODEL_NAME` | Main model used by ResearchHarness. |
-| `SERPER_KEY_ID` | Serper key for `WebSearch` and `ScholarSearch`: https://serper.dev/ |
-| `JINA_API_KEYS` | Jina key for `WebFetch`: https://jina.ai/ |
+| `SERPER_KEY` | Serper key for `WebSearch` and `ScholarSearch`: https://serper.dev/ |
+| `JINA_KEY` | Jina key for `WebFetch`: https://jina.ai/ |
 | `MINERU_TOKEN` | MinerU token for `ReadPDF`: https://mineru.net/ |
 
 Optional variables:

docs/tutorial_zh.md

@@ -30,8 +30,8 @@ python3 -m pip install -r requirements.txt
 | `API_KEY` | OpenAI-compatible LLM 服务的 API key。 |
 | `API_BASE` | OpenAI-compatible chat-completions endpoint 的 base URL。 |
 | `MODEL_NAME` | ResearchHarness 使用的主模型。 |
-| `SERPER_KEY_ID` | `WebSearch` 和 `ScholarSearch` 使用的 Serper key：https://serper.dev/ |
-| `JINA_API_KEYS` | `WebFetch` 使用的 Jina key：https://jina.ai/ |
+| `SERPER_KEY` | `WebSearch` 和 `ScholarSearch` 使用的 Serper key：https://serper.dev/ |
+| `JINA_KEY` | `WebFetch` 使用的 Jina key：https://jina.ai/ |
 | `MINERU_TOKEN` | `ReadPDF` 使用的 MinerU token：https://mineru.net/ |
 
 可选变量：