Merge branch 'fixes'

.gitignore

@@ -3,3 +3,4 @@ __pycache__
 uv.lock
 colorforth_bootslop_002.md
 md_gen
+scripts/generated

ai_client.py

@@ -1,4 +1,4 @@
-# ai_client.py
+# ai_client.py
 import tomllib
 from pathlib import Path
 
@@ -22,6 +22,103 @@ def _load_credentials() -> dict:
     with open("credentials.toml", "rb") as f:
         return tomllib.load(f)
 
+# ------------------------------------------------------------------ provider errors
+
+class ProviderError(Exception):
+    """
+    Raised when the upstream API returns a hard error we want to surface
+    distinctly in the UI (quota, rate-limit, auth, balance, etc.).
+
+    Attributes
+    ----------
+    kind : str
+        One of: "quota", "rate_limit", "auth", "balance", "network", "unknown"
+    provider : str
+        "gemini" or "anthropic"
+    original : Exception
+        The underlying SDK exception.
+    """
+    def __init__(self, kind: str, provider: str, original: Exception):
+        self.kind = kind
+        self.provider = provider
+        self.original = original
+        super().__init__(str(original))
+
+    # Human-readable banner shown in the Response panel
+    def ui_message(self) -> str:
+        labels = {
+            "quota":      "QUOTA EXHAUSTED",
+            "rate_limit": "RATE LIMITED",
+            "auth":       "AUTH / API KEY ERROR",
+            "balance":    "BALANCE / BILLING ERROR",
+            "network":    "NETWORK / CONNECTION ERROR",
+            "unknown":    "API ERROR",
+        }
+        label = labels.get(self.kind, "API ERROR")
+        return f"[{self.provider.upper()} {label}]\n\n{self.original}"
+
+
+def _classify_anthropic_error(exc: Exception) -> ProviderError:
+    """Map an anthropic SDK exception to a ProviderError."""
+    try:
+        import anthropic
+        if isinstance(exc, anthropic.RateLimitError):
+            return ProviderError("rate_limit", "anthropic", exc)
+        if isinstance(exc, anthropic.AuthenticationError):
+            return ProviderError("auth", "anthropic", exc)
+        if isinstance(exc, anthropic.PermissionDeniedError):
+            return ProviderError("auth", "anthropic", exc)
+        if isinstance(exc, anthropic.APIConnectionError):
+            return ProviderError("network", "anthropic", exc)
+        if isinstance(exc, anthropic.APIStatusError):
+            status = getattr(exc, "status_code", 0)
+            body = str(exc).lower()
+            if status == 429:
+                return ProviderError("rate_limit", "anthropic", exc)
+            if status in (401, 403):
+                return ProviderError("auth", "anthropic", exc)
+            if status == 402:
+                return ProviderError("balance", "anthropic", exc)
+            # Anthropic puts credit-balance errors in the body at 400
+            if "credit" in body or "balance" in body or "billing" in body:
+                return ProviderError("balance", "anthropic", exc)
+            if "quota" in body or "limit" in body or "exceeded" in body:
+                return ProviderError("quota", "anthropic", exc)
+    except ImportError:
+        pass
+    return ProviderError("unknown", "anthropic", exc)
+
+
+def _classify_gemini_error(exc: Exception) -> ProviderError:
+    """Map a google-genai SDK exception to a ProviderError."""
+    body = str(exc).lower()
+    # google-genai surfaces HTTP errors as google.api_core exceptions or
+    # google.genai exceptions; inspect the message text as a reliable fallback.
+    try:
+        from google.api_core import exceptions as gac
+        if isinstance(exc, gac.ResourceExhausted):
+            return ProviderError("quota", "gemini", exc)
+        if isinstance(exc, gac.TooManyRequests):
+            return ProviderError("rate_limit", "gemini", exc)
+        if isinstance(exc, (gac.Unauthenticated, gac.PermissionDenied)):
+            return ProviderError("auth", "gemini", exc)
+        if isinstance(exc, gac.ServiceUnavailable):
+            return ProviderError("network", "gemini", exc)
+    except ImportError:
+        pass
+    # Fallback: parse status code / message string
+    if "429" in body or "quota" in body or "resource exhausted" in body:
+        return ProviderError("quota", "gemini", exc)
+    if "rate" in body and "limit" in body:
+        return ProviderError("rate_limit", "gemini", exc)
+    if "401" in body or "403" in body or "api key" in body or "unauthenticated" in body:
+        return ProviderError("auth", "gemini", exc)
+    if "402" in body or "billing" in body or "balance" in body or "payment" in body:
+        return ProviderError("balance", "gemini", exc)
+    if "connection" in body or "timeout" in body or "unreachable" in body:
+        return ProviderError("network", "gemini", exc)
+    return ProviderError("unknown", "gemini", exc)
+
 # ------------------------------------------------------------------ provider setup
 
 def set_provider(provider: str, model: str):
@@ -49,24 +146,30 @@ def list_models(provider: str) -> list[str]:
 
 def _list_gemini_models(api_key: str) -> list[str]:
     from google import genai
-    client = genai.Client(api_key=api_key)
+    try:
-    models = []
+        client = genai.Client(api_key=api_key)
-    for m in client.models.list():
+        models = []
-        name = m.name
+        for m in client.models.list():
-        if name.startswith("models/"):
+            name = m.name
-            name = name[len("models/"):]
+            if name.startswith("models/"):
-        if "gemini" in name.lower():
+                name = name[len("models/"):]
-            models.append(name)
+            if "gemini" in name.lower():
-    return sorted(models)
+                models.append(name)
+        return sorted(models)
+    except Exception as exc:
+        raise _classify_gemini_error(exc) from exc
 
 def _list_anthropic_models() -> list[str]:
     import anthropic
-    creds = _load_credentials()
+    try:
-    client = anthropic.Anthropic(api_key=creds["anthropic"]["api_key"])
+        creds = _load_credentials()
-    models = []
+        client = anthropic.Anthropic(api_key=creds["anthropic"]["api_key"])
-    for m in client.models.list():
+        models = []
-        models.append(m.id)
+        for m in client.models.list():
-    return sorted(models)
+            models.append(m.id)
+        return sorted(models)
+    except Exception as exc:
+        raise _classify_anthropic_error(exc) from exc
 
 
 # --------------------------------------------------------- tool definition
@@ -148,59 +251,60 @@ def _send_gemini(md_content: str, user_message: str, base_dir: str) -> str:
     from google import genai
     from google.genai import types
 
-    _ensure_gemini_client()
+    try:
+        _ensure_gemini_client()
 
-    # Gemini chats don't support mutating tools after creation,
+        if _gemini_chat is None:
-    # so we recreate if None (reset_session clears it).
+            _gemini_chat = _gemini_client.chats.create(
-    if _gemini_chat is None:
+                model=_model,
-        _gemini_chat = _gemini_client.chats.create(
+                config=types.GenerateContentConfig(
-            model=_model,
+                    tools=[_gemini_tool_declaration()]
-            config=types.GenerateContentConfig(
+                )
-                tools=[_gemini_tool_declaration()]
             )
-        )
 
-    full_message = f"<context>\n{md_content}\n</context>\n\n{user_message}"
+        full_message = f"<context>\n{md_content}\n</context>\n\n{user_message}"
 
-    response = _gemini_chat.send_message(full_message)
+        response = _gemini_chat.send_message(full_message)
 
-    for _ in range(MAX_TOOL_ROUNDS):
+        for _ in range(MAX_TOOL_ROUNDS):
-        # Collect all function calls in this response
+            tool_calls = [
-        tool_calls = [
+                part.function_call
-            part.function_call
+                for candidate in response.candidates
+                for part in candidate.content.parts
+                if part.function_call is not None
+            ]
+            if not tool_calls:
+                break
+
+            function_responses = []
+            for fc in tool_calls:
+                if fc.name == TOOL_NAME:
+                    script = fc.args.get("script", "")
+                    output = _run_script(script, base_dir)
+                    function_responses.append(
+                        types.Part.from_function_response(
+                            name=TOOL_NAME,
+                            response={"output": output}
+                        )
+                    )
+
+            if not function_responses:
+                break
+
+            response = _gemini_chat.send_message(function_responses)
+
+        text_parts = [
+            part.text
             for candidate in response.candidates
             for part in candidate.content.parts
-            if part.function_call is not None
+            if hasattr(part, "text") and part.text
         ]
-        if not tool_calls:
+        return "\n".join(text_parts)
-            break
 
-        # Execute each tool call and collect results
+    except ProviderError:
-        function_responses = []
+        raise
-        for fc in tool_calls:
+    except Exception as exc:
-            if fc.name == TOOL_NAME:
+        raise _classify_gemini_error(exc) from exc
-                script = fc.args.get("script", "")
-                output = _run_script(script, base_dir)
-                function_responses.append(
-                    types.Part.from_function_response(
-                        name=TOOL_NAME,
-                        response={"output": output}
-                    )
-                )
-
-        if not function_responses:
-            break
-
-        response = _gemini_chat.send_message(function_responses)
-
-    # Extract text from final response
-    text_parts = [
-        part.text
-        for candidate in response.candidates
-        for part in candidate.content.parts
-        if hasattr(part, "text") and part.text
-    ]
-    return "\n".join(text_parts)
 
 # ------------------------------------------------------------------ anthropic
 
@@ -215,55 +319,58 @@ def _send_anthropic(md_content: str, user_message: str, base_dir: str) -> str:
     global _anthropic_history
     import anthropic
 
-    _ensure_anthropic_client()
+    try:
+        _ensure_anthropic_client()
 
-    full_message = f"<context>\n{md_content}\n</context>\n\n{user_message}"
+        full_message = f"<context>\n{md_content}\n</context>\n\n{user_message}"
-    _anthropic_history.append({"role": "user", "content": full_message})
+        _anthropic_history.append({"role": "user", "content": full_message})
 
-    for _ in range(MAX_TOOL_ROUNDS):
+        for _ in range(MAX_TOOL_ROUNDS):
-        response = _anthropic_client.messages.create(
+            response = _anthropic_client.messages.create(
-            model=_model,
+                model=_model,
-            max_tokens=8096,
+                max_tokens=8096,
-            tools=_ANTHROPIC_TOOLS,
+                tools=_ANTHROPIC_TOOLS,
-            messages=_anthropic_history
+                messages=_anthropic_history
-        )
+            )
 
-        # Always record the assistant turn
+            _anthropic_history.append({
-        _anthropic_history.append({
+                "role": "assistant",
-            "role": "assistant",
+                "content": response.content
-            "content": response.content
+            })
-        })
 
-        if response.stop_reason != "tool_use":
+            if response.stop_reason != "tool_use":
-            break
+                break
 
-        # Process tool calls
+            tool_results = []
-        tool_results = []
+            for block in response.content:
-        for block in response.content:
+                if block.type == "tool_use" and block.name == TOOL_NAME:
-            if block.type == "tool_use" and block.name == TOOL_NAME:
+                    script = block.input.get("script", "")
-                script = block.input.get("script", "")
+                    output = _run_script(script, base_dir)
-                output = _run_script(script, base_dir)
+                    tool_results.append({
-                tool_results.append({
+                        "type": "tool_result",
-                    "type": "tool_result",
+                        "tool_use_id": block.id,
-                    "tool_use_id": block.id,
+                        "content": output
-                    "content": output
+                    })
-                })
 
-        if not tool_results:
+            if not tool_results:
-            break
+                break
 
-        _anthropic_history.append({
+            _anthropic_history.append({
-            "role": "user",
+                "role": "user",
-            "content": tool_results
+                "content": tool_results
-        })
+            })
 
-    # Extract final text
+        text_parts = [
-    text_parts = [
+            block.text
-        block.text
+            for block in response.content
-        for block in response.content
+            if hasattr(block, "text") and block.text
-        if hasattr(block, "text") and block.text
+        ]
-    ]
+        return "\n".join(text_parts)
-    return "\n".join(text_parts)
+
+    except ProviderError:
+        raise
+    except Exception as exc:
+        raise _classify_anthropic_error(exc) from exc
 
 # ------------------------------------------------------------------ unified send
 
@@ -272,4 +379,4 @@ def send(md_content: str, user_message: str, base_dir: str = ".") -> str:
         return _send_gemini(md_content, user_message, base_dir)
     elif _provider == "anthropic":
         return _send_anthropic(md_content, user_message, base_dir)
-    raise ValueError(f"unknown provider: {_provider}")
+    raise ValueError(f"unknown provider: {_provider}")

gui.py

@@ -1,4 +1,4 @@
-import dearpygui.dearpygui as dpg
+import dearpygui.dearpygui as dpg
 import tomllib
 import tomli_w
 import threading
@@ -6,6 +6,7 @@ from pathlib import Path
 from tkinter import filedialog, Tk
 import aggregate
 import ai_client
+from ai_client import ProviderError
 import shell_runner
 
 CONFIG_PATH = Path("config.toml")
@@ -624,4 +625,4 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    main()