webscout 8.2.3__py3-none-any.whl → 8.2.5__py3-none-any.whl

webscout/Provider/OPENAI/mcpcore.py

@@ -0,0 +1,376 @@
+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
+            final_chunk_dict = final_chunk.to_dict()
+            if usage_obj:
+                final_chunk_dict["usage"] = usage_obj.to_dict()
+
+            # 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
+