gac 1.13.0__py3-none-any.whl → 3.8.1__py3-none-any.whl

gac/providers/__init__.py

@@ -1,42 +1,91 @@
 """AI provider implementations for commit message generation."""
 
 from .anthropic import call_anthropic_api
+from .azure_openai import call_azure_openai_api
 from .cerebras import call_cerebras_api
 from .chutes import call_chutes_api
+from .claude_code import call_claude_code_api
 from .custom_anthropic import call_custom_anthropic_api
 from .custom_openai import call_custom_openai_api
 from .deepseek import call_deepseek_api
 from .fireworks import call_fireworks_api
 from .gemini import call_gemini_api
 from .groq import call_groq_api
+from .kimi_coding import call_kimi_coding_api
 from .lmstudio import call_lmstudio_api
 from .minimax import call_minimax_api
+from .mistral import call_mistral_api
+from .moonshot import call_moonshot_api
 from .ollama import call_ollama_api
 from .openai import call_openai_api
 from .openrouter import call_openrouter_api
+from .qwen import call_qwen_api
+from .replicate import call_replicate_api
 from .streamlake import call_streamlake_api
 from .synthetic import call_synthetic_api
 from .together import call_together_api
 from .zai import call_zai_api, call_zai_coding_api
 
+# Provider registry - single source of truth for all providers
+PROVIDER_REGISTRY = {
+    "anthropic": call_anthropic_api,
+    "azure-openai": call_azure_openai_api,
+    "cerebras": call_cerebras_api,
+    "claude-code": call_claude_code_api,
+    "chutes": call_chutes_api,
+    "custom-anthropic": call_custom_anthropic_api,
+    "custom-openai": call_custom_openai_api,
+    "deepseek": call_deepseek_api,
+    "fireworks": call_fireworks_api,
+    "gemini": call_gemini_api,
+    "groq": call_groq_api,
+    "kimi-coding": call_kimi_coding_api,
+    "lm-studio": call_lmstudio_api,
+    "minimax": call_minimax_api,
+    "mistral": call_mistral_api,
+    "moonshot": call_moonshot_api,
+    "ollama": call_ollama_api,
+    "openai": call_openai_api,
+    "openrouter": call_openrouter_api,
+    "qwen": call_qwen_api,
+    "replicate": call_replicate_api,
+    "streamlake": call_streamlake_api,
+    "synthetic": call_synthetic_api,
+    "together": call_together_api,
+    "zai": call_zai_api,
+    "zai-coding": call_zai_coding_api,
+}
+
+# List of supported provider names - derived from registry keys
+SUPPORTED_PROVIDERS = sorted(PROVIDER_REGISTRY.keys())
+
 __all__ = [
     "call_anthropic_api",
+    "call_azure_openai_api",
     "call_cerebras_api",
     "call_chutes_api",
+    "call_claude_code_api",
     "call_custom_anthropic_api",
     "call_custom_openai_api",
     "call_deepseek_api",
     "call_fireworks_api",
     "call_gemini_api",
     "call_groq_api",
+    "call_kimi_coding_api",
     "call_lmstudio_api",
     "call_minimax_api",
+    "call_mistral_api",
+    "call_moonshot_api",
     "call_ollama_api",
     "call_openai_api",
     "call_openrouter_api",
+    "call_qwen_api",
+    "call_replicate_api",
     "call_streamlake_api",
     "call_synthetic_api",
     "call_together_api",
     "call_zai_api",
     "call_zai_coding_api",
+    "PROVIDER_REGISTRY",
+    "SUPPORTED_PROVIDERS",
 ]

gac/providers/anthropic.py

@@ -1,10 +1,15 @@
 """Anthropic AI provider implementation."""
 
+import logging
 import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
 
 
 def call_anthropic_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
@@ -31,8 +36,12 @@ def call_anthropic_api(model: str, messages: list[dict], temperature: float, max
     if system_message:
         data["system"] = system_message
 
+    logger.debug(f"Calling Anthropic API with model={model}")
+
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
         content = response_data["content"][0]["text"]
@@ -40,6 +49,7 @@ def call_anthropic_api(model: str, messages: list[dict], temperature: float, max
             raise AIError.model_error("Anthropic API returned null content")
         if content == "":
             raise AIError.model_error("Anthropic API returned empty content")
+        logger.debug("Anthropic API response received successfully")
         return content
     except httpx.HTTPStatusError as e:
         if e.response.status_code == 429:

gac/providers/azure_openai.py

@@ -0,0 +1,101 @@
+"""Azure OpenAI provider for gac.
+
+This provider provides native support for Azure OpenAI Service with proper
+endpoint construction and API version handling.
+"""
+
+import json
+import logging
+import os
+
+import httpx
+
+from gac.constants import ProviderDefaults
+from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
+
+
+def call_azure_openai_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
+    """Call Azure OpenAI Service API.
+
+    Environment variables:
+        AZURE_OPENAI_API_KEY: Azure OpenAI API key (required)
+        AZURE_OPENAI_ENDPOINT: Azure OpenAI endpoint URL (required)
+            Example: https://your-resource.openai.azure.com
+        AZURE_OPENAI_API_VERSION: Azure OpenAI API version (required)
+            Example: 2025-01-01-preview
+            Example: 2024-02-15-preview
+
+    Args:
+        model: The deployment name in Azure OpenAI (e.g., 'gpt-4o', 'gpt-35-turbo')
+        messages: List of message dictionaries with 'role' and 'content' keys
+        temperature: Controls randomness (0.0-1.0)
+        max_tokens: Maximum tokens in the response
+
+    Returns:
+        The generated commit message
+
+    Raises:
+        AIError: If authentication fails, API errors occur, or response is invalid
+    """
+    api_key = os.getenv("AZURE_OPENAI_API_KEY")
+    if not api_key:
+        raise AIError.authentication_error("AZURE_OPENAI_API_KEY environment variable not set")
+
+    endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
+    if not endpoint:
+        raise AIError.model_error("AZURE_OPENAI_ENDPOINT environment variable not set")
+
+    api_version = os.getenv("AZURE_OPENAI_API_VERSION")
+    if not api_version:
+        raise AIError.model_error("AZURE_OPENAI_API_VERSION environment variable not set")
+
+    # Build Azure OpenAI URL with proper structure
+    endpoint = endpoint.rstrip("/")
+    url = f"{endpoint}/openai/deployments/{model}/chat/completions?api-version={api_version}"
+
+    headers = {"api-key": api_key, "Content-Type": "application/json"}
+
+    data = {"messages": messages, "temperature": temperature, "max_tokens": max_tokens}
+
+    try:
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
+        response.raise_for_status()
+        response_data = response.json()
+
+        try:
+            content = response_data["choices"][0]["message"]["content"]
+        except (KeyError, IndexError, TypeError) as e:
+            logger.error(f"Unexpected response format from Azure OpenAI API. Response: {json.dumps(response_data)}")
+            raise AIError.model_error(
+                f"Azure OpenAI API returned unexpected format. Expected response with "
+                f"'choices[0].message.content', but got: {type(e).__name__}. Check logs for full response structure."
+            ) from e
+
+        if content is None:
+            raise AIError.model_error("Azure OpenAI API returned null content")
+        if content == "":
+            raise AIError.model_error("Azure OpenAI API returned empty content")
+        return content
+    except httpx.ConnectError as e:
+        raise AIError.connection_error(f"Azure OpenAI API connection failed: {str(e)}") from e
+    except httpx.HTTPStatusError as e:
+        status_code = e.response.status_code
+        error_text = e.response.text
+
+        if status_code == 401:
+            raise AIError.authentication_error(f"Azure OpenAI API authentication failed: {error_text}") from e
+        elif status_code == 429:
+            raise AIError.rate_limit_error(f"Azure OpenAI API rate limit exceeded: {error_text}") from e
+        else:
+            raise AIError.model_error(f"Azure OpenAI API error: {status_code} - {error_text}") from e
+    except httpx.TimeoutException as e:
+        raise AIError.timeout_error(f"Azure OpenAI API request timed out: {str(e)}") from e
+    except AIError:
+        raise
+    except Exception as e:
+        raise AIError.model_error(f"Error calling Azure OpenAI API: {str(e)}") from e

gac/providers/cerebras.py

@@ -1,10 +1,15 @@
 """Cerebras AI provider implementation."""
 
+import logging
 import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
 
 
 def call_cerebras_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
@@ -18,8 +23,12 @@ def call_cerebras_api(model: str, messages: list[dict], temperature: float, max_
 
     data = {"model": model, "messages": messages, "temperature": temperature, "max_tokens": max_tokens}
 
+    logger.debug(f"Calling Cerebras API with model={model}")
+
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
         content = response_data["choices"][0]["message"]["content"]
@@ -27,6 +36,7 @@ def call_cerebras_api(model: str, messages: list[dict], temperature: float, max_
             raise AIError.model_error("Cerebras API returned null content")
         if content == "":
             raise AIError.model_error("Cerebras API returned empty content")
+        logger.debug("Cerebras API response received successfully")
         return content
     except httpx.HTTPStatusError as e:
         if e.response.status_code == 429:

gac/providers/chutes.py

@@ -1,10 +1,15 @@
 """Chutes.ai API provider for gac."""
 
+import logging
 import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
 
 
 def call_chutes_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
@@ -43,8 +48,12 @@ def call_chutes_api(model: str, messages: list[dict], temperature: float, max_to
         "max_tokens": max_tokens,
     }
 
+    logger.debug(f"Calling Chutes.ai API with model={model}")
+
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
         content = response_data["choices"][0]["message"]["content"]
@@ -52,6 +61,7 @@ def call_chutes_api(model: str, messages: list[dict], temperature: float, max_to
             raise AIError.model_error("Chutes.ai API returned null content")
         if content == "":
             raise AIError.model_error("Chutes.ai API returned empty content")
+        logger.debug("Chutes.ai API response received successfully")
         return content
     except httpx.HTTPStatusError as e:
         status_code = e.response.status_code

gac/providers/claude_code.py

@@ -0,0 +1,112 @@
+"""Claude Code provider implementation.
+
+This provider allows users with Claude Code subscriptions to use their OAuth tokens
+instead of paying for the expensive Anthropic API.
+"""
+
+import logging
+import os
+
+import httpx
+
+from gac.constants import ProviderDefaults
+from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
+
+
+def call_claude_code_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
+    """Call Claude Code API using OAuth token.
+
+    This provider uses the Claude Code subscription OAuth token instead of the Anthropic API key.
+    It authenticates using Bearer token authentication with the special anthropic-beta header.
+
+    Environment variables:
+        CLAUDE_CODE_ACCESS_TOKEN: OAuth access token from Claude Code authentication
+
+    Args:
+        model: Model name (e.g., 'claude-sonnet-4-5')
+        messages: List of message dictionaries with 'role' and 'content' keys
+        temperature: Sampling temperature (0.0-1.0)
+        max_tokens: Maximum tokens in response
+
+    Returns:
+        Generated text response
+
+    Raises:
+        AIError: If authentication fails or API call fails
+    """
+    access_token = os.getenv("CLAUDE_CODE_ACCESS_TOKEN")
+    if not access_token:
+        raise AIError.authentication_error(
+            "CLAUDE_CODE_ACCESS_TOKEN not found in environment variables. "
+            "Please authenticate with Claude Code and set this token."
+        )
+
+    url = "https://api.anthropic.com/v1/messages"
+    headers = {
+        "Authorization": f"Bearer {access_token}",
+        "anthropic-version": "2023-06-01",
+        "anthropic-beta": "oauth-2025-04-20",
+        "content-type": "application/json",
+    }
+
+    # Convert messages to Anthropic format
+    # IMPORTANT: Claude Code OAuth tokens require the system message to be EXACTLY
+    # "You are Claude Code, Anthropic's official CLI for Claude." with NO additional content.
+    # Any other instructions must be moved to the user message.
+    anthropic_messages = []
+    system_instructions = ""
+
+    for msg in messages:
+        if msg["role"] == "system":
+            system_instructions = msg["content"]
+        else:
+            anthropic_messages.append({"role": msg["role"], "content": msg["content"]})
+
+    # Claude Code requires this exact system message, nothing more
+    system_message = "You are Claude Code, Anthropic's official CLI for Claude."
+
+    # Move any system instructions into the first user message
+    if system_instructions and anthropic_messages:
+        # Prepend system instructions to the first user message
+        first_user_msg = anthropic_messages[0]
+        first_user_msg["content"] = f"{system_instructions}\n\n{first_user_msg['content']}"
+
+    data = {
+        "model": model,
+        "messages": anthropic_messages,
+        "temperature": temperature,
+        "max_tokens": max_tokens,
+        "system": system_message,
+    }
+
+    logger.debug(f"Calling Claude Code API with model={model}")
+
+    try:
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
+        response.raise_for_status()
+        response_data = response.json()
+        content = response_data["content"][0]["text"]
+        if content is None:
+            raise AIError.model_error("Claude Code API returned null content")
+        if content == "":
+            raise AIError.model_error("Claude Code API returned empty content")
+        logger.debug("Claude Code API response received successfully")
+        return content
+    except httpx.HTTPStatusError as e:
+        if e.response.status_code == 401:
+            raise AIError.authentication_error(
+                f"Claude Code authentication failed: {e.response.text}. "
+                "Your token may have expired. Please re-authenticate."
+            ) from e
+        if e.response.status_code == 429:
+            raise AIError.rate_limit_error(f"Claude Code API rate limit exceeded: {e.response.text}") from e
+        raise AIError.model_error(f"Claude Code API error: {e.response.status_code} - {e.response.text}") from e
+    except httpx.TimeoutException as e:
+        raise AIError.timeout_error(f"Claude Code API request timed out: {str(e)}") from e
+    except Exception as e:
+        raise AIError.model_error(f"Error calling Claude Code API: {str(e)}") from e

gac/providers/custom_anthropic.py

@@ -10,7 +10,9 @@ import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
 
 logger = logging.getLogger(__name__)
 
@@ -30,7 +32,7 @@ def call_custom_anthropic_api(model: str, messages: list[dict], temperature: flo
         CUSTOM_ANTHROPIC_VERSION: API version header (optional, defaults to '2023-06-01')
 
     Args:
-        model: The model to use (e.g., 'claude-3-5-sonnet-20241022', 'claude-3-5-haiku-latest')
+        model: The model to use (e.g., 'claude-sonnet-4-5', 'claude-haiku-4-5')
         messages: List of message dictionaries with 'role' and 'content' keys
         temperature: Controls randomness (0.0-1.0)
         max_tokens: Maximum tokens in the response
@@ -74,7 +76,9 @@ def call_custom_anthropic_api(model: str, messages: list[dict], temperature: flo
         data["system"] = system_message
 
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
 

gac/providers/custom_openai.py

@@ -10,7 +10,9 @@ import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
 
 logger = logging.getLogger(__name__)
 
@@ -19,7 +21,6 @@ def call_custom_openai_api(model: str, messages: list[dict], temperature: float,
     """Call a custom OpenAI-compatible API endpoint.
 
     This provider is useful for:
-    - Azure OpenAI Service
     - OpenAI-compatible proxies or gateways
     - Self-hosted OpenAI-compatible services
     - Other services implementing the OpenAI Chat Completions API
@@ -27,8 +28,8 @@ def call_custom_openai_api(model: str, messages: list[dict], temperature: float,
     Environment variables:
         CUSTOM_OPENAI_API_KEY: API key for authentication (required)
         CUSTOM_OPENAI_BASE_URL: Base URL for the API endpoint (required)
-            Example: https://your-endpoint.openai.azure.com
             Example: https://your-proxy.example.com/v1
+            Example: https://your-custom-endpoint.com
 
     Args:
         model: The model to use (e.g., 'gpt-4', 'gpt-3.5-turbo')
@@ -61,7 +62,9 @@ def call_custom_openai_api(model: str, messages: list[dict], temperature: float,
     data = {"model": model, "messages": messages, "temperature": temperature, "max_completion_tokens": max_tokens}
 
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
 

gac/providers/deepseek.py

@@ -1,10 +1,15 @@
 """DeepSeek API provider for gac."""
 
+import logging
 import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
 
 
 def call_deepseek_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
@@ -18,8 +23,12 @@ def call_deepseek_api(model: str, messages: list[dict], temperature: float, max_
 
     data = {"model": model, "messages": messages, "temperature": temperature, "max_tokens": max_tokens}
 
+    logger.debug(f"Calling DeepSeek API with model={model}")
+
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
         content = response_data["choices"][0]["message"]["content"]
@@ -27,6 +36,7 @@ def call_deepseek_api(model: str, messages: list[dict], temperature: float, max_
             raise AIError.model_error("DeepSeek API returned null content")
         if content == "":
             raise AIError.model_error("DeepSeek API returned empty content")
+        logger.debug("DeepSeek API response received successfully")
         return content
     except httpx.HTTPStatusError as e:
         if e.response.status_code == 429:

gac/providers/fireworks.py

@@ -1,10 +1,15 @@
 """Fireworks AI API provider for gac."""
 
+import logging
 import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
 
 
 def call_fireworks_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
@@ -18,8 +23,12 @@ def call_fireworks_api(model: str, messages: list[dict], temperature: float, max
 
     data = {"model": model, "messages": messages, "temperature": temperature, "max_tokens": max_tokens}
 
+    logger.debug(f"Calling Fireworks AI API with model={model}")
+
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
         content = response_data["choices"][0]["message"]["content"]
@@ -27,6 +36,7 @@ def call_fireworks_api(model: str, messages: list[dict], temperature: float, max
             raise AIError.model_error("Fireworks AI API returned null content")
         if content == "":
             raise AIError.model_error("Fireworks AI API returned empty content")
+        logger.debug("Fireworks AI API response received successfully")
         return content
     except httpx.HTTPStatusError as e:
         if e.response.status_code == 429:

gac/providers/gemini.py

@@ -1,11 +1,16 @@
 """Gemini AI provider implementation."""
 
+import logging
 import os
 from typing import Any
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
+
+logger = logging.getLogger(__name__)
 
 
 def call_gemini_api(model: str, messages: list[dict[str, Any]], temperature: float, max_tokens: int) -> str:
@@ -49,8 +54,12 @@ def call_gemini_api(model: str, messages: list[dict[str, Any]], temperature: flo
 
     headers = {"x-goog-api-key": api_key, "Content-Type": "application/json"}
 
+    logger.debug(f"Calling Gemini API with model={model}")
+
     try:
-        response = httpx.post(url, headers=headers, json=payload, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=payload, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()
 
@@ -74,6 +83,7 @@ def call_gemini_api(model: str, messages: list[dict[str, Any]], temperature: flo
         if content_text is None:
             raise AIError.model_error("Gemini API response missing text content")
 
+        logger.debug("Gemini API response received successfully")
         return content_text
     except AIError:
         raise

gac/providers/groq.py

@@ -5,7 +5,9 @@ import os
 
 import httpx
 
+from gac.constants import ProviderDefaults
 from gac.errors import AIError
+from gac.utils import get_ssl_verify
 
 logger = logging.getLogger(__name__)
 
@@ -22,7 +24,9 @@ def call_groq_api(model: str, messages: list[dict], temperature: float, max_toke
     data = {"model": model, "messages": messages, "temperature": temperature, "max_tokens": max_tokens}
 
     try:
-        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response = httpx.post(
+            url, headers=headers, json=data, timeout=ProviderDefaults.HTTP_TIMEOUT, verify=get_ssl_verify()
+        )
         response.raise_for_status()
         response_data = response.json()