gemini_adapter.py

"""
Cursor Rules Generator - Gemini Adapter

This module implements the LLM adapter for Google's Gemini API.
"""

import json
import requests
from typing import Dict, List, Optional, Any

from ..config.settings import Settings
from .adapter import LLMAdapter

class GeminiAdapter(LLMAdapter):
    """Adapter for Google's Gemini API."""
    
    def __init__(self):
        """Initialize the Gemini adapter."""
        self.api_key = None
        self.api_url = Settings.GEMINI_API_URL
        self.initialized = False
    
    def initialize(self, api_key: str, **kwargs) -> None:
        """Initialize the adapter with API key and optional parameters.
        
        Args:
            api_key: The Gemini API key
            **kwargs: Additional provider-specific parameters
        """
        self.api_key = api_key
        self.api_url = kwargs.get('api_url', Settings.GEMINI_API_URL)
        self.initialized = True
    
    def validate_api_key(self, api_key: str) -> bool:
        """Validate the Gemini API key.
        
        Args:
            api_key: The API key to validate
            
        Returns:
            bool: True if the API key is valid, False otherwise
        """
        try:
            # Try to list models with the provided API key
            url = f"{self.api_url}/models?key={api_key}"
            response = requests.get(url)
            
            # Check if the request was successful
            if response.status_code == 200:
                return True
            return False
        except Exception:
            return False
    
    def get_available_models(self) -> List[Dict[str, str]]:
        """Get a list of available Gemini models.
        
        Returns:
            List[Dict[str, str]]: A list of model information dictionaries
        """
        if not self.initialized:
            raise ValueError("Adapter not initialized. Call initialize() first.")
        
        try:
            # Get available models
            url = f"{self.api_url}/models?key={self.api_key}"
            response = requests.get(url)
            
            if response.status_code != 200:
                raise ValueError(f"Failed to get models: {response.text}")
            
            data = response.json()
            
            # Filter for Gemini models and format the response
            models = []
            for model in data.get('models', []):
                if 'gemini' in model.get('name', '').lower():
                    model_id = model.get('name').split('/')[-1]
                    models.append({
                        'id': model_id,
                        'name': self._format_model_name(model_id)
                    })
            
            # If no models found, return default models
            if not models:
                models = [
                    {'id': 'gemini-2.5-pro', 'name': 'Gemini 2.5 Pro'},
                    {'id': 'gemini-2.0-flash', 'name': 'Gemini 2.0 Flash'},
                    {'id': 'gemini-2.0-flash-lite', 'name': 'Gemini 2.0 Flash-Lite'}
                ]
            
            return models
        except Exception as e:
            # Return default models on error
            return [
                {'id': 'gemini-2.5-pro', 'name': 'Gemini 2.5 Pro'},
                {'id': 'gemini-2.0-flash', 'name': 'Gemini 2.0 Flash'},
                {'id': 'gemini-2.0-flash-lite', 'name': 'Gemini 2.0 Flash-Lite'}
            ]
    
    def generate_rule(
        self, 
        model: str,
        rule_type: str, 
        description: str, 
        content: str, 
        parameters: Optional[Dict[str, Any]] = None
    ) -> str:
        """Generate a Cursor Rule using Gemini.
        
        Args:
            model: The Gemini model ID to use
            rule_type: The type of rule to generate
            description: A short description of the rule's purpose
            content: The main content of the rule
            parameters: Additional parameters for rule generation
                
        Returns:
            str: The generated rule in MDC format
        """
        if not self.initialized:
            raise ValueError("Adapter not initialized. Call initialize() first.")
        
        # Set default parameters if not provided
        if parameters is None:
            parameters = {}
        
        # Extract parameters
        temperature = parameters.get('temperature', Settings.DEFAULT_TEMPERATURE)
        globs = parameters.get('globs', '')
        referenced_files = parameters.get('referenced_files', '')
        prompt = parameters.get('prompt', '')
        
        # Prepare the prompt for Gemini
        system_prompt = """
        You are a Cursor Rules expert. Create a rule in MDC format based on the provided information.
        
        MDC format example:
        ---
        description: RPC Service boilerplate
        globs: 
        alwaysApply: false
        ---
        
        - Use our internal RPC pattern when defining services
        - Always use snake_case for service names.
        
        @service-template.ts
        """
        
        user_prompt = f"""
        Create a Cursor Rule with the following details:
        
        Rule Type: {rule_type}
        Description: {description}
        Content: {content}
        """
        
        if globs:
            user_prompt += f"\nGlobs: {globs}"
        
        if referenced_files:
            user_prompt += f"\nReferenced Files: {referenced_files}"
        
        if prompt:
            user_prompt += f"\nAdditional Instructions: {prompt}"
        
        # Prepare the API request
        url = f"{self.api_url}/models/{model}:generateContent?key={self.api_key}"
        
        payload = {
            "contents": [
                {
                    "role": "user",
                    "parts": [
                        {"text": system_prompt + "\n\n" + user_prompt}
                    ]
                }
            ],
            "generationConfig": {
                "temperature": temperature,
                "topP": 0.8,
                "topK": 40,
                "maxOutputTokens": 2048
            }
        }
        
        # Make the API request
        try:
            response = requests.post(url, json=payload)
            
            if response.status_code != 200:
                raise ValueError(f"Failed to generate rule: {response.text}")
            
            data = response.json()
            
            # Extract the generated text
            generated_text = data.get('candidates', [{}])[0].get('content', {}).get('parts', [{}])[0].get('text', '')
            
            # If no text was generated, create a basic rule
            if not generated_text:
                return self._create_basic_rule(rule_type, description, content, globs, referenced_files)
            
            return generated_text
        except Exception as e:
            # Create a basic rule on error
            return self._create_basic_rule(rule_type, description, content, globs, referenced_files)
    
    def _format_model_name(self, model_id: str) -> str:
        """Format a model ID into a human-readable name.
        
        Args:
            model_id: The model ID
            
        Returns:
            str: A human-readable model name
        """
        # Replace hyphens with spaces and capitalize each word
        name = model_id.replace('-', ' ').title()
        
        # Special case handling
        name = name.replace('Gemini ', 'Gemini ')
        name = name.replace('Pro ', 'Pro ')
        name = name.replace('Flash ', 'Flash ')
        name = name.replace('Lite', 'Lite')
        
        return name
    
    def _create_basic_rule(
        self,
        rule_type: str,
        description: str,
        content: str,
        globs: str = '',
        referenced_files: str = ''
    ) -> str:
        """Create a basic rule in MDC format without using the LLM.
        
        Args:
            rule_type: The type of rule
            description: The rule description
            content: The rule content
            globs: Glob patterns for Auto Attached rules
            referenced_files: Referenced files
            
        Returns:
            str: The rule in MDC format
        """
        # Create MDC format
        mdc = '---\n'
        mdc += f'description: {description}\n'
        
        if rule_type == 'Auto Attached' and globs:
            mdc += f'globs: {globs}\n'
        
        if rule_type == 'Always':
            mdc += 'alwaysApply: true\n'
        else:
            mdc += 'alwaysApply: false\n'
        
        mdc += '---\n\n'
        mdc += content + '\n'
        
        # Add referenced files
        if referenced_files:
            mdc += '\n' + referenced_files
        
        return mdc