webscout 8.2.9__py3-none-any.whl → 2026.1.19__py3-none-any.whl

webscout/Provider/OPENAI/groq.py

@@ -1,364 +1,380 @@
-import requests
-import json
-import time
-import uuid
-from typing import List, Dict, Optional, Union, Generator, Any
-
-# Import curl_cffi for improved request handling
-from curl_cffi.requests import Session
-from curl_cffi import CurlError
-
-# Import base classes and utility structures
-from .base import OpenAICompatibleProvider, BaseChat, BaseCompletions
-from .utils import (
-    ChatCompletionChunk, ChatCompletion, Choice, ChoiceDelta,
-    ChatCompletionMessage, CompletionUsage
-)
-
-# Attempt to import LitAgent, fallback if not available
-try:
-    from webscout.litagent import LitAgent
-except ImportError:
-    pass
-
-# --- Groq Client ---
-
-class Completions(BaseCompletions):
-    def __init__(self, client: 'Groq'):
-        self._client = client
-
-    def create(
-        self,
-        *,
-        model: str,
-        messages: List[Dict[str, str]],
-        max_tokens: Optional[int] = 2049,
-        stream: bool = False,
-        temperature: Optional[float] = None,
-        top_p: Optional[float] = None,
-        **kwargs: Any
-    ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
-        """
-        Creates a model response for the given chat conversation.
-        Mimics openai.chat.completions.create
-        """
-        payload = {
-            "model": model,
-            "messages": messages,
-            "max_tokens": max_tokens,
-            "stream": stream,
-        }
-        if temperature is not None:
-            payload["temperature"] = temperature
-        if top_p is not None:
-            payload["top_p"] = top_p
-
-        # Add frequency_penalty and presence_penalty if provided
-        if "frequency_penalty" in kwargs:
-            payload["frequency_penalty"] = kwargs.pop("frequency_penalty")
-        if "presence_penalty" in kwargs:
-            payload["presence_penalty"] = kwargs.pop("presence_penalty")
-        
-        # Add any tools if provided
-        if "tools" in kwargs and kwargs["tools"]:
-            payload["tools"] = kwargs.pop("tools")
-
-        payload.update(kwargs)
-
-        request_id = f"chatcmpl-{uuid.uuid4()}"
-        created_time = int(time.time())
-
-        if stream:
-            return self._create_stream(request_id, created_time, model, payload)
-        else:
-            return self._create_non_stream(request_id, created_time, model, payload)
-
-    def _create_stream(
-        self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
-    ) -> Generator[ChatCompletionChunk, None, None]:
-        try:
-            response = self._client.session.post(
-                self._client.base_url,
-                json=payload,
-                stream=True,
-                timeout=self._client.timeout,
-                impersonate="chrome110"  # Use impersonate for better compatibility
-            )
-            
-            if response.status_code != 200:
-                raise IOError(f"Groq request failed with status code {response.status_code}: {response.text}")
-
-            # Track token usage across chunks
-            prompt_tokens = 0
-            completion_tokens = 0
-            total_tokens = 0
-
-            for line in response.iter_lines(decode_unicode=True):
-                if line:
-                    if line.startswith("data: "):
-                        json_str = line[6:]
-                        if json_str == "[DONE]":
-                            break
-
-                        try:
-                            data = json.loads(json_str)
-                            choice_data = data.get('choices', [{}])[0]
-                            delta_data = choice_data.get('delta', {})
-                            finish_reason = choice_data.get('finish_reason')
-
-                            # Update token counts if available
-                            usage_data = data.get('usage', {})
-                            if usage_data:
-                                prompt_tokens = usage_data.get('prompt_tokens', prompt_tokens)
-                                completion_tokens = usage_data.get('completion_tokens', completion_tokens)
-                                total_tokens = usage_data.get('total_tokens', total_tokens)
-
-                            # Create the delta object
-                            delta = ChoiceDelta(
-                                content=delta_data.get('content'),
-                                role=delta_data.get('role'),
-                                tool_calls=delta_data.get('tool_calls')
-                            )
-
-                            # Create the choice object
-                            choice = Choice(
-                                index=choice_data.get('index', 0),
-                                delta=delta,
-                                finish_reason=finish_reason,
-                                logprobs=choice_data.get('logprobs')
-                            )
-
-                            # Create the chunk object
-                            chunk = ChatCompletionChunk(
-                                id=request_id,
-                                choices=[choice],
-                                created=created_time,
-                                model=model,
-                                system_fingerprint=data.get('system_fingerprint')
-                            )
-
-                            # Convert chunk to dict using Pydantic's API
-                            if hasattr(chunk, "model_dump"):
-                                chunk_dict = chunk.model_dump(exclude_none=True)
-                            else:
-                                chunk_dict = chunk.dict(exclude_none=True)
-
-                            # Add usage information to match OpenAI format
-                            usage_dict = {
-                                "prompt_tokens": prompt_tokens or 10,
-                                "completion_tokens": completion_tokens or (len(delta_data.get('content', '')) if delta_data.get('content') else 0),
-                                "total_tokens": total_tokens or (10 + (len(delta_data.get('content', '')) if delta_data.get('content') else 0)),
-                                "estimated_cost": None
-                            }
-
-                            # Update completion_tokens and total_tokens as we receive more content
-                            if delta_data.get('content'):
-                                completion_tokens += 1
-                                total_tokens = prompt_tokens + completion_tokens
-                                usage_dict["completion_tokens"] = completion_tokens
-                                usage_dict["total_tokens"] = total_tokens
-
-                            chunk_dict["usage"] = usage_dict
-
-                            yield chunk
-                        except json.JSONDecodeError:
-                            print(f"Warning: Could not decode JSON line: {json_str}")
-                            continue
-        except CurlError as e:
-            print(f"Error during Groq stream request: {e}")
-            raise IOError(f"Groq request failed: {e}") from e
-        except Exception as e:
-            print(f"Error processing Groq stream: {e}")
-            raise
-
-    def _create_non_stream(
-        self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
-    ) -> ChatCompletion:
-        try:
-            response = self._client.session.post(
-                self._client.base_url,
-                json=payload,
-                timeout=self._client.timeout,
-                impersonate="chrome110"  # Use impersonate for better compatibility
-            )
-            
-            if response.status_code != 200:
-                raise IOError(f"Groq request failed with status code {response.status_code}: {response.text}")
-                
-            data = response.json()
-
-            choices_data = data.get('choices', [])
-            usage_data = data.get('usage', {})
-
-            choices = []
-            for choice_d in choices_data:
-                message_d = choice_d.get('message', {})
-                
-                # Handle tool calls if present
-                tool_calls = message_d.get('tool_calls')
-                
-                message = ChatCompletionMessage(
-                    role=message_d.get('role', 'assistant'),
-                    content=message_d.get('content', ''),
-                    tool_calls=tool_calls
-                )
-                choice = Choice(
-                    index=choice_d.get('index', 0),
-                    message=message,
-                    finish_reason=choice_d.get('finish_reason', 'stop')
-                )
-                choices.append(choice)
-
-            usage = CompletionUsage(
-                prompt_tokens=usage_data.get('prompt_tokens', 0),
-                completion_tokens=usage_data.get('completion_tokens', 0),
-                total_tokens=usage_data.get('total_tokens', 0)
-            )
-
-            completion = ChatCompletion(
-                id=request_id,
-                choices=choices,
-                created=created_time,
-                model=data.get('model', model),
-                usage=usage,
-            )
-            return completion
-
-        except CurlError as e:
-            print(f"Error during Groq non-stream request: {e}")
-            raise IOError(f"Groq request failed: {e}") from e
-        except Exception as e:
-            print(f"Error processing Groq response: {e}")
-            raise
-
-class Chat(BaseChat):
-    def __init__(self, client: 'Groq'):
-        self.completions = Completions(client)
-
-class Groq(OpenAICompatibleProvider):
-    AVAILABLE_MODELS = [
-        "distil-whisper-large-v3-en",
-        "gemma2-9b-it",
-        "llama-3.3-70b-versatile",
-        "llama-3.1-8b-instant",
-        "llama-guard-3-8b",
-        "llama3-70b-8192",
-        "llama3-8b-8192",
-        "whisper-large-v3",
-        "whisper-large-v3-turbo",
-        "meta-llama/llama-4-scout-17b-16e-instruct",
-        "meta-llama/llama-4-maverick-17b-128e-instruct",
-        "playai-tts",
-        "playai-tts-arabic",
-        "qwen-qwq-32b",
-        "mistral-saba-24b",
-        "qwen-2.5-coder-32b",
-        "qwen-2.5-32b",
-        "deepseek-r1-distill-qwen-32b",
-        "deepseek-r1-distill-llama-70b",
-        "llama-3.3-70b-specdec",
-        "llama-3.2-1b-preview",
-        "llama-3.2-3b-preview",
-        "llama-3.2-11b-vision-preview",
-        "llama-3.2-90b-vision-preview",
-        "mixtral-8x7b-32768"
-    ]
-
-    def __init__(self, api_key: str = None, timeout: Optional[int] = 30, browser: str = "chrome"):
-        self.timeout = timeout
-        self.base_url = "https://api.groq.com/openai/v1/chat/completions"
-        self.api_key = api_key
-        
-        # Initialize curl_cffi Session
-        self.session = Session()
-        
-        # Set up headers with API key if provided
-        self.headers = {
-            "Content-Type": "application/json",
-        }
-        
-        if api_key:
-            self.headers["Authorization"] = f"Bearer {api_key}"
-        
-        # Try to use LitAgent for browser fingerprinting
-        try:
-            agent = LitAgent()
-            fingerprint = agent.generate_fingerprint(browser)
-            
-            self.headers.update({
-                "Accept": fingerprint["accept"],
-                "Accept-Encoding": "gzip, deflate, br, zstd",
-                "Accept-Language": fingerprint["accept_language"],
-                "Cache-Control": "no-cache",
-                "Connection": "keep-alive",
-                "Origin": "https://console.groq.com",
-                "Pragma": "no-cache",
-                "Referer": "https://console.groq.com/",
-                "Sec-Fetch-Dest": "empty",
-                "Sec-Fetch-Mode": "cors",
-                "Sec-Fetch-Site": "same-site",
-                "Sec-CH-UA": fingerprint["sec_ch_ua"] or '"Not)A;Brand";v="99", "Microsoft Edge";v="127", "Chromium";v="127"',
-                "Sec-CH-UA-Mobile": "?0",
-                "Sec-CH-UA-Platform": f'"{fingerprint["platform"]}"',
-                "User-Agent": fingerprint["user_agent"],
-            })
-        except (NameError, Exception):
-            # Fallback to basic headers if LitAgent is not available
-            self.headers.update({
-                "Accept": "application/json",
-                "Accept-Encoding": "gzip, deflate, br",
-                "Accept-Language": "en-US,en;q=0.9",
-                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-            })
-        
-        # Update session headers
-        self.session.headers.update(self.headers)
-        
-        # Initialize chat interface
-        self.chat = Chat(self)
-    
-    @classmethod
-    def get_models(cls, api_key: str = None):
-        """Fetch available models from Groq API.
-        
-        Args:
-            api_key (str, optional): Groq API key. If not provided, returns default models.
-            
-        Returns:
-            list: List of available model IDs
-        """
-        if not api_key:
-            return cls.AVAILABLE_MODELS
-            
-        try:
-            # Use a temporary curl_cffi session for this class method
-            temp_session = Session()
-            headers = {
-                "Content-Type": "application/json",
-                "Authorization": f"Bearer {api_key}",
-            }
-            
-            response = temp_session.get(
-                "https://api.groq.com/openai/v1/models",
-                headers=headers,
-                impersonate="chrome110"  # Use impersonate for fetching
-            )
-            
-            if response.status_code != 200:
-                return cls.AVAILABLE_MODELS
-                
-            data = response.json()
-            if "data" in data and isinstance(data["data"], list):
-                return [model["id"] for model in data["data"]]
-            return cls.AVAILABLE_MODELS
-            
-        except (CurlError, Exception):
-            # Fallback to default models list if fetching fails
-            return cls.AVAILABLE_MODELS
-
-    @property
-    def models(self):
-        class _ModelList:
-            def list(inner_self):
-                return type(self).AVAILABLE_MODELS
-        return _ModelList()
+import json
+import time
+import uuid
+from typing import Any, Dict, Generator, List, Optional, Union, cast
+
+from curl_cffi import CurlError
+
+# Import curl_cffi for improved request handling
+from curl_cffi.requests import Session
+
+# Attempt to import LitAgent, fallback if not available
+from ...litagent import LitAgent
+
+# Import base classes and utility structures
+from .base import BaseChat, BaseCompletions, OpenAICompatibleProvider, SimpleModelList
+from .utils import (
+    ChatCompletion,
+    ChatCompletionChunk,
+    ChatCompletionMessage,
+    Choice,
+    ChoiceDelta,
+    CompletionUsage,
+)
+
+# --- Groq Client ---
+
+class Completions(BaseCompletions):
+    def __init__(self, client: 'Groq'):
+        self._client = client
+
+    def create(
+        self,
+        *,
+        model: str,
+        messages: List[Dict[str, str]],
+        max_tokens: Optional[int] = 2049,
+        stream: bool = False,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        **kwargs: Any
+    ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
+        """
+        Creates a model response for the given chat conversation.
+        Mimics openai.chat.completions.create
+        """
+        payload = {
+            "model": model,
+            "messages": messages,
+            "max_tokens": max_tokens,
+            "stream": stream,
+        }
+        if temperature is not None:
+            payload["temperature"] = temperature
+        if top_p is not None:
+            payload["top_p"] = top_p
+
+        # Add frequency_penalty and presence_penalty if provided
+        if "frequency_penalty" in kwargs:
+            payload["frequency_penalty"] = kwargs.pop("frequency_penalty")
+        if "presence_penalty" in kwargs:
+            payload["presence_penalty"] = kwargs.pop("presence_penalty")
+
+        # Add any tools if provided
+        if "tools" in kwargs and kwargs["tools"]:
+            payload["tools"] = kwargs.pop("tools")
+
+        payload.update(kwargs)
+
+        request_id = f"chatcmpl-{uuid.uuid4()}"
+        created_time = int(time.time())
+
+        if stream:
+            return self._create_stream(request_id, created_time, model, payload)
+        else:
+            return self._create_non_stream(request_id, created_time, model, payload)
+
+    def _create_stream(
+        self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
+    ) -> Generator[ChatCompletionChunk, None, None]:
+        try:
+            response = self._client.session.post(
+                self._client.base_url,
+                json=payload,
+                stream=True,
+                timeout=self._client.timeout,
+                impersonate="chrome110"  # Use impersonate for better compatibility
+            )
+
+            if response.status_code != 200:
+                raise IOError(f"Groq request failed with status code {response.status_code}: {response.text}")
+
+            # Track token usage across chunks
+            prompt_tokens = 0
+            completion_tokens = 0
+            total_tokens = 0
+
+            for line in response.iter_lines(decode_unicode=True):
+                if line:
+                    if line.startswith("data: "):
+                        json_str = line[6:]
+                        if json_str == "[DONE]":
+                            break
+
+                        try:
+                            data = json.loads(json_str)
+                            choices = data.get('choices')
+                            if not choices and choices is not None:
+                                continue
+                            choice_data = choices[0] if choices else {}
+                            delta_data = choice_data.get('delta', {})
+                            finish_reason = choice_data.get('finish_reason')
+
+                            # Update token counts if available
+                            usage_data = data.get('usage', {})
+                            if usage_data:
+                                prompt_tokens = usage_data.get('prompt_tokens', prompt_tokens)
+                                completion_tokens = usage_data.get('completion_tokens', completion_tokens)
+                                total_tokens = usage_data.get('total_tokens', total_tokens)
+
+                            # Create the delta object
+                            delta = ChoiceDelta(
+                                content=delta_data.get('content'),
+                                role=delta_data.get('role'),
+                                tool_calls=delta_data.get('tool_calls')
+                            )
+
+                            # Create the choice object
+                            choice = Choice(
+                                index=choice_data.get('index', 0),
+                                delta=delta,
+                                finish_reason=finish_reason,
+                                logprobs=choice_data.get('logprobs')
+                            )
+
+                            # Create the chunk object
+                            chunk = ChatCompletionChunk(
+                                id=request_id,
+                                choices=[choice],
+                                created=created_time,
+                                model=model,
+                                system_fingerprint=data.get('system_fingerprint')
+                            )
+
+                            # Convert chunk to dict using Pydantic's API
+                            if hasattr(chunk, "model_dump"):
+                                chunk_dict = chunk.model_dump(exclude_none=True)
+                            else:
+                                chunk_dict = chunk.dict(exclude_none=True)
+
+                            # Add usage information to match OpenAI format
+                            usage_dict = {
+                                "prompt_tokens": prompt_tokens or 10,
+                                "completion_tokens": completion_tokens or (len(delta_data.get('content', '')) if delta_data.get('content') else 0),
+                                "total_tokens": total_tokens or (10 + (len(delta_data.get('content', '')) if delta_data.get('content') else 0)),
+                                "estimated_cost": None
+                            }
+
+                            # Update completion_tokens and total_tokens as we receive more content
+                            if delta_data.get('content'):
+                                completion_tokens += 1
+                                total_tokens = prompt_tokens + completion_tokens
+                                usage_dict["completion_tokens"] = completion_tokens
+                                usage_dict["total_tokens"] = total_tokens
+
+                            chunk_dict["usage"] = usage_dict
+
+                            yield chunk
+                        except json.JSONDecodeError:
+                            print(f"Warning: Could not decode JSON line: {json_str}")
+                            continue
+        except CurlError as e:
+            print(f"Error during Groq stream request: {e}")
+            raise IOError(f"Groq request failed: {e}") from e
+        except Exception as e:
+            print(f"Error processing Groq stream: {e}")
+            raise
+
+    def _create_non_stream(
+        self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
+    ) -> ChatCompletion:
+        try:
+            response = self._client.session.post(
+                self._client.base_url,
+                json=payload,
+                timeout=self._client.timeout,
+                impersonate="chrome110"  # Use impersonate for better compatibility
+            )
+
+            if response.status_code != 200:
+                raise IOError(f"Groq request failed with status code {response.status_code}: {response.text}")
+
+            data = response.json()
+
+            choices_data = data.get('choices', [])
+            usage_data = data.get('usage', {})
+
+            choices = []
+            for choice_d in choices_data:
+                message_d = choice_d.get('message', {})
+
+                # Handle tool calls if present
+                tool_calls = message_d.get('tool_calls')
+
+                message = ChatCompletionMessage(
+                    role=message_d.get('role', 'assistant'),
+                    content=message_d.get('content', ''),
+                    tool_calls=tool_calls
+                )
+                choice = Choice(
+                    index=choice_d.get('index', 0),
+                    message=message,
+                    finish_reason=choice_d.get('finish_reason', 'stop')
+                )
+                choices.append(choice)
+
+            usage = CompletionUsage(
+                prompt_tokens=usage_data.get('prompt_tokens', 0),
+                completion_tokens=usage_data.get('completion_tokens', 0),
+                total_tokens=usage_data.get('total_tokens', 0)
+            )
+
+            completion = ChatCompletion(
+                id=request_id,
+                choices=choices,
+                created=created_time,
+                model=data.get('model', model),
+                usage=usage,
+            )
+            return completion
+
+        except CurlError as e:
+            print(f"Error during Groq non-stream request: {e}")
+            raise IOError(f"Groq request failed: {e}") from e
+        except Exception as e:
+            print(f"Error processing Groq response: {e}")
+            raise
+
+class Chat(BaseChat):
+    def __init__(self, client: 'Groq'):
+        self.completions = Completions(client)
+
+class Groq(OpenAICompatibleProvider):
+    required_auth = True
+    AVAILABLE_MODELS = [
+        "distil-whisper-large-v3-en",
+        "gemma2-9b-it",
+        "llama-3.3-70b-versatile",
+        "llama-3.1-8b-instant",
+        "llama-guard-3-8b",
+        "llama3-70b-8192",
+        "llama3-8b-8192",
+        "whisper-large-v3",
+        "whisper-large-v3-turbo",
+        "meta-llama/llama-4-scout-17b-16e-instruct",
+        "meta-llama/llama-4-maverick-17b-128e-instruct",
+        "playai-tts",
+        "playai-tts-arabic",
+        "qwen-qwq-32b",
+        "mistral-saba-24b",
+        "qwen-2.5-coder-32b",
+        "qwen-2.5-32b",
+        "deepseek-r1-distill-qwen-32b",
+        "deepseek-r1-distill-llama-70b",
+        "llama-3.3-70b-specdec",
+        "llama-3.2-1b-preview",
+        "llama-3.2-3b-preview",
+        "llama-3.2-11b-vision-preview",
+        "llama-3.2-90b-vision-preview",
+        "mixtral-8x7b-32768"
+    ]
+
+    def __init__(self, api_key: Optional[str] = None, timeout: Optional[int] = 30, browser: str = "chrome"):
+        self.timeout = timeout
+        self.base_url = "https://api.groq.com/openai/v1/chat/completions"
+        self.api_key = api_key
+
+        # Update available models from API
+        self.update_available_models(api_key)
+
+        # Initialize curl_cffi Session
+        self.session = Session()
+
+        # Set up headers with API key if provided
+        self.headers = {
+            "Content-Type": "application/json",
+        }
+
+        if api_key:
+            self.headers["Authorization"] = f"Bearer {api_key}"
+
+        # Try to use LitAgent for browser fingerprinting
+        try:
+            agent = LitAgent()
+            fingerprint = agent.generate_fingerprint(browser)
+
+            self.headers.update({
+                "Accept": fingerprint["accept"],
+                "Accept-Encoding": "gzip, deflate, br, zstd",
+                "Accept-Language": fingerprint["accept_language"],
+                "Cache-Control": "no-cache",
+                "Connection": "keep-alive",
+                "Origin": "https://console.groq.com",
+                "Pragma": "no-cache",
+                "Referer": "https://console.groq.com/",
+                "Sec-Fetch-Dest": "empty",
+                "Sec-Fetch-Mode": "cors",
+                "Sec-Fetch-Site": "same-site",
+                "Sec-CH-UA": fingerprint["sec_ch_ua"] or '"Not)A;Brand";v="99", "Microsoft Edge";v="127", "Chromium";v="127"',
+                "Sec-CH-UA-Mobile": "?0",
+                "Sec-CH-UA-Platform": f'"{fingerprint["platform"]}"',
+                "User-Agent": fingerprint["user_agent"],
+            })
+        except (NameError, Exception):
+            # Fallback to basic headers if LitAgent is not available
+            self.headers.update({
+                "Accept": "application/json",
+                "Accept-Encoding": "gzip, deflate, br",
+                "Accept-Language": "en-US,en;q=0.9",
+                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+            })
+
+        # Update session headers
+        self.session.headers.update(self.headers)
+
+        # Initialize chat interface
+        self.chat = Chat(self)
+
+    @classmethod
+    def get_models(cls, api_key: Optional[str] = None):
+        """Fetch available models from Groq API.
+
+        Args:
+            api_key (str, optional): Groq API key. If not provided, returns default models.
+
+        Returns:
+            list: List of available model IDs
+        """
+        if not api_key:
+            return cls.AVAILABLE_MODELS
+
+        try:
+            # Use a temporary curl_cffi session for this class method
+            temp_session = Session()
+            headers = {
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {api_key}",
+            }
+
+            response = temp_session.get(
+                "https://api.groq.com/openai/v1/models",
+                headers=headers,
+                impersonate="chrome110"  # Use impersonate for fetching
+            )
+
+            if response.status_code != 200:
+                return cls.AVAILABLE_MODELS
+
+            data = response.json()
+            if "data" in data and isinstance(data["data"], list):
+                return [model["id"] for model in data["data"]]
+            return cls.AVAILABLE_MODELS
+
+        except (CurlError, Exception):
+            # Fallback to default models list if fetching fails
+            return cls.AVAILABLE_MODELS
+
+    @classmethod
+    def update_available_models(cls, api_key: Optional[str] = None):
+        """Update the available models list from Groq API"""
+        try:
+            models = cls.get_models(api_key)
+            if models and len(models) > 0:
+                cls.AVAILABLE_MODELS = models
+        except Exception:
+            # Fallback to default models list if fetching fails
+            pass
+
+    @property
+    def models(self) -> SimpleModelList:
+        return SimpleModelList(type(self).AVAILABLE_MODELS)