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

webscout/Provider/Blackboxai.py

@@ -1,791 +0,0 @@
-import requests
-import random
-import string
-import base64
-from datetime import datetime, timedelta
-from typing import Any, Dict, Union, Generator, List
-from webscout.AIutel import Optimizers, Conversation, AwesomePrompts
-from webscout.AIbase import Provider
-from webscout import exceptions
-from webscout.litagent import LitAgent
-def to_data_uri(image_data):
-    """Convert image data to a data URI format"""
-    if isinstance(image_data, str):
-        # Assume it's already a data URI
-        return image_data
-
-    # Encode binary data to base64
-    encoded = base64.b64encode(image_data).decode('utf-8')
-
-    # Determine MIME type (simplified)
-    mime_type = "image/jpeg"  # Default
-    if image_data.startswith(b'\x89PNG'):
-        mime_type = "image/png"
-    elif image_data.startswith(b'\xff\xd8'):
-        mime_type = "image/jpeg"
-    elif image_data.startswith(b'GIF'):
-        mime_type = "image/gif"
-
-    return f"data:{mime_type};base64,{encoded}"
-
-
-class BLACKBOXAI(Provider):
-    """
-    BlackboxAI provider for interacting with the Blackbox API.
-    Supports synchronous operations with multiple models.
-    """
-    url = "https://www.blackbox.ai"
-    api_endpoint = "https://www.blackbox.ai/api/chat"
-
-
-    # Default model (remains the same as per original class)
-    default_model = "GPT-4.1"
-    default_vision_model = default_model
-
-    # New OpenRouter models list
-    openrouter_models = [
-        "Deepcoder 14B Preview",
-        "DeepHermes 3 Llama 3 8B Preview",
-        "DeepSeek R1 Zero",
-        "Dolphin3.0 Mistral 24B",
-        "Dolphin3.0 R1 Mistral 24B",
-        "Flash 3",
-        "Gemini 2.0 Flash Experimental",
-        "Gemma 2 9B",
-        "Gemma 3 12B",
-        "Gemma 3 1B",
-        "Gemma 3 27B",
-        "Gemma 3 4B",
-        "Kimi VL A3B Thinking",
-        "Llama 3.1 8B Instruct",
-        "Llama 3.1 Nemotron Ultra 253B v1",
-        "Llama 3.2 11B Vision Instruct",
-        "Llama 3.2 1B Instruct",
-        "Llama 3.2 3B Instruct",
-        "Llama 3.3 70B Instruct",
-        "Llama 3.3 Nemotron Super 49B v1",
-        "Llama 4 Maverick",
-        "Llama 4 Scout",
-        "Mistral 7B Instruct",
-        "Mistral Nemo",
-        "Mistral Small 3",
-        "Mistral Small 3.1 24B",
-        "Molmo 7B D",
-        "Moonlight 16B A3B Instruct",
-        "Qwen2.5 72B Instruct",
-        "Qwen2.5 7B Instruct",
-        "Qwen2.5 Coder 32B Instruct",
-        "Qwen2.5 VL 32B Instruct",
-        "Qwen2.5 VL 3B Instruct",
-        "Qwen2.5 VL 72B Instruct",
-        "Qwen2.5-VL 7B Instruct",
-        "Qwerky 72B",
-        "QwQ 32B",
-        "QwQ 32B Preview",
-        "QwQ 32B RpR v1",
-        "R1",
-        "R1 Distill Llama 70B",
-        "R1 Distill Qwen 14B",
-        "R1 Distill Qwen 32B",
-    ]
-
-    # New base models list
-    models = [
-        default_model,
-        "o3-mini",
-        "gpt-4.1-nano",
-        "Claude Opus 4",  # Added Claude Opus 4
-        "Claude Sonnet 4",  # Added Claude Sonnet 4
-        "Claude-sonnet-3.7",
-        "Claude-sonnet-3.5",
-        "Grok 3",  # Added Grok 3
-        "Gemini 2.5 Pro",  # Added Gemini 2.5 Pro
-        "UI-TARS 72B",  # Added UI-TARS 72B
-        "DeepSeek-R1",
-        "Mistral-Small-24B-Instruct-2501",
-        *openrouter_models,
-        # Trending agent modes (names)
-        'Python Agent', 'HTML Agent', 'Builder Agent', 'Java Agent', 'JavaScript Agent',
-        'React Agent', 'Android Agent', 'Flutter Agent', 'Next.js Agent', 'AngularJS Agent',
-        'Swift Agent', 'MongoDB Agent', 'PyTorch Agent', 'Xcode Agent', 'Azure Agent',
-        'Bitbucket Agent', 'DigitalOcean Agent', 'Docker Agent', 'Electron Agent',
-        'Erlang Agent', 'FastAPI Agent', 'Firebase Agent', 'Flask Agent', 'Git Agent',
-        'Gitlab Agent', 'Go Agent', 'Godot Agent', 'Google Cloud Agent', 'Heroku Agent'
-    ]
-
-    # Models that support vision capabilities
-    vision_models = [default_vision_model, 'o3-mini', "Llama 3.2 11B Vision Instruct", "Gemini 2.5 Pro", "Claude Sonnet 4", "Claude Opus 4", "UI-TARS 72B"] # Added Llama vision, Gemini 2.5 Pro, Claude Sonnet 4, Claude Opus 4, and UI-TARS 72B
-
-    # Models that can be directly selected by users
-    userSelectedModel = ['o3-mini', 'Claude Opus 4', 'Claude Sonnet 4', 'Claude-sonnet-3.7', 'Claude-sonnet-3.5', 'Grok 3', 'Gemini 2.5 Pro', 'UI-TARS 72B', 'DeepSeek-R1', 'Mistral-Small-24B-Instruct-2501'] + openrouter_models
-
-    # Agent mode configurations
-    agentMode = {
-        # OpenRouter Free
-        'Deepcoder 14B Preview': {'mode': True, 'id': "agentica-org/deepcoder-14b-preview:free", 'name': "Deepcoder 14B Preview"},
-        'DeepHermes 3 Llama 3 8B Preview': {'mode': True, 'id': "nousresearch/deephermes-3-llama-3-8b-preview:free", 'name': "DeepHermes 3 Llama 3 8B Preview"},
-        'DeepSeek R1 Zero': {'mode': True, 'id': "deepseek/deepseek-r1-zero:free", 'name': "DeepSeek R1 Zero"},
-        'Dolphin3.0 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-mistral-24b:free", 'name': "Dolphin3.0 Mistral 24B"},
-        'Dolphin3.0 R1 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-r1-mistral-24b:free", 'name': "Dolphin3.0 R1 Mistral 24B"},
-        'Flash 3': {'mode': True, 'id': "rekaai/reka-flash-3:free", 'name': "Flash 3"},
-        'Gemini 2.0 Flash Experimental': {'mode': True, 'id': "google/gemini-2.0-flash-exp:free", 'name': "Gemini 2.0 Flash Experimental"},
-        'Gemma 2 9B': {'mode': True, 'id': "google/gemma-2-9b-it:free", 'name': "Gemma 2 9B"},
-        'Gemma 3 12B': {'mode': True, 'id': "google/gemma-3-12b-it:free", 'name': "Gemma 3 12B"},
-        'Gemma 3 1B': {'mode': True, 'id': "google/gemma-3-1b-it:free", 'name': "Gemma 3 1B"},
-        'Gemma 3 27B': {'mode': True, 'id': "google/gemma-3-27b-it:free", 'name': "Gemma 3 27B"},
-        'Gemma 3 4B': {'mode': True, 'id': "google/gemma-3-4b-it:free", 'name': "Gemma 3 4B"},
-        'Kimi VL A3B Thinking': {'mode': True, 'id': "moonshotai/kimi-vl-a3b-thinking:free", 'name': "Kimi VL A3B Thinking"},
-        'Llama 3.1 8B Instruct': {'mode': True, 'id': "meta-llama/llama-3.1-8b-instruct:free", 'name': "Llama 3.1 8B Instruct"},
-        'Llama 3.1 Nemotron Ultra 253B v1': {'mode': True, 'id': "nvidia/llama-3.1-nemotron-ultra-253b-v1:free", 'name': "Llama 3.1 Nemotron Ultra 253B v1"},
-        'Llama 3.2 11B Vision Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-11b-vision-instruct:free", 'name': "Llama 3.2 11B Vision Instruct"},
-        'Llama 3.2 1B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-1b-instruct:free", 'name': "Llama 3.2 1B Instruct"},
-        'Llama 3.2 3B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-3b-instruct:free", 'name': "Llama 3.2 3B Instruct"},
-        'Llama 3.3 70B Instruct': {'mode': True, 'id': "meta-llama/llama-3.3-70b-instruct:free", 'name': "Llama 3.3 70B Instruct"},
-        'Llama 3.3 Nemotron Super 49B v1': {'mode': True, 'id': "nvidia/llama-3.3-nemotron-super-49b-v1:free", 'name': "Llama 3.3 Nemotron Super 49B v1"},
-        'Llama 4 Maverick': {'mode': True, 'id': "meta-llama/llama-4-maverick:free", 'name': "Llama 4 Maverick"},
-        'Llama 4 Scout': {'mode': True, 'id': "meta-llama/llama-4-scout:free", 'name': "Llama 4 Scout"},
-        'Mistral 7B Instruct': {'mode': True, 'id': "mistralai/mistral-7b-instruct:free", 'name': "Mistral 7B Instruct"},
-        'Mistral Nemo': {'mode': True, 'id': "mistralai/mistral-nemo:free", 'name': "Mistral Nemo"},
-        'Mistral Small 3': {'mode': True, 'id': "mistralai/mistral-small-24b-instruct-2501:free", 'name': "Mistral Small 3"}, # Matches Mistral-Small-24B-Instruct-2501
-        'Mistral Small 3.1 24B': {'mode': True, 'id': "mistralai/mistral-small-3.1-24b-instruct:free", 'name': "Mistral Small 3.1 24B"},
-        'Molmo 7B D': {'mode': True, 'id': "allenai/molmo-7b-d:free", 'name': "Molmo 7B D"},
-        'Moonlight 16B A3B Instruct': {'mode': True, 'id': "moonshotai/moonlight-16b-a3b-instruct:free", 'name': "Moonlight 16B A3B Instruct"},
-        'Qwen2.5 72B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-72b-instruct:free", 'name': "Qwen2.5 72B Instruct"},
-        'Qwen2.5 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-7b-instruct:free", 'name': "Qwen2.5 7B Instruct"},
-        'Qwen2.5 Coder 32B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-coder-32b-instruct:free", 'name': "Qwen2.5 Coder 32B Instruct"},
-        'Qwen2.5 VL 32B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-32b-instruct:free", 'name': "Qwen2.5 VL 32B Instruct"},
-        'Qwen2.5 VL 3B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-3b-instruct:free", 'name': "Qwen2.5 VL 3B Instruct"},
-        'Qwen2.5 VL 72B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-72b-instruct:free", 'name': "Qwen2.5 VL 72B Instruct"},
-        'Qwen2.5-VL 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-vl-7b-instruct:free", 'name': "Qwen2.5-VL 7B Instruct"},
-        'Qwerky 72B': {'mode': True, 'id': "featherless/qwerky-72b:free", 'name': "Qwerky 72B"},
-        'QwQ 32B': {'mode': True, 'id': "qwen/qwq-32b:free", 'name': "QwQ 32B"},
-        'QwQ 32B Preview': {'mode': True, 'id': "qwen/qwq-32b-preview:free", 'name': "QwQ 32B Preview"},
-        'QwQ 32B RpR v1': {'mode': True, 'id': "arliai/qwq-32b-arliai-rpr-v1:free", 'name': "QwQ 32B RpR v1"},
-        'R1': {'mode': True, 'id': "deepseek/deepseek-r1:free", 'name': "R1"}, # Matches DeepSeek-R1
-        'R1 Distill Llama 70B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-llama-70b:free", 'name': "R1 Distill Llama 70B"},
-        'R1 Distill Qwen 14B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-14b:free", 'name': "R1 Distill Qwen 14B"},
-        'R1 Distill Qwen 32B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-32b:free", 'name': "R1 Distill Qwen 32B"},
-        # Default models from the new list
-        'Claude Opus 4': {'mode': True, 'id': "anthropic/claude-opus-4", 'name': "Claude Opus 4"},
-        'Claude Sonnet 4': {'mode': True, 'id': "anthropic/claude-sonnet-4", 'name': "Claude Sonnet 4"},
-        'Claude-sonnet-3.7': {'mode': True, 'id': "Claude-sonnet-3.7", 'name': "Claude-sonnet-3.7"},
-        'Claude-sonnet-3.5': {'mode': True, 'id': "Claude-sonnet-3.5", 'name': "Claude-sonnet-3.5"},
-        'Grok 3': {'mode': True, 'id': "x-ai/grok-3-beta", 'name': "Grok 3"},
-        'Gemini 2.5 Pro': {'mode': True, 'id': "google/gemini-2.5-pro-preview-03-25", 'name': "Gemini 2.5 Pro"},
-        'UI-TARS 72B': {'mode': True, 'id': "bytedance-research/ui-tars-72b:free", 'name': "UI-TARS 72B"},
-        'DeepSeek-R1': {'mode': True, 'id': "deepseek-reasoner", 'name': "DeepSeek-R1"}, # This is 'R1' in openrouter, but 'DeepSeek-R1' in base models
-        'Mistral-Small-24B-Instruct-2501': {'mode': True, 'id': "mistralai/Mistral-Small-24B-Instruct-2501", 'name': "Mistral-Small-24B-Instruct-2501"},
-        # Add default_model if it's not covered and has an agent mode
-        default_model: {'mode': True, 'id': "openai/gpt-4.1", 'name': default_model}, # Assuming GPT-4.1 is agent-compatible
-        'o3-mini': {'mode': True, 'id': "o3-mini", 'name': "o3-mini"}, # Assuming o3-mini is agent-compatible
-        'gpt-4.1-nano': {'mode': True, 'id': "gpt-4.1-nano", 'name': "gpt-4.1-nano"}, # Assuming gpt-4.1-nano is agent-compatible
-    }
-
-    # Trending agent modes
-    trendingAgentMode = {
-        'Python Agent': {'mode': True, 'id': "python"},
-        'HTML Agent': {'mode': True, 'id': "html"},
-        'Builder Agent': {'mode': True, 'id': "builder"},
-        'Java Agent': {'mode': True, 'id': "java"},
-        'JavaScript Agent': {'mode': True, 'id': "javascript"},
-        'React Agent': {'mode': True, 'id': "react"},
-        'Android Agent': {'mode': True, 'id': "android"},
-        'Flutter Agent': {'mode': True, 'id': "flutter"},
-        'Next.js Agent': {'mode': True, 'id': "next.js"},
-        'AngularJS Agent': {'mode': True, 'id': "angularjs"},
-        'Swift Agent': {'mode': True, 'id': "swift"},
-        'MongoDB Agent': {'mode': True, 'id': "mongodb"},
-        'PyTorch Agent': {'mode': True, 'id': "pytorch"},
-        'Xcode Agent': {'mode': True, 'id': "xcode"},
-        'Azure Agent': {'mode': True, 'id': "azure"},
-        'Bitbucket Agent': {'mode': True, 'id': "bitbucket"},
-        'DigitalOcean Agent': {'mode': True, 'id': "digitalocean"},
-        'Docker Agent': {'mode': True, 'id': "docker"},
-        'Electron Agent': {'mode': True, 'id': "electron"},
-        'Erlang Agent': {'mode': True, 'id': "erlang"},
-        'FastAPI Agent': {'mode': True, 'id': "fastapi"},
-        'Firebase Agent': {'mode': True, 'id': "firebase"},
-        'Flask Agent': {'mode': True, 'id': "flask"},
-        'Git Agent': {'mode': True, 'id': "git"},
-        'Gitlab Agent': {'mode': True, 'id': "gitlab"},
-        'Go Agent': {'mode': True, 'id': "go"},
-        'Godot Agent': {'mode': True, 'id': "godot"},
-        'Google Cloud Agent': {'mode': True, 'id': "googlecloud"},
-        'Heroku Agent': {'mode': True, 'id': "heroku"},
-    }
-
-    # Complete list of all models (for authorized users) - used for AVAILABLE_MODELS
-    _all_models = list(dict.fromkeys([
-        *models,  # Includes default_model, o3-mini, etc., and openrouter_models and agent names
-        *list(agentMode.keys()), # Ensure all agentMode keys are included
-        *list(trendingAgentMode.keys()) # Ensure all trendingAgentMode keys are included
-    ]))
-
-    AVAILABLE_MODELS = {name: name for name in _all_models}
-    # Update AVAILABLE_MODELS to use names from agentMode if available
-    for model_name_key in agentMode:
-        if model_name_key in AVAILABLE_MODELS: # Check if the key from agentMode is in _all_models
-            AVAILABLE_MODELS[model_name_key] = agentMode[model_name_key].get('name', model_name_key)
-
-
-    # Model aliases for easier reference
-    model_aliases = {
-        "gpt-4": default_model, # default_model is "GPT-4.1"
-        "gpt-4.1": default_model,
-        "gpt-4o": default_model, # Defaulting to GPT-4.1 as per previous logic if specific GPT-4o handling isn't defined elsewhere
-        "gpt-4o-mini": default_model, # Defaulting
-        "claude-opus-4": "Claude Opus 4",
-        "claude-4-opus": "Claude Opus 4",
-        "claude-sonnet-4": "Claude Sonnet 4",
-        "claude-4-sonnet": "Claude Sonnet 4",
-        "claude-3.7-sonnet": "Claude-sonnet-3.7",
-        "claude-3.5-sonnet": "Claude-sonnet-3.5",
-        "grok-3": "Grok 3",
-        "grok3": "Grok 3",
-        "gemini-2.5-pro": "Gemini 2.5 Pro",
-        "gemini-2.5": "Gemini 2.5 Pro",
-        "ui-tars-72b": "UI-TARS 72B",
-        "ui-tars": "UI-TARS 72B",
-        # "deepseek-r1": "DeepSeek-R1", # This is in base models, maps to R1 or DeepSeek R1 Zero in agentMode
-        #
-        "deepcoder-14b": "Deepcoder 14B Preview",
-        "deephermes-3-8b": "DeepHermes 3 Llama 3 8B Preview",
-        "deepseek-r1-zero": "DeepSeek R1 Zero",
-        "deepseek-r1": "R1", # Alias for R1 (which is deepseek/deepseek-r1:free)
-        "dolphin-3.0-24b": "Dolphin3.0 Mistral 24B",
-        "dolphin-3.0-r1-24b": "Dolphin3.0 R1 Mistral 24B",
-        "reka-flash": "Flash 3",
-        "gemini-2.0-flash": "Gemini 2.0 Flash Experimental",
-        "gemma-2-9b": "Gemma 2 9B",
-        "gemma-3-12b": "Gemma 3 12B",
-        "gemma-3-1b": "Gemma 3 1B",
-        "gemma-3-27b": "Gemma 3 27B",
-        "gemma-3-4b": "Gemma 3 4B",
-        "kimi-vl-a3b-thinking": "Kimi VL A3B Thinking",
-        "llama-3.1-8b": "Llama 3.1 8B Instruct",
-        "nemotron-253b": "Llama 3.1 Nemotron Ultra 253B v1",
-        "llama-3.2-11b": "Llama 3.2 11B Vision Instruct",
-        "llama-3.2-1b": "Llama 3.2 1B Instruct",
-        "llama-3.2-3b": "Llama 3.2 3B Instruct",
-        "llama-3.3-70b": "Llama 3.3 70B Instruct",
-        "nemotron-49b": "Llama 3.3 Nemotron Super 49B v1",
-        "llama-4-maverick": "Llama 4 Maverick",
-        "llama-4-scout": "Llama 4 Scout",
-        "mistral-7b": "Mistral 7B Instruct",
-        "mistral-nemo": "Mistral Nemo",
-        "mistral-small-24b": "Mistral Small 3", # Alias for "Mistral Small 3"
-        "mistral-small-24b-instruct-2501": "Mistral-Small-24B-Instruct-2501", # Specific name
-        "mistral-small-3.1-24b": "Mistral Small 3.1 24B",
-        "molmo-7b": "Molmo 7B D",
-        "moonlight-16b": "Moonlight 16B A3B Instruct",
-        "qwen-2.5-72b": "Qwen2.5 72B Instruct",
-        "qwen-2.5-7b": "Qwen2.5 7B Instruct",
-        "qwen-2.5-coder-32b": "Qwen2.5 Coder 32B Instruct",
-        "qwen-2.5-vl-32b": "Qwen2.5 VL 32B Instruct",
-        "qwen-2.5-vl-3b": "Qwen2.5 VL 3B Instruct",
-        "qwen-2.5-vl-72b": "Qwen2.5 VL 72B Instruct",
-        "qwen-2.5-vl-7b": "Qwen2.5-VL 7B Instruct",
-        "qwerky-72b": "Qwerky 72B",
-        "qwq-32b": "QwQ 32B",
-        "qwq-32b-preview": "QwQ 32B Preview",
-        "qwq-32b-arliai": "QwQ 32B RpR v1",
-        "deepseek-r1-distill-llama-70b": "R1 Distill Llama 70B",
-        "deepseek-r1-distill-qwen-14b": "R1 Distill Qwen 14B",
-        "deepseek-r1-distill-qwen-32b": "R1 Distill Qwen 32B",
-    }
-
-    def __init__(
-        self,
-        is_conversation: bool = True,
-        max_tokens: int = 8000,
-        timeout: int = 30,
-        intro: str = None,
-        filepath: str = None,
-        update_file: bool = True,
-        proxies: dict = {},
-        history_offset: int = 10250,
-        act: str = None,
-        model: str = "gpt-4.1",
-        system_message: str = "You are a helpful AI assistant."
-    ):
-        """Initialize BlackboxAI with enhanced configuration options."""
-        self.session = requests.Session()
-        self.max_tokens_to_sample = max_tokens
-        self.is_conversation = is_conversation
-        self.timeout = timeout
-        self.last_response = {}
-        self.model = self.get_model(model)
-        self.system_message = system_message
-
-        self.headers = {
-            "Content-Type": "application/json",
-            "Accept": "*/*",
-        }
-        self.cookies = {
-            'cfzs_amplitude': self.generate_id(32),
-            'cfz_amplitude': self.generate_id(32),
-            '__cf_bm': self.generate_id(32),
-        }
-
-        self.__available_optimizers = [
-            method for method in dir(Optimizers)
-            if callable(getattr(Optimizers, method)) and not method.startswith("__")
-        ]
-
-        Conversation.intro = (
-            AwesomePrompts().get_act(
-                act, raise_not_found=True, default=None, case_insensitive=True
-            )
-            if act
-            else intro or Conversation.intro
-        )
-
-        self.conversation = Conversation(
-            is_conversation, self.max_tokens_to_sample, filepath, update_file
-        )
-        self.conversation.history_offset = history_offset
-        self.session.proxies = proxies
-
-    @classmethod
-    def get_model(cls, model: str) -> str:
-        """Resolve model name from alias"""
-        # Convert to lowercase for case-insensitive matching
-        model_lower = model.lower()
-
-        # Check aliases (case-insensitive)
-        for alias, target in cls.model_aliases.items():
-            if model_lower == alias.lower():
-                model = target
-                break
-
-        # Check available models (case-insensitive)
-        for available_model, target in cls.AVAILABLE_MODELS.items():
-            if model_lower == available_model.lower() or model == target:
-                return target
-
-        # If we get here, the model wasn't found
-        raise ValueError(f"Unknown model: {model}. Available models: {', '.join(cls.AVAILABLE_MODELS)}")
-
-    @classmethod
-    def generate_session(cls, email: str = None, id_length: int = 21, days_ahead: int = 30) -> dict:
-        """
-        Generate a dynamic session with proper ID and expiry format using a specific email.
-        Uses a large hardcoded list of names and domains for diversity.
-
-        Args:
-            email: The email to use for this session (optional, will be generated if not provided)
-            id_length: Length of the numeric ID (default: 21)
-            days_ahead: Number of days ahead for expiry (default: 30)
-
-        Returns:
-            dict: A session dictionary with user information and expiry
-        """
-        # Large list of first and last names
-        first_names = [
-            "Alex", "Jordan", "Taylor", "Morgan", "Casey", "Riley", "Avery", "Quinn", "Skyler", "Dakota",
-            "Jamie", "Cameron", "Drew", "Harper", "Peyton", "Reese", "Rowan", "Sawyer", "Shawn", "Terry",
-            "Robin", "Kendall", "Finley", "Blake", "Charlie", "Emerson", "Hayden", "Jesse", "Kai", "Lane",
-            "Logan", "Marley", "Micah", "Parker", "Phoenix", "Remy", "Rory", "Sage", "Shiloh", "Spencer",
-            "Sydney", "Tatum", "Teagan", "Tristan", "Val", "Winter", "Zion", "Bailey", "Brett", "Case",
-            "Corey", "Devon", "Eden", "Ellis", "Frankie", "Gray", "Indigo", "Jaden", "Jules", "Justice",
-            "Kieran", "Lake", "Lennon", "Linden", "Luca", "Milan", "Monroe", "Oakley", "Perry", "Quincy",
-            "Reagan", "Reed", "Rene", "River", "Robin", "Sasha", "Shane", "Shawn", "Sky", "Sterling",
-            "Storm", "Toby", "Vesper", "Wren", "Zane", "Zuri", "Ainsley", "Arden", "Aspen", "Blaine", "Briar",
-            "Campbell", "Cleo", "Cruz", "Dallas", "Darby", "Denver", "Echo", "Emery", "Everest", "Hollis",
-            "Indy", "Joss", "Karsen", "Kit", "Laken", "Linden", "Lyle", "Marlow", "Merritt", "Nico", "Onyx",
-            "Pax", "Peyton", "Quill", "Raleigh", "Reeve", "Ridley", "Rio", "Rylan", "Sailor", "Scout", "Shia",
-            "Sonny", "Story", "Tanner", "Tate", "Tegan", "Tiernan", "True", "Vaughn", "Wynn", "Zephyr",
-            # Add more names as needed for diversity
-        ]
-        last_names = [
-            "Smith", "Johnson", "Williams", "Brown", "Jones", "Miller", "Davis", "Garcia", "Rodriguez", "Wilson",
-            "Martinez", "Anderson", "Taylor", "Thomas", "Hernandez", "Moore", "Martin", "Jackson", "Thompson", "White",
-            "Lopez", "Lee", "Gonzalez", "Harris", "Clark", "Lewis", "Robinson", "Walker", "Perez", "Hall",
-            "Young", "Allen", "Sanchez", "Wright", "King", "Scott", "Green", "Baker", "AdAMS", "Nelson",
-            "Carter", "Mitchell", "Perez", "Roberts", "Turner", "Phillips", "Campbell", "Parker", "Evans", "Edwards",
-            "Collins", "Stewart", "Sanchez", "Morris", "Rogers", "Reed", "Cook", "Morgan", "Bell", "Murphy",
-            "Bailey", "Rivera", "Cooper", "Richardson", "Cox", "Howard", "Ward", "Torres", "Peterson", "Gray",
-            "Ramirez", "James", "Watson", "Brooks", "Kelly", "Sanders", "Price", "Bennett", "Wood", "Barnes",
-            "Ross", "Henderson", "Coleman", "Jenkins", "Perry", "Powell", "Long", "Patterson", "Hughes", "Flores",
-            "Washington", "Butler", "Simmons", "Foster", "Gonzales", "Bryant", "Alexander", "Russell", "Griffin", "Diaz",
-            # Add more last names as needed
-        ]
-        # Large list of fake domains
-        fake_domains = [
-            "example.com", "mailinator.com", "fakemail.com", "tempmail.net", "yopmail.com", "testmail.org", "maildrop.cc",
-            "inboxkitten.com", "guerrillamail.com", "sharklasers.com", "mailnesia.com", "dispostable.com", "getnada.com",
-            "10minutemail.com", "throwawaymail.com", "mailcatch.com", "spambog.com", "mintemail.com", "mail-temp.com",
-            "fakeinbox.com", "mytrashmail.com", "trashmail.com", "mailnull.com", "spamgourmet.com", "mailhazard.com",
-            "mailbox52.ga", "mailpoof.com", "mailtothis.com", "nowmymail.com", "mailimate.com", "mailboxy.fun",
-            "mailbolt.net", "mailblip.com", "mailbucket.org", "mailchimp.biz", "mailclark.ai", "maildog.info",
-            "maildrop.cc", "maildu.de", "maileater.com", "mailexpire.com", "mailforspam.com", "mailfreeonline.com",
-            "mailhub24.com", "mailimate.com", "mailin8r.com", "mailinator.net", "mailismagic.com", "mailjunk.cf",
-            "mailmate.com", "mailme24.com", "mailmoat.com", "mailnator.com", "mailnesia.com", "mailnull.com",
-            "mailpick.biz", "mailrock.biz", "mailsac.com", "mailseal.de", "mailtemp.net", "mailtothis.com",
-            "mailtrash.net", "mailtv.net", "mailup.net", "mailwire.net", "mailzilla.com", "meltmail.com",
-            "moakt.com", "my10minutemail.com", "mytemp.email", "neomailbox.com", "nospamfor.us", "objectmail.com",
-            "oneoffemail.com", "owlpic.com", "pookmail.com", "proxymail.eu", "rcpt.at", "sharklasers.com",
-            "smellfear.com", "sogetthis.com", "spam4.me", "spamavert.com", "spambob.com", "spambog.com",
-            "spambox.us", "spamcannon.com", "spamday.com", "spamex.com", "spamfree24.com", "spamgourmet.com",
-            "spamhole.com", "spaminator.de", "spamkill.info", "spaml.com", "spammotel.com", "spamobox.com",
-            "spamspot.com", "superrito.com", "teleworm.us", "temp-mail.org", "temp-mail.ru", "tempail.com",
-            "tempe-mail.com", "tempemail.co.za", "tempinbox.com", "tempmail.eu", "tempmail.net", "tempmail.us",
-            "tempomail.fr", "temporaryemail.net", "thankyou2010.com", "thisisnotmyrealemail.com", "throwam.com",
-            "throwawayemailaddress.com", "trash-mail.com", "trash2009.com", "trashdevil.com", "trashemail.de",
-            "trashmail.at", "trashmail.com", "trashmail.me", "trashmail.net", "trashymail.com", "trbvm.com",
-            "yepmail.net", "yopmail.com", "zoemail.net"
-            # Add more as needed
-        ]
-        name = f"{random.choice(first_names)} {random.choice(last_names)}"
-        if not email:
-            domain = random.choice(fake_domains)
-            email = f"{name.lower().replace(' ','.')}{random.randint(1,9999)}@{domain}"
-
-        # Generate numeric ID - using Google-like ID format
-        numeric_id = ''.join(random.choice('0123456789') for _ in range(id_length))
-
-        # Generate future expiry date
-        future_date = datetime.now() + timedelta(days=days_ahead)
-        expiry = future_date.strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
-
-        # Generate random image ID for the new URL format
-        chars = string.ascii_letters + string.digits + "-"
-        random_img_id = ''.join(random.choice(chars) for _ in range(48))
-        image_url = f"https://lh3.googleusercontent.com/a/ACg8oc{random_img_id}=s96-c"
-
-        return {
-            "user": {
-                "name": name,
-                "email": email,
-                "image": image_url,
-                "id": numeric_id
-            },
-            "expires": expiry,
-            "isNewUser": False
-        }
-
-    @classmethod
-    def generate_id(cls, length: int = 7) -> str:
-        """Generate a random ID of specified length"""
-        chars = string.ascii_letters + string.digits
-        return ''.join(random.choice(chars) for _ in range(length))
-
-    def _make_request(
-        self,
-        messages: List[Dict[str, str]],
-        stream: bool = False,
-        temperature: float = None,
-        top_p: float = None,
-        max_tokens: int = None,
-        media: List = None
-    ) -> Generator[str, None, None]:
-        """Make synchronous request to BlackboxAI API."""
-        # Generate a chat ID for this conversation
-        chat_id = self.generate_id()
-
-        # Format messages for the API
-        current_messages = []
-        for i, msg in enumerate(messages):
-            msg_id = chat_id if i == 0 and msg["role"] == "user" else self.generate_id()
-            current_msg = {
-                "id": msg_id,
-                "content": msg["content"],
-                "role": msg["role"]
-            }
-            current_messages.append(current_msg)
-
-        # Add image data if provided
-        if media:
-            current_messages[-1]['data'] = {
-                "imagesData": [
-                    {
-                        "filePath": f"/{image_name}",
-                        "contents": to_data_uri(image)
-                    } for image, image_name in media
-                ],
-                "fileText": "",
-                "title": ""
-            }
-
-        # Generate a random email for the session
-        chars = string.ascii_lowercase + string.digits
-        random_team = ''.join(random.choice(chars) for _ in range(8))
-        # Use a random domain from the fake_domains set for the request email
-        fake_domains = [
-            "example.com", "mailinator.com", "fakemail.com", "tempmail.net", "yopmail.com", "testmail.org", "maildrop.cc",
-            "inboxkitten.com", "guerrillamail.com", "sharklasers.com", "mailnesia.com", "dispostable.com", "getnada.com",
-            "10minutemail.com", "throwawaymail.com", "mailcatch.com", "spambog.com", "mintemail.com", "mail-temp.com",
-            "fakeinbox.com", "mytrashmail.com", "trashmail.com", "mailnull.com", "spamgourmet.com", "mailhazard.com",
-            "mailbox52.ga", "mailpoof.com", "mailtothis.com", "nowmymail.com", "mailimate.com", "mailboxy.fun",
-            "mailbolt.net", "mailblip.com", "mailbucket.org", "mailchimp.biz", "mailclark.ai", "maildog.info",
-            "maildrop.cc", "maildu.de", "maileater.com", "mailexpire.com", "mailforspam.com", "mailfreeonline.com",
-            "mailhub24.com", "mailimate.com", "mailin8r.com", "mailinator.net", "mailismagic.com", "mailjunk.cf",
-            "mailmate.com", "mailme24.com", "mailmoat.com", "mailnator.com", "mailnesia.com", "mailnull.com",
-            "mailpick.biz", "mailrock.biz", "mailsac.com", "mailseal.de", "mailtemp.net", "mailtothis.com",
-            "mailtrash.net", "mailtv.net", "mailup.net", "mailwire.net", "mailzilla.com", "meltmail.com",
-            "moakt.com", "my10minutemail.com", "mytemp.email", "neomailbox.com", "nospamfor.us", "objectmail.com",
-            "oneoffemail.com", "owlpic.com", "pookmail.com", "proxymail.eu", "rcpt.at", "sharklasers.com",
-            "smellfear.com", "sogetthis.com", "spam4.me", "spamavert.com", "spambob.com", "spambog.com",
-            "spambox.us", "spamcannon.com", "spamday.com", "spamex.com", "spamfree24.com", "spamgourmet.com",
-            "spamhole.com", "spaminator.de", "spamkill.info", "spaml.com", "spammotel.com", "spamobox.com",
-            "spamspot.com", "superrito.com", "teleworm.us", "temp-mail.org", "temp-mail.ru", "tempail.com",
-            "tempe-mail.com", "tempemail.co.za", "tempinbox.com", "tempmail.eu", "tempmail.net", "tempmail.us",
-            "tempomail.fr", "temporaryemail.net", "thankyou2010.com", "thisisnotmyrealemail.com", "throwam.com",
-            "throwawayemailaddress.com", "trash-mail.com", "trash2009.com", "trashdevil.com", "trashemail.de",
-            "trashmail.at", "trashmail.com", "trashmail.me", "trashmail.net", "trashymail.com", "trbvm.com",
-            "yepmail.net", "yopmail.com", "zoemail.net"
-            # Add more as needed
-        ]
-        domain = random.choice(fake_domains)
-        request_email = f"{random_team}@{domain}"
-
-        # Generate a session with the email
-        session_data = self.generate_session(request_email)
-
-        # Prepare the request data based on the working example
-        data = {
-            "messages": current_messages,
-            "agentMode": self.agentMode.get(self.model, {}) if self.model in self.agentMode else {},
-            "id": chat_id,
-            "previewToken": None,
-            "userId": None,
-            "codeModelMode": True,
-            "trendingAgentMode": {},
-            "isMicMode": False,
-            "userSystemPrompt": self.system_message,
-            "maxTokens": max_tokens or self.max_tokens_to_sample,
-            "playgroundTopP": top_p,
-            "playgroundTemperature": temperature,
-            "isChromeExt": False,
-            "githubToken": "",
-            "clickedAnswer2": False,
-            "clickedAnswer3": False,
-            "clickedForceWebSearch": False,
-            "visitFromDelta": False,
-            "isMemoryEnabled": False,
-            "mobileClient": False,
-            "userSelectedModel": self.model if self.model in self.userSelectedModel else None,
-            "validated": "00f37b34-a166-4efb-bce5-1312d87f2f94",  # Using a fixed validated value from the example
-            "imageGenerationMode": False,
-            "webSearchModePrompt": False,
-            "deepSearchMode": False,
-            "designerMode": False,
-            "domains": None,
-            "vscodeClient": False,
-            "codeInterpreterMode": False,
-            "customProfile": {
-                "name": "",
-                "occupation": "",
-                "traits": [],
-                "additionalInfo": "",
-                "enableNewChats": False
-            },
-            "webSearchModeOption": {
-                "autoMode": True,
-                "webMode": False,
-                "offlineMode": False
-            },
-            "session": session_data,
-            "isPremium": True,
-            "subscriptionCache": {
-                "status": "PREMIUM",
-                "customerId": "cus_" + ''.join(random.choice(string.ascii_letters + string.digits) for _ in range(14)),
-                "expiryTimestamp": int((datetime.now() + timedelta(days=30)).timestamp()),
-                "lastChecked": int(datetime.now().timestamp() * 1000),
-                "isTrialSubscription": True
-            },
-            "beastMode": False,
-            "reasoningMode": False,
-            "designerMode": False,
-            "workspaceId": ""
-        }
-
-        # Use LitAgent to generate a realistic browser fingerprint for headers
-        agent = LitAgent()
-        fingerprint = agent.generate_fingerprint("chrome")
-        headers = {
-            'accept': fingerprint['accept'],
-            'accept-encoding': 'gzip, deflate, br, zstd',
-            'accept-language': fingerprint['accept_language'],
-            'content-type': 'application/json',
-            'origin': 'https://www.blackbox.ai',
-            'referer': 'https://www.blackbox.ai/',
-            'sec-ch-ua': fingerprint['sec_ch_ua'],
-            'sec-ch-ua-mobile': '?0',
-            'sec-ch-ua-platform': f'"{fingerprint["platform"]}"',
-            'sec-fetch-dest': 'empty',
-            'sec-fetch-mode': 'cors',
-            'sec-fetch-site': 'same-origin',
-            'user-agent': fingerprint['user_agent']
-        }
-
-        try:
-            response = self.session.post(
-                self.api_endpoint,
-                json=data,
-                headers=headers,
-                stream=stream,
-                timeout=self.timeout
-            )
-
-            if not response.ok:
-                error_msg = f"API request failed: {response.status_code} - {response.text}"
-
-                # Check for service suspension
-                if response.status_code == 503 and "service has been suspended" in response.text.lower():
-                    error_msg = "BlackboxAI service has been suspended by its owner. Please try again later or use a different provider."
-
-                # Check for API endpoint issues
-                if response.status_code == 403 and "replace" in response.text.lower() and "api.blackbox.ai" in response.text:
-                    error_msg = "BlackboxAI API endpoint issue. Please check the API endpoint configuration."
-
-                raise exceptions.FailedToGenerateResponseError(error_msg)
-
-            if stream:
-                buffer = ""
-                chunk_size = 32
-                for chunk in response.iter_content(chunk_size=chunk_size):
-                    if not chunk:
-                        continue
-                    text = chunk.decode(errors="ignore")
-                    buffer += text
-                    while len(buffer) >= chunk_size:
-                        out = buffer[:chunk_size]
-                        buffer = buffer[chunk_size:]
-                        if out.strip():
-                            yield out
-                if buffer.strip():
-                    yield buffer
-            else:
-                response_text = response.text
-                if "You have reached your request limit for the hour" in response_text:
-                    raise exceptions.RatelimitE("Rate limit exceeded")
-                yield response_text
-
-        except requests.exceptions.RequestException as e:
-            raise exceptions.ProviderConnectionError(f"Connection error: {str(e)}")
-
-    def ask(
-        self,
-        prompt: str,
-        stream: bool = False,
-        temperature: float = None,
-        top_p: float = None,
-        max_tokens: int = None,
-        optimizer: str = None,
-        conversationally: bool = False,
-        media: List = None
-    ) -> Union[Dict[str, str], Generator[Dict[str, str], None, None]]:
-        """Send a prompt to BlackboxAI API and return the response."""
-        conversation_prompt = self.conversation.gen_complete_prompt(prompt)
-        if optimizer:
-            if optimizer in self.__available_optimizers:
-                conversation_prompt = getattr(Optimizers, optimizer)(
-                    conversation_prompt if conversationally else prompt
-                )
-            else:
-                raise ValueError(f"Optimizer is not one of {self.__available_optimizers}")
-
-        messages = [
-            {"role": "system", "content": self.system_message},
-            {"role": "user", "content": conversation_prompt}
-        ]
-
-        def for_stream():
-            for text in self._make_request(
-                messages,
-                stream=True,
-                temperature=temperature,
-                top_p=top_p,
-                max_tokens=max_tokens,
-                media=media
-            ):
-                yield {"text": text}
-
-        def for_non_stream():
-            response_text = next(self._make_request(
-                messages,
-                stream=False,
-                temperature=temperature,
-                top_p=top_p,
-                max_tokens=max_tokens,
-                media=media
-            ))
-            self.last_response = {"text": response_text}
-            return self.last_response
-
-        return for_stream() if stream else for_non_stream()
-
-    def chat(
-        self,
-        prompt: str,
-        stream: bool = False,
-        temperature: float = None,
-        top_p: float = None,
-        max_tokens: int = None,
-        optimizer: str = None,
-        conversationally: bool = False,
-        media: List = None
-    ) -> Union[str, Generator[str, None, None]]:
-        """Generate response as string."""
-
-        def for_stream():
-            for response in self.ask(
-                prompt,
-                stream=True,
-                temperature=temperature,
-                top_p=top_p,
-                max_tokens=max_tokens,
-                optimizer=optimizer,
-                conversationally=conversationally,
-                media=media
-            ):
-                yield self.get_message(response)
-
-        def for_non_stream():
-            return self.get_message(
-                self.ask(
-                    prompt,
-                    stream=False,
-                    temperature=temperature,
-                    top_p=top_p,
-                    max_tokens=max_tokens,
-                    optimizer=optimizer,
-                    conversationally=conversationally,
-                    media=media
-                )
-            )
-
-        return for_stream() if stream else for_non_stream()
-
-    def get_message(self, response: Dict[str, Any]) -> str:
-        """Extract message from response dictionary."""
-        assert isinstance(response, dict), "Response should be of dict data-type only"
-        return response["text"].replace('\\n', '\n').replace('\\n\\n', '\n\n')
-
-if __name__ == "__main__":
-    # print("-" * 80)
-    # print(f"{'Model':<50} {'Status':<10} {'Response'}")
-    # print("-" * 80)
-
-    # for model in BLACKBOXAI.AVAILABLE_MODELS:
-    #     try:
-    #         test_ai = BLACKBOXAI(model=model, timeout=60)
-    #         response = test_ai.chat("Say 'Hello' in one word")
-    #         response_text = response
-            
-    #         if response_text and len(response_text.strip()) > 0:
-    #             status = "✓"
-    #             # Truncate response if too long
-    #             display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
-    #         else:
-    #             status = "✗"
-    #             display_text = "Empty or invalid response"
-    #         print(f"{model:<50} {status:<10} {display_text}")
-    #     except Exception as e:
-    #         print(f"{model:<50} {'✗':<10} {str(e)}")
-
-    ai = BLACKBOXAI(model="gpt-4.1", timeout=60)
-    response = ai.chat("tell me about humans", stream=True)
-    for line in response:
-        print(line, end="", flush=True)