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

gac/oauth/token_store.py

@@ -0,0 +1,81 @@
+"""Token storage for OAuth authentication."""
+
+import json
+import os
+import stat
+from dataclasses import dataclass
+from pathlib import Path
+from typing import TypedDict
+
+
+class OAuthToken(TypedDict, total=False):
+    """OAuth token structure."""
+
+    access_token: str
+    refresh_token: str | None
+    expiry: int
+    token_type: str
+    scope: str | None
+    resource_url: str | None
+
+
+@dataclass
+class TokenStore:
+    """Secure file-based token storage for OAuth tokens."""
+
+    base_dir: Path
+
+    def __init__(self, base_dir: Path | None = None):
+        if base_dir is None:
+            base_dir = Path.home() / ".gac" / "oauth"
+        self.base_dir = base_dir
+        self._ensure_directory()
+
+    def _ensure_directory(self) -> None:
+        """Create the OAuth directory with secure permissions."""
+        if not self.base_dir.exists():
+            self.base_dir.mkdir(parents=True, mode=0o700)
+        else:
+            os.chmod(self.base_dir, stat.S_IRWXU)
+
+    def _get_token_path(self, provider: str) -> Path:
+        """Get the path for a provider's token file."""
+        return self.base_dir / f"{provider}.json"
+
+    def save_token(self, provider: str, token: OAuthToken) -> None:
+        """Save a token to file with secure permissions.
+
+        Uses atomic write (temp file + rename) to prevent partial reads.
+        """
+        token_path = self._get_token_path(provider)
+        temp_path = token_path.with_suffix(".tmp")
+
+        with open(temp_path, "w") as f:
+            json.dump(token, f, indent=2)
+
+        os.chmod(temp_path, stat.S_IRUSR | stat.S_IWUSR)
+        temp_path.rename(token_path)
+
+    def get_token(self, provider: str) -> OAuthToken | None:
+        """Retrieve a token from file."""
+        token_path = self._get_token_path(provider)
+        if not token_path.exists():
+            return None
+
+        with open(token_path) as f:
+            token_data = json.load(f)
+            if isinstance(token_data, dict) and isinstance(token_data.get("access_token"), str):
+                return token_data  # type: ignore[return-value]
+            return None
+
+    def remove_token(self, provider: str) -> None:
+        """Remove a token file."""
+        token_path = self._get_token_path(provider)
+        if token_path.exists():
+            token_path.unlink()
+
+    def list_providers(self) -> list[str]:
+        """List all providers with stored tokens."""
+        if not self.base_dir.exists():
+            return []
+        return [f.stem for f in self.base_dir.glob("*.json")]

gac/prompt.py

@@ -276,16 +276,24 @@ You are an expert code reviewer specializing in identifying missing context and
 </role>
 
 <focus>
-Analyze the git diff and identify missing "why" context. Generate 3-7 focused questions to clarify intent, motivation, and impact. Your questions should help the developer provide the essential context needed for a meaningful commit message.
+Analyze the git diff and determine the appropriate number of questions based on change complexity. Generate 1-5 focused questions to clarify intent, motivation, and impact. Your questions should help the developer provide the essential context needed for a meaningful commit message.
 </focus>
 
+<adaptive_guidelines>
+- For very small changes (single file, <10 lines): Ask 1-2 essential questions about core purpose
+- For small changes (few files, <50 lines): Ask 1-3 questions covering intent and impact
+- For medium changes (multiple files, <200 lines): Ask 2-4 questions covering scope, intent, and impact
+- For large changes (many files or substantial modifications): Ask 3-5 questions covering all aspects
+- Always prioritize questions that would most help generate an informative commit message
+- Lean toward fewer questions for straightforward changes
+</adaptive_guidelines>
+
 <guidelines>
 - Focus on WHY the changes were made, not just WHAT was changed
 - Ask about the intent, motivation, or business purpose behind the changes
 - Consider what future developers need to understand about this change
 - Ask about the broader impact or consequences of the changes
 - Target areas where technical implementation doesn't reveal the underlying purpose
-- Prioritize questions that would most help generate an informative commit message
 - Keep questions concise and specific
 - Format as a clean list for easy parsing
 </guidelines>
@@ -306,7 +314,11 @@ Respond with ONLY a numbered list of questions, one per line:
 </output_format>
 
 <examples>
-Good example questions:
+Good example questions for small changes:
+1. What problem does this fix?
+2. Why was this approach chosen?
+
+Good example questions for larger changes:
 1. What problem or user need does this change address?
 2. Why was this particular approach chosen over alternatives?
 3. What impact will this have on existing functionality?
@@ -704,7 +716,7 @@ Additional context provided by the user: {hint}
     user_prompt += """
 
 <format_instructions>
-Analyze the changes above and generate 3-7 focused questions that clarify the intent, motivation, and impact of these changes. Respond with ONLY a numbered list of questions as specified in the system prompt.
+Analyze the changes above and determine the appropriate number of questions based on the change complexity. Generate 1-5 focused questions that clarify the intent, motivation, and impact of these changes. For very small changes, ask only 1-2 essential questions. Respond with ONLY a numbered list of questions as specified in the system prompt.
 </format_instructions>"""
 
     return system_prompt.strip(), user_prompt.strip()

gac/providers/__init__.py

@@ -19,6 +19,7 @@ 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
@@ -46,6 +47,7 @@ PROVIDER_REGISTRY = {
     "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,
@@ -77,6 +79,7 @@ __all__ = [
     "call_ollama_api",
     "call_openai_api",
     "call_openrouter_api",
+    "call_qwen_api",
     "call_replicate_api",
     "call_streamlake_api",
     "call_synthetic_api",

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

@@ -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__)
 
@@ -59,7 +61,9 @@ def call_azure_openai_api(model: str, messages: list[dict], temperature: float,
     data = {"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()
 

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

@@ -4,11 +4,16 @@ This provider allows users with Claude Code subscriptions to use their OAuth tok
 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:
@@ -77,8 +82,12 @@ def call_claude_code_api(model: str, messages: list[dict], temperature: float, m
         "system": system_message,
     }
 
+    logger.debug(f"Calling Claude Code 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"]
@@ -86,6 +95,7 @@ def call_claude_code_api(model: str, messages: list[dict], temperature: float, m
             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:

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__)
 
@@ -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__)
 
@@ -60,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()
 

gac/providers/kimi_coding.py

@@ -6,7 +6,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__)
 
@@ -25,7 +27,9 @@ def call_kimi_coding_api(model: str, messages: list[dict], temperature: float, m
     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/lmstudio.py

@@ -1,11 +1,16 @@
 """LM Studio 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_lmstudio_api(model: str, messages: list[dict[str, Any]], temperature: float, max_tokens: int) -> str:
@@ -28,8 +33,12 @@ def call_lmstudio_api(model: str, messages: list[dict[str, Any]], temperature: f
         "stream": False,
     }
 
+    logger.debug(f"Calling LM Studio 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()
         choices = response_data.get("choices") or []
@@ -39,11 +48,13 @@ def call_lmstudio_api(model: str, messages: list[dict[str, Any]], temperature: f
         message = choices[0].get("message") or {}
         content = message.get("content")
         if content:
+            logger.debug("LM Studio API response received successfully")
             return content
 
         # Some OpenAI-compatible servers return text field directly
         content = choices[0].get("text")
         if content:
+            logger.debug("LM Studio API response received successfully")
             return content
 
         raise AIError.model_error("LM Studio API response missing content")

gac/providers/minimax.py

@@ -1,10 +1,15 @@
 """MiniMax 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_minimax_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
@@ -18,8 +23,12 @@ def call_minimax_api(model: str, messages: list[dict], temperature: float, max_t
 
     data = {"model": model, "messages": messages, "temperature": temperature, "max_tokens": max_tokens}
 
+    logger.debug(f"Calling MiniMax 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_minimax_api(model: str, messages: list[dict], temperature: float, max_t
             raise AIError.model_error("MiniMax API returned null content")
         if content == "":
             raise AIError.model_error("MiniMax API returned empty content")
+        logger.debug("MiniMax API response received successfully")
         return content
     except httpx.HTTPStatusError as e:
         if e.response.status_code == 429:

gac/providers/mistral.py

@@ -1,10 +1,15 @@
 """Mistral 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_mistral_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
@@ -18,8 +23,12 @@ def call_mistral_api(model: str, messages: list[dict], temperature: float, max_t
 
     data = {"model": model, "messages": messages, "temperature": temperature, "max_tokens": max_tokens}
 
+    logger.debug(f"Calling Mistral 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_mistral_api(model: str, messages: list[dict], temperature: float, max_t
             raise AIError.model_error("Mistral API returned null content")
         if content == "":
             raise AIError.model_error("Mistral API returned empty content")
+        logger.debug("Mistral API response received successfully")
         return content
     except httpx.HTTPStatusError as e:
         if e.response.status_code == 429: