agenthub-python 0.4.0__tar.gz → 0.4.1__tar.gz

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agenthub-python
-Version: 0.4.0
+Version: 0.4.1
 Summary: AgentHub is the LLM API Hub for the Agent era, built for high-precision autonomous agents.
 Keywords: agent,llm,gemini,claude,gpt
 Author: PrismShadow

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/agenthub/__init__.py

@@ -13,15 +13,22 @@
 # limitations under the License.
 
 from .auto_client import AutoLLMClient
-from .errors import AgentHubError, EmptyResponseError, ToolCallArgumentParseError
+from .errors import AgentHubError, EmptyResponseError, ToolCallArgumentParseError, UnsupportedParameterError
+from .registry import Currency, Modality, ModelPricing, SupportedModel, list_supported_models
 from .types import PromptCaching, ThinkingLevel
 
 
 __all__ = [
     "AgentHubError",
     "AutoLLMClient",
+    "Currency",
     "EmptyResponseError",
+    "Modality",
+    "ModelPricing",
     "PromptCaching",
+    "SupportedModel",
     "ThinkingLevel",
     "ToolCallArgumentParseError",
+    "UnsupportedParameterError",
+    "list_supported_models",
 ]

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/agenthub/auto_client.py

@@ -47,7 +47,14 @@ class AutoLLMClient(LLMClient):
     ) -> LLMClient:
         """Create the appropriate client for the given model."""
         client_type = (client_type or os.getenv("CLIENT_TYPE", model)).lower()
+        # gemini-3.6 must be matched before the broader gemini-3 prefix below
         if any(
+            prefix in client_type for prefix in ("gemini-3.6", "gemini-3.5-flash-lite")
+        ):  # e.g., gemini-3.6-flash; gemini-3.5-flash-lite shares the sampling-parameter deprecation
+            from .gemini3_6 import Gemini3_6Client
+
+            return Gemini3_6Client(model=model, api_key=api_key, base_url=base_url)
+        elif any(
             prefix in client_type for prefix in ("gemini-3", "gemini-embedding")
         ):  # e.g., gemini-3-flash-preview, gemini-embedding-2
             from .gemini3 import Gemini3Client
@@ -67,10 +74,18 @@ class AutoLLMClient(LLMClient):
             from .gpt5_5 import GPT5_5Client
 
             return GPT5_5Client(model=model, api_key=api_key, base_url=base_url)
+        elif "glm-5.2" in client_type:
+            from .glm5_2 import GLM5_2Client
+
+            return GLM5_2Client(model=model, api_key=api_key, base_url=base_url)
         elif "glm-5" in client_type or "glm-5.1" in client_type:
             from .glm5_1 import GLM5_1Client
 
             return GLM5_1Client(model=model, api_key=api_key, base_url=base_url)
+        elif "kimi-k3" in client_type:
+            from .kimi_k3 import KimiK3Client
+
+            return KimiK3Client(model=model, api_key=api_key, base_url=base_url)
         elif "kimi-k2.5" in client_type or "kimi-k2.6" in client_type:
             from .kimi_k2_6 import KimiK2_6Client
 
@@ -90,7 +105,7 @@ class AutoLLMClient(LLMClient):
         else:
             raise ValueError(
                 f"{client_type} is not supported. "
-                "Supported client types: gemini-3, claude-5, claude-4-8, claude-4-7, claude-4-6, gpt-5.5, gpt-5.4, glm-5.1, kimi-k2.6, kimi-k2.5, deepseek-v4, openai-embedding, openai."
+                "Supported client types: gemini-3.6, gemini-3, claude-5, claude-4-8, claude-4-7, claude-4-6, gpt-5.5, gpt-5.4, glm-5.2, glm-5.1, kimi-k3, kimi-k2.6, kimi-k2.5, deepseek-v4, openai-embedding, openai."
             )
 
     def transform_uni_config_to_model_config(self, config: UniConfig) -> Any:

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/agenthub/claude4_6/client.py

@@ -23,7 +23,7 @@ from anthropic import AsyncAnthropic, AsyncAnthropicBedrock
 from anthropic.types.beta import BetaMessageParam, BetaRawMessageStreamEvent
 
 from ..base_client import LLMClient
-from ..errors import parse_tool_call_arguments
+from ..errors import UnsupportedParameterError, parse_tool_call_arguments
 from ..types import (
     EventType,
     FinishReason,
@@ -118,7 +118,9 @@ class Claude4_6Client(LLMClient):
         """Convert ToolChoice to Claude's tool_choice format."""
         if isinstance(tool_choice, list):
             if len(tool_choice) > 1:
-                raise ValueError("Claude supports only one tool choice.")
+                raise UnsupportedParameterError(
+                    self.__class__.__name__, "tool_choice", "Claude supports only one tool choice."
+                )
 
             return {"type": "any", "name": tool_choice[0]}
         elif tool_choice == "none":

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/agenthub/claude5/client.py

@@ -23,7 +23,7 @@ from anthropic import AsyncAnthropic, AsyncAnthropicBedrock
 from anthropic.types.beta import BetaMessageParam, BetaRawMessageStreamEvent
 
 from ..base_client import LLMClient
-from ..errors import parse_tool_call_arguments
+from ..errors import UnsupportedParameterError, parse_tool_call_arguments
 from ..types import (
     EventType,
     FinishReason,
@@ -118,7 +118,9 @@ class Claude5Client(LLMClient):
         """Convert ToolChoice to Claude's tool_choice format."""
         if isinstance(tool_choice, list):
             if len(tool_choice) > 1:
-                raise ValueError("Claude supports only one tool choice.")
+                raise UnsupportedParameterError(
+                    self.__class__.__name__, "tool_choice", "Claude supports only one tool choice."
+                )
 
             return {"type": "any", "name": tool_choice[0]}
         elif tool_choice == "none":
@@ -149,7 +151,9 @@ class Claude5Client(LLMClient):
             claude_config["max_tokens"] = 64000  # Claude requires max_tokens to be specified
 
         if config.get("temperature") is not None and config["temperature"] != 1.0:
-            raise ValueError("Claude 4.8 does not support setting temperature.")
+            raise UnsupportedParameterError(
+                self.__class__.__name__, "temperature", "Claude 4.8 does not support setting temperature."
+            )
 
         if config.get("thinking_level") is not None:
             claude_config.update(self._convert_thinking_level_to_thinking_config(config["thinking_level"]))

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/agenthub/deepseek_v4/client.py

@@ -20,7 +20,7 @@ from openai import AsyncOpenAI
 from openai.types.chat import ChatCompletionChunk, ChatCompletionMessageParam
 
 from ..base_client import LLMClient
-from ..errors import parse_tool_call_arguments
+from ..errors import UnsupportedParameterError, parse_tool_call_arguments
 from ..types import (
     EventType,
     FinishReason,
@@ -72,7 +72,9 @@ class DeepSeekV4Client(LLMClient):
         """Convert ToolChoice to DeepSeek's OpenAI-compatible tool_choice format."""
         if tool_choice in ["auto", "none"]:
             return tool_choice
-        raise ValueError("DeepSeek V4 only supports 'auto' and 'none' for tool_choice.")
+        raise UnsupportedParameterError(
+            self.__class__.__name__, "tool_choice", "DeepSeek V4 only supports 'auto' and 'none' for tool_choice."
+        )
 
     def transform_uni_config_to_model_config(self, config: UniConfig) -> dict[str, Any]:
         """
@@ -90,7 +92,9 @@ class DeepSeekV4Client(LLMClient):
             deepseek_config["max_tokens"] = config["max_tokens"]
 
         if config.get("temperature") is not None and config["temperature"] != 1.0:
-            raise ValueError("DeepSeek V4 does not support setting temperature.")
+            raise UnsupportedParameterError(
+                self.__class__.__name__, "temperature", "DeepSeek V4 does not support setting temperature."
+            )
 
         thinking_level = config.get("thinking_level")
         if thinking_level is not None:
@@ -106,7 +110,9 @@ class DeepSeekV4Client(LLMClient):
             deepseek_config["tool_choice"] = self._convert_tool_choice(config["tool_choice"])
 
         if config.get("prompt_caching") is not None and config["prompt_caching"] != PromptCaching.ENABLE:
-            raise ValueError("prompt_caching must be ENABLE for DeepSeek.")
+            raise UnsupportedParameterError(
+                self.__class__.__name__, "prompt_caching", "prompt_caching must be ENABLE for DeepSeek."
+            )
 
         return deepseek_config
 

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/agenthub/errors.py

@@ -29,6 +29,20 @@ class AgentHubError(ValueError):
     """Base class for errors raised by AgentHub clients."""
 
 
+class UnsupportedParameterError(AgentHubError):
+    """Raised when a UniConfig parameter value is not supported by the target model client.
+
+    Thinking levels never raise this by design: every client maps each ThinkingLevel
+    onto the closest level the model supports. Parameters such as temperature and
+    tool_choice may reject unsupported values with this error.
+    """
+
+    def __init__(self, client: str, parameter: str, message: str) -> None:
+        self.client = client
+        self.parameter = parameter
+        super().__init__(message)
+
+
 class EmptyResponseError(AgentHubError):
     """Raised when a completed response carries no non-thinking content and no tool calls.
 

{agenthub_python-0.4.0 → agenthub_python-0.4.1}/agenthub/gemini3/client.py

@@ -25,6 +25,7 @@ from google.genai import types
 from google.oauth2 import service_account
 
 from ..base_client import LLMClient
+from ..errors import UnsupportedParameterError
 from ..types import (
     ContentItem,
     EventType,
@@ -148,7 +149,9 @@ class Gemini3Client(LLMClient):
                 config_params["tool_config"] = types.ToolConfig(function_calling_config=tool_config)
 
         if config.get("prompt_caching") is not None and config["prompt_caching"] != PromptCaching.ENABLE:
-            raise ValueError("prompt_caching must be ENABLE for Gemini 3.")
+            raise UnsupportedParameterError(
+                self.__class__.__name__, "prompt_caching", "prompt_caching must be ENABLE for Gemini 3."
+            )
 
         if config.get("image_config") is not None:
             config_params["image_config"] = types.ImageConfig(**config["image_config"])

agenthub_python-0.4.1/agenthub/gemini3_6/__init__.py

@@ -0,0 +1,18 @@
+# Copyright 2025 Prism Shadow. and/or its affiliates
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .client import Gemini3_6Client
+
+
+__all__ = ["Gemini3_6Client"]