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

webscout/Provider/OPENAI/textpollinations.py

@@ -1,26 +1,46 @@
+"""
+TextPollinations OpenAI-compatible provider.
+https://text.pollinations.ai/openai
+"""
+
+import json
 import time
 import uuid
+from typing import Any, Dict, Generator, List, Optional, Union, cast
+
 import requests
-import json
-from typing import List, Dict, Optional, Union, Generator, Any
 
-# Import base classes and utility structures
-from .base import OpenAICompatibleProvider, BaseChat, BaseCompletions
-from .utils import (
-    ChatCompletionChunk, ChatCompletion, Choice, ChoiceDelta,
-    ChatCompletionMessage, CompletionUsage
+from webscout.Provider.OPENAI.base import (
+    BaseChat,
+    BaseCompletions,
+    OpenAICompatibleProvider,
+    SimpleModelList,
+)
+from webscout.Provider.OPENAI.utils import (
+    ChatCompletion,
+    ChatCompletionChunk,
+    ChatCompletionMessage,
+    Choice,
+    ChoiceDelta,
+    CompletionUsage,
+    ToolCall,
+    ToolFunction,
+    count_tokens,
 )
 
-# Import LitAgent for browser fingerprinting
-from webscout.litagent import LitAgent
+from ...litagent import LitAgent
 
-# ANSI escape codes for formatting
 BOLD = "\033[1m"
 RED = "\033[91m"
 RESET = "\033[0m"
 
+
 class Completions(BaseCompletions):
-    def __init__(self, client: 'TextPollinations'):
+    """
+    Handles chat completion requests for TextPollinations.
+    """
+
+    def __init__(self, client: "TextPollinations"):
         self._client = client
 
     def create(
@@ -32,11 +52,15 @@ class Completions(BaseCompletions):
         stream: bool = False,
         temperature: Optional[float] = None,
         top_p: Optional[float] = None,
-        **kwargs: Any
+        tools: Optional[List[Union[Any, Dict[str, Any]]]] = None,
+        tool_choice: Optional[Union[str, Dict[str, Any]]] = None,
+        timeout: Optional[int] = None,
+        proxies: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
     ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
         """
         Creates a model response for the given chat conversation.
-        Mimics openai.chat.completions.create
+        Mimics openai.chat.completions.create.
         """
         payload = {
             "model": model,
@@ -49,6 +73,10 @@ class Completions(BaseCompletions):
             payload["temperature"] = temperature
         if top_p is not None:
             payload["top_p"] = top_p
+        if tools is not None:
+            payload["tools"] = tools
+        if tool_choice is not None:
+            payload["tool_choice"] = tool_choice
 
         payload.update(kwargs)
 
@@ -56,71 +84,96 @@ class Completions(BaseCompletions):
         created_time = int(time.time())
 
         if stream:
-            return self._create_streaming(request_id, created_time, model, payload)
+            return self._create_streaming(
+                request_id, created_time, model, payload, timeout, proxies
+            )
         else:
-            return self._create_non_streaming(request_id, created_time, model, payload)
+            return self._create_non_streaming(
+                request_id, created_time, model, payload, timeout, proxies
+            )
 
     def _create_streaming(
         self,
         request_id: str,
         created_time: int,
         model: str,
-        payload: Dict[str, Any]
+        payload: Dict[str, Any],
+        timeout: Optional[int] = None,
+        proxies: Optional[Dict[str, str]] = None,
     ) -> Generator[ChatCompletionChunk, None, None]:
-        """Implementation for streaming chat completions."""
+        """
+        Implementation for streaming chat completions using SSE.
+        """
         try:
-
-            # Make the streaming request
             response = self._client.session.post(
                 self._client.api_endpoint,
                 headers=self._client.headers,
                 json=payload,
                 stream=True,
-                timeout=self._client.timeout
+                timeout=timeout or self._client.timeout,
+                proxies=proxies or getattr(self._client, "proxies", None),
             )
 
             if not response.ok:
-                raise IOError(f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}")
-
-            # Process the streaming response
-            full_response = ""
+                raise IOError(
+                    f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
+                )
 
             for line in response.iter_lines():
                 if line:
-                    line = line.decode('utf-8').strip()
+                    line = line.decode("utf-8").strip()
                     if line == "data: [DONE]":
                         break
-                    if line.startswith('data: '):
+                    if line.startswith("data: "):
                         try:
                             json_data = json.loads(line[6:])
-                            if 'choices' in json_data and len(json_data['choices']) > 0:
-                                choice = json_data['choices'][0]
-                                if 'delta' in choice and 'content' in choice['delta']:
-                                    content = choice['delta']['content']
-                                    full_response += content
-
-                                    # Create and yield a chunk
-                                    delta = ChoiceDelta(content=content)
-                                    choice = Choice(index=0, delta=delta, finish_reason=None)
+                            if "choices" in json_data and len(json_data["choices"]) > 0:
+                                choice = json_data["choices"][0]
+                                if "delta" in choice:
+                                    delta_obj = ChoiceDelta()
+
+                                    if "content" in choice["delta"]:
+                                        content = choice["delta"]["content"]
+                                        delta_obj.content = content
+
+                                    if "tool_calls" in choice["delta"]:
+                                        tool_calls = []
+                                        for tool_call_data in choice["delta"]["tool_calls"]:
+                                            if "function" in tool_call_data:
+                                                function = ToolFunction(
+                                                    name=tool_call_data["function"].get("name", ""),
+                                                    arguments=tool_call_data["function"].get(
+                                                        "arguments", ""
+                                                    ),
+                                                )
+                                                tool_call = ToolCall(
+                                                    id=tool_call_data.get("id", str(uuid.uuid4())),
+                                                    type=tool_call_data.get("type", "function"),
+                                                    function=function,
+                                                )
+                                                tool_calls.append(tool_call)
+
+                                        if tool_calls:
+                                            delta_obj.tool_calls = tool_calls
+
+                                    choice_obj = Choice(
+                                        index=0, delta=delta_obj, finish_reason=None
+                                    )
                                     chunk = ChatCompletionChunk(
                                         id=request_id,
-                                        choices=[choice],
+                                        choices=[choice_obj],
                                         created=created_time,
-                                        model=model
+                                        model=model,
                                     )
 
                                     yield chunk
                         except json.JSONDecodeError:
                             continue
 
-            # Final chunk with finish_reason
             delta = ChoiceDelta(content=None)
             choice = Choice(index=0, delta=delta, finish_reason="stop")
             chunk = ChatCompletionChunk(
-                id=request_id,
-                choices=[choice],
-                created=created_time,
-                model=model
+                id=request_id, choices=[choice], created=created_time, model=model
             )
 
             yield chunk
@@ -134,57 +187,69 @@ class Completions(BaseCompletions):
         request_id: str,
         created_time: int,
         model: str,
-        payload: Dict[str, Any]
+        payload: Dict[str, Any],
+        timeout: Optional[int] = None,
+        proxies: Optional[Dict[str, str]] = None,
     ) -> ChatCompletion:
-        """Implementation for non-streaming chat completions."""
+        """
+        Implementation for non-streaming chat completions.
+        """
         try:
-
-            # Make the non-streaming request
             response = self._client.session.post(
                 self._client.api_endpoint,
                 headers=self._client.headers,
                 json=payload,
-                timeout=self._client.timeout
+                timeout=timeout or self._client.timeout,
+                proxies=proxies or getattr(self._client, "proxies", None),
             )
 
             if not response.ok:
-                raise IOError(f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}")
+                raise IOError(
+                    f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
+                )
 
-            # Parse the response
             response_json = response.json()
 
-            # Extract the content
-            if 'choices' in response_json and len(response_json['choices']) > 0:
-                if 'message' in response_json['choices'][0]:
-                    full_content = response_json['choices'][0]['message']['content']
-                else:
-                    full_content = ""
-            else:
-                full_content = ""
-
-            # Create the completion message
-            message = ChatCompletionMessage(
-                role="assistant",
-                content=full_content
-            )
-
-            # Create the choice
-            choice = Choice(
-                index=0,
-                message=message,
-                finish_reason="stop"
+            full_content = ""
+            message = ChatCompletionMessage(role="assistant", content="")
+
+            if "choices" in response_json and len(response_json["choices"]) > 0:
+                choice_data = response_json["choices"][0]
+                if "message" in choice_data:
+                    message_data = choice_data["message"]
+                    full_content = message_data.get("content", "")
+                    message = ChatCompletionMessage(role="assistant", content=full_content)
+
+                    if "tool_calls" in message_data:
+                        tool_calls = []
+                        for tool_call_data in message_data["tool_calls"]:
+                            if "function" in tool_call_data:
+                                function = ToolFunction(
+                                    name=tool_call_data["function"].get("name", ""),
+                                    arguments=tool_call_data["function"].get("arguments", ""),
+                                )
+                                tool_call = ToolCall(
+                                    id=tool_call_data.get("id", str(uuid.uuid4())),
+                                    type=tool_call_data.get("type", "function"),
+                                    function=function,
+                                )
+                                tool_calls.append(tool_call)
+
+                        if tool_calls:
+                            message.tool_calls = tool_calls
+
+            choice = Choice(index=0, message=message, finish_reason="stop")
+
+            prompt_tokens = count_tokens(
+                [msg.get("content", "") for msg in payload.get("messages", [])]
             )
-
-            # Estimate token usage (very rough estimate)
-            prompt_tokens = sum(len(msg.get("content", "")) // 4 for msg in payload.get("messages", []))
-            completion_tokens = len(full_content) // 4
+            completion_tokens = count_tokens(full_content)
             usage = CompletionUsage(
                 prompt_tokens=prompt_tokens,
                 completion_tokens=completion_tokens,
-                total_tokens=prompt_tokens + completion_tokens
+                total_tokens=prompt_tokens + completion_tokens,
             )
 
-            # Create the completion object
             completion = ChatCompletion(
                 id=request_id,
                 choices=[choice],
@@ -199,87 +264,107 @@ class Completions(BaseCompletions):
             print(f"{RED}Error during TextPollinations non-stream request: {e}{RESET}")
             raise IOError(f"TextPollinations request failed: {e}") from e
 
+
 class Chat(BaseChat):
-    def __init__(self, client: 'TextPollinations'):
+    """
+    Standard chat interface for the provider.
+    """
+
+    def __init__(self, client: "TextPollinations"):
         self.completions = Completions(client)
 
+
 class TextPollinations(OpenAICompatibleProvider):
     """
     OpenAI-compatible client for TextPollinations API.
-
-    Usage:
-        client = TextPollinations()
-        response = client.chat.completions.create(
-            model="openai-large",
-            messages=[{"role": "user", "content": "Hello!"}]
-        )
-        print(response.choices[0].message.content)
+    Provides free access to various models including GPT variants and open-source models.
     """
 
-    AVAILABLE_MODELS = [
-        "openai",
-        "openai-large",
-        "openai-reasoning",
-        "qwen-coder",
-        "llama",
-        "llamascout",
-        "mistral",
-        "unity",
-        "midijourney",
-        "rtist",
-        "searchgpt",
-        "evil",
-        "deepseek-reasoning",
-        "deepseek-reasoning-large",
-        "llamalight",
-        "phi",
-        "llama-vision",
-        "pixtral",
-        "gemini",
-        "hormoz",
-        "hypnosis-tracy",
-        "mistral-roblox",
-        "roblox-rp",
-        "deepseek",
-        "sur",
-        "llama-scaleway",
-        "openai-audio",
-    ]
-
-    def __init__(
-        self,
-        timeout: int = 30,
-        proxies: dict = {}
-    ):
+    required_auth = False
+
+    AVAILABLE_MODELS = ["openai", "mistral", "p1", "unity"]
+
+    @classmethod
+    def get_models(cls, api_key: Optional[str] = None) -> List[str]:
         """
-        Initialize the TextPollinations client.
+        Fetch available models from TextPollinations API.
+        """
+        try:
+            response = requests.get(
+                "https://text.pollinations.ai/models",
+                headers={"Accept": "application/json"},
+                timeout=30,
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                if isinstance(data, list):
+                    return [
+                        model.get("name")
+                        for model in data
+                        if isinstance(model, dict) and "name" in model
+                    ]
+
+            return cls.AVAILABLE_MODELS
+
+        except Exception:
+            return cls.AVAILABLE_MODELS
 
-        Args:
-            timeout: Request timeout in seconds
-            proxies: Optional proxy configuration
+    def __init__(self, timeout: int = 30, proxies: dict = {}):
+        """
+        Initialize the TextPollinations client.
         """
         self.timeout = timeout
         self.api_endpoint = "https://text.pollinations.ai/openai"
         self.proxies = proxies
 
-        # Initialize session
+        self.update_available_models()
+
         self.session = requests.Session()
         if proxies:
-            self.session.proxies.update(proxies)
+            self.session.proxies.update(cast(Any, proxies))
 
-        # Initialize LitAgent for user agent generation
         agent = LitAgent()
         self.user_agent = agent.random()
 
-        # Set headers
         self.headers = {
-            'Accept': '*/*',
-            'Accept-Language': 'en-US,en;q=0.9',
-            'User-Agent': self.user_agent,
-            'Content-Type': 'application/json',
+            "Accept": "*/*",
+            "Accept-Language": "en-US,en;q=0.9",
+            "User-Agent": self.user_agent,
+            "Content-Type": "application/json",
         }
 
         self.session.headers.update(self.headers)
-
-        # Initialize chat interface
         self.chat = Chat(self)
+
+    @classmethod
+    def update_available_models(cls, api_key: Optional[str] = None):
+        """
+        Update the available models list from the API.
+        """
+        models = cls.get_models(api_key)
+        if models:
+            cls.AVAILABLE_MODELS = models
+
+    @property
+    def models(self) -> SimpleModelList:
+        return SimpleModelList(type(self).AVAILABLE_MODELS)
+
+
+if __name__ == "__main__":
+    client = TextPollinations()
+    if client.models.list():
+        print(f"Available models: {client.models.list()}")
+        model_to_use = client.models.list()[0]
+        print(f"Testing model: {model_to_use}")
+        try:
+            response = client.chat.completions.create(
+                model=model_to_use, messages=[{"role": "user", "content": "Hello!"}]
+            )
+            if isinstance(response, ChatCompletion):
+                if response.choices[0].message and response.choices[0].message.content:
+                    print(response.choices[0].message.content)
+        except Exception as e:
+            print(f"Error testing model: {e}")
+    else:
+        print("No models available.")