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

webscout/Provider/OPENAI/mcpcore.py

@@ -1,389 +0,0 @@
-import time
-import uuid
-import json
-from typing import List, Dict, Optional, Union, Generator, Any
-
-# Use curl_cffi for requests
-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
-)
-
-# Import LitAgent for user agent generation
-try:
-    from webscout.litagent import LitAgent
-except ImportError:
-    # Define a dummy LitAgent if webscout is not installed or accessible
-    class LitAgent:
-        def random(self) -> str:
-            # Return a default user agent if LitAgent is unavailable
-            print("Warning: LitAgent not found. Using default minimal headers.")
-            return "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36"
-
-# ANSI escape codes for formatting
-BOLD = "\033[1m"
-RED = "\033[91m"
-RESET = "\033[0m"
-
-class Completions(BaseCompletions):
-    def __init__(self, client: 'MCPCore'):
-        self._client = client
-
-    def create(
-        self,
-        *,
-        model: str,
-        messages: List[Dict[str, str]],
-        max_tokens: Optional[int] = None,
-        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 using MCPCore API.
-        Mimics openai.chat.completions.create
-        """
-        if model not in self._client.AVAILABLE_MODELS:
-            raise ValueError(f"Model '{model}' not supported by MCPCore. Available: {self._client.AVAILABLE_MODELS}")
-
-        # Construct the MCPCore-specific payload
-        payload = {
-            "stream": stream,
-            "model": model,
-            "messages": messages,
-            "params": kwargs.get("params", {}),
-            "tool_servers": kwargs.get("tool_servers", []),
-            "features": kwargs.get("features", {"web_search": False}),
-            "chat_id": kwargs.get("chat_id", str(uuid.uuid4())),
-            "id": str(uuid.uuid4()), # Message ID
-            "stream_options": kwargs.get("stream_options", {"include_usage": True})
-        }
-
-        # Add optional OpenAI params to MCPCore's 'params' field if provided
-        if temperature is not None: payload["params"]["temperature"] = temperature
-        if top_p is not None: payload["params"]["top_p"] = top_p
-        if max_tokens is not None: payload["params"]["max_tokens"] = max_tokens
-
-        # Generate standard OpenAI-compatible IDs
-        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_from_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]:
-        """Handles the streaming response from MCPCore."""
-        final_usage_data = None # To store usage if received
-        try:
-            response = self._client.session.post(
-                self._client.api_endpoint,
-                headers=self._client.headers,
-                json=payload,
-                stream=True,
-                timeout=self._client.timeout,
-                impersonate="chrome110" # Impersonation often helps
-            )
-
-            if not response.ok:
-                try:
-                    error_text = response.text
-                except Exception:
-                    error_text = "<Failed to read error response>"
-                raise IOError(
-                    f"MCPCore API Error: {response.status_code} {response.reason} - {error_text}"
-                 )
-
-            for line_bytes in response.iter_lines():
-                if line_bytes:
-                    try:
-                        line = line_bytes.decode('utf-8').strip()
-                        if line.startswith("data: "):
-                            json_str = line[6:]
-                            if json_str == "[DONE]":
-                                break # End of stream signal
-
-                            json_data = json.loads(json_str)
-
-                            # Check for usage data in the chunk (often comes near the end)
-                            if 'usage' in json_data and json_data['usage']:
-                                final_usage_data = json_data['usage']
-                                # Don't yield a chunk just for usage, wait for content or final chunk
-
-                            if 'choices' in json_data and len(json_data['choices']) > 0:
-                                choice_data = json_data['choices'][0]
-                                delta_data = choice_data.get('delta', {})
-                                finish_reason = choice_data.get('finish_reason')
-                                content = delta_data.get('content')
-                                role = delta_data.get('role', 'assistant') # Default role
-
-                                # Only yield chunks with content or finish reason
-                                if content is not None or finish_reason:
-                                    delta = ChoiceDelta(content=content, role=role)
-                                    choice = Choice(index=0, delta=delta, finish_reason=finish_reason)
-                                    chunk = ChatCompletionChunk(
-                                        id=request_id,
-                                        choices=[choice],
-                                        created=created_time,
-                                        model=model,
-                                        system_fingerprint=json_data.get('system_fingerprint')
-                                    )
-                                    yield chunk
-
-                    except (json.JSONDecodeError, UnicodeDecodeError):
-                        print(f"{RED}Warning: Could not decode JSON line: {line}{RESET}")
-                        continue
-                    except Exception as e:
-                         print(f"{RED}Error processing stream line: {e} - Line: {line}{RESET}")
-                         continue
-
-            # Final chunk to ensure stream termination is signaled correctly
-            # (even if [DONE] was received, this confirms the generator end)
-            final_delta = ChoiceDelta()
-            # Include usage in the final chunk if available
-            usage_obj = None
-            if final_usage_data:
-                 usage_obj = CompletionUsage(
-                     prompt_tokens=final_usage_data.get('prompt_tokens', 0),
-                     completion_tokens=final_usage_data.get('completion_tokens', 0),
-                     total_tokens=final_usage_data.get('total_tokens', 0),
-                 )
-
-            final_choice = Choice(index=0, delta=final_delta, finish_reason="stop")
-            final_chunk = ChatCompletionChunk(
-                id=request_id,
-                choices=[final_choice],
-                created=created_time,
-                model=model,
-                # system_fingerprint=..., # Can be added if available in final event
-            )
-            # Add usage to the final chunk dictionary representation if available
-            if hasattr(final_chunk, "model_dump"):
-                final_chunk_dict = final_chunk.model_dump(exclude_none=True)
-            else:
-                final_chunk_dict = final_chunk.dict(exclude_none=True)
-            if usage_obj:
-                if hasattr(usage_obj, "model_dump"):
-                    final_chunk_dict["usage"] = usage_obj.model_dump(exclude_none=True)
-                else:
-                    final_chunk_dict["usage"] = usage_obj.dict(exclude_none=True)
-
-            # Yield the final dictionary or object as needed by downstream consumers
-            # Yielding the object aligns better with the generator type hint
-            yield final_chunk
-
-
-        except CurlError as e:
-            print(f"{RED}CurlError during MCPCore stream request: {e}{RESET}")
-            raise IOError(f"MCPCore request failed due to network/curl issue: {e}") from e
-        except Exception as e:
-            print(f"{RED}Unexpected error during MCPCore stream: {e}{RESET}")
-            error_details = ""
-            if hasattr(e, 'response') and e.response is not None:
-                error_details = f" - Status: {e.response.status_code}, Response: {e.response.text}"
-            raise IOError(f"MCPCore stream processing failed: {e}{error_details}") from e
-
-    def _create_non_stream_from_stream(
-        self, request_id: str, created_time: int, model: str, payload: Dict[str, Any]
-    ) -> ChatCompletion:
-        """Handles the non-streaming response by making a single POST request (like deepinfra)."""
-        try:
-            # Ensure stream is False for non-streaming
-            payload = dict(payload)
-            payload["stream"] = False
-
-            response = self._client.session.post(
-                self._client.api_endpoint,
-                headers=self._client.headers,
-                json=payload,
-                timeout=self._client.timeout,
-                impersonate="chrome110"
-            )
-            if not response.ok:
-                try:
-                    error_text = response.text
-                except Exception:
-                    error_text = "<Failed to read error response>"
-                raise IOError(
-                    f"MCPCore API Error: {response.status_code} {response.reason} - {error_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', {})
-                message = ChatCompletionMessage(
-                    role=message_d.get('role', 'assistant'),
-                    content=message_d.get('content', '')
-                )
-                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"{RED}CurlError during MCPCore non-stream request: {e}{RESET}")
-            raise IOError(f"MCPCore request failed due to network/curl issue: {e}") from e
-        except Exception as e:
-            print(f"{RED}Unexpected error during MCPCore non-stream: {e}{RESET}")
-            error_details = ""
-            if hasattr(e, 'response') and e.response is not None:
-                error_details = f" - Status: {e.response.status_code}, Response: {e.response.text}"
-            raise IOError(f"MCPCore non-stream processing failed: {e}{error_details}") from e
-
-
-class Chat(BaseChat):
-    def __init__(self, client: 'MCPCore'):
-        self.completions = Completions(client)
-
-
-class MCPCore(OpenAICompatibleProvider):
-    """
-    OpenAI-compatible client for the MCPCore API (chat.mcpcore.xyz).
-
-    Requires cookies to be stored in a JSON file (e.g., 'cookies.json').
-    The JSON file should contain a list of cookie objects, including one named 'token'.
-
-    Usage:
-        client = MCPCore(cookies_path="path/to/your/cookies.json")
-        response = client.chat.completions.create(
-            model="google/gemma-7b-it",
-            messages=[{"role": "user", "content": "Hello!"}]
-        )
-        print(response.choices[0].message.content)
-    """
-    AVAILABLE_MODELS = [
-        "google/gemma-7b-it",
-        "deepseek-ai/deepseek-coder-33b-instruct",
-        "deepseek-ai/DeepSeek-R1",
-        "deepseek-ai/DeepSeek-R1-Distill-Qwen-14B",
-        "deepseek-ai/DeepSeek-v3-0324",
-        "fixie-ai/ultravox-v0_4_1-llama-3_1-8b",
-        "meta-llama/Llama-3.3-70B-Instruct",
-        "meta-llama/Llama-4-Maverick-Instruct",
-        "mistralai/Mistral-7B-Instruct-v0.2",
-        "qwen-max-latest",
-        "qwen-plus-latest",
-        "qwen2.5-coder-32b-instruct",
-        "qwen-turbo-latest",
-        "qwen2.5-14b-instruct-1m",
-        "GLM-4-32B",
-        "Z1-32B",
-        "Z1-Rumination",
-        "arena-model",
-        "qvq-72b-preview-0310",
-        "qwq-32b",
-        "qwen3-235b-a22b",
-        "qwen3-30b-a3b",
-        "qwen3-32b",
-        "deepseek-flash",
-        "@cf/meta/llama-4-scout-17b-16e-instruct",
-        "任务专用",
-    ]
-
-    def __init__(
-        self,
-        cookies_path: str, # Make cookies path mandatory for authentication
-        timeout: int = 60,
-    ):
-        """
-        Initializes the MCPCore OpenAI-compatible client.
-
-        Args:
-            cookies_path: Path to the JSON file containing cookies (must include 'token').
-            timeout: Request timeout in seconds.
-            proxies: Optional proxy configuration.
-            system_prompt: Default system prompt to use if none is provided in messages.
-        """
-        self.api_endpoint = "https://chat.mcpcore.xyz/api/chat/completions"
-        self.timeout = timeout
-        self.cookies_path = cookies_path
-
-        try:
-            self.token = self._load_token_from_cookies()
-            if not self.token:
-                raise ValueError("Could not find 'token' cookie in the provided file.")
-        except Exception as e:
-             raise ValueError(f"Failed to load authentication token from cookies file '{cookies_path}': {e}") from e
-
-        self.session = Session() # Use curl_cffi Session
-
-        # Basic headers + Authorization
-        self.headers = {
-            'authority': 'chat.mcpcore.xyz',
-            'accept': '*/*', # Accept anything, let the server decide
-            'accept-language': 'en-US,en;q=0.9',
-            'authorization': f'Bearer {self.token}',
-            'content-type': 'application/json',
-            'origin': 'https://chat.mcpcore.xyz',
-            'referer': 'https://chat.mcpcore.xyz/',
-            'user-agent': LitAgent().random(), # Use LitAgent for User-Agent
-        }
-        # Add more headers mimicking browser behavior if needed, e.g., sec-ch-ua, etc.
-        # Example:
-        # self.headers.update({
-        #     'sec-ch-ua': '"Not/A)Brand";v="99", "Google Chrome";v="127", "Chromium";v="127"',
-        #     'sec-ch-ua-mobile': '?0',
-        #     'sec-ch-ua-platform': '"Windows"',
-        #     'sec-fetch-dest': 'empty',
-        #     'sec-fetch-mode': 'cors',
-        #     'sec-fetch-site': 'same-origin',
-        # })
-
-        self.session.headers.update(self.headers)
-        self.chat = Chat(self) # Initialize chat interface
-
-    def _load_token_from_cookies(self) -> Optional[str]:
-        """Load the 'token' value from a JSON cookies file."""
-        try:
-            with open(self.cookies_path, "r") as f:
-                cookies = json.load(f)
-            # Find the cookie named 'token'
-            token_cookie = next((cookie for cookie in cookies if cookie.get("name") == "token"), None)
-            return token_cookie.get("value") if token_cookie else None
-        except FileNotFoundError:
-            print(f"{RED}Error: Cookies file not found at {self.cookies_path}!{RESET}")
-            return None
-        except json.JSONDecodeError:
-            print(f"{RED}Error: Invalid JSON format in cookies file: {self.cookies_path}!{RESET}")
-            return None
-        except Exception as e:
-            print(f"{RED}An unexpected error occurred loading cookies: {e}{RESET}")
-            return None
-
-    @property
-    def models(self):
-        class _ModelList:
-            def list(inner_self):
-                return type(self).AVAILABLE_MODELS
-        return _ModelList()
-