chat_handler.py

"""
Flare – Chat Handler  (v1.7 · parameter parsing düzeltmesi)
==========================================
"""

import os
import re, json, sys, httpx
from datetime import datetime
from typing import Dict, List, Optional
from fastapi import APIRouter, HTTPException, Header
from pydantic import BaseModel
import requests

from prompt_builder import build_intent_prompt, build_parameter_prompt, build_smart_parameter_question_prompt, extract_params_from_question
from utils import log
from api_executor import call_api as execute_api  
from validation_engine import validate
from session import session_store, Session
from llm_interface import LLMInterface, SparkLLM, GPT4oLLM
from config_provider import ConfigProvider
from llm_factory import LLMFactory

# ─────────────────────────  CONFIG ───────────────────────── #
# Global config reference
cfg = None

def get_config():
    """Always get fresh config"""
    global cfg
    cfg = ConfigProvider.get()
    return cfg

# Initialize on module load
cfg = get_config()

# Global LLM instance
llm_provider: Optional[LLMInterface] = None

# ─────────────────────────  HELPERS ───────────────────────── #
def _trim_response(raw: str) -> str:
    """
    Remove everything after the first logical assistant block or intent tag.
    Also strips trailing 'assistant' artifacts and prompt injections.
    """
    # Stop at our own rules if model leaked them
    for stop in ["#DETECTED_INTENT", "⚠️", "\nassistant", "assistant\n", "assistant"]:
        idx = raw.find(stop)
        if idx != -1:
            raw = raw[:idx]
    # Normalise selamlama
    raw = re.sub(r"Hoş[\s-]?geldin(iz)?", "Hoş geldiniz", raw, flags=re.IGNORECASE)
    return raw.strip()

def _safe_intent_parse(raw: str) -> tuple[str, str]:
    """Extract intent name and extra tail."""
    m = re.search(r"#DETECTED_INTENT:\s*([A-Za-z0-9_-]+)", raw)
    if not m:
        return "", raw
    name = m.group(1)
    # Remove 'assistant' suffix if exists
    if name.endswith("assistant"):
        name = name[:-9]  # Remove last 9 chars ("assistant")
        log(f"🔧 Removed 'assistant' suffix from intent name")
    tail = raw[m.end():]
    log(f"🎯 Parsed intent: {name}")
    return name, tail

# ─────────────────────────  LLM SETUP ───────────────────────── #
def setup_llm_provider():
    """Initialize LLM provider based on config"""
    global llm_provider
    
    try:
        llm_provider = LLMFactory.create_provider()
        log("✅ LLM provider initialized successfully")
    except Exception as e:
        log(f"❌ Failed to initialize LLM provider: {e}")
        raise

# ─────────────────────────  SPARK/LLM CALL ───────────────────────── #
async def llm_generate(s: Session, prompt: str, user_msg: str) -> str:
    """Call LLM provider with proper error handling"""
    try:
        # Get conversation context
        context = [
            {"role": msg["role"], "content": msg["content"]} 
            for msg in s.chat_history[-10:]  # Last 10 messages
        ]
        
        # Generate response
        raw_response = await llm_provider.generate(
            system_prompt=prompt,
            user_input=user_msg,
            context=context
        )
        
        log(f"📥 LLM response length: {len(raw_response)}")
        return raw_response
        
    except httpx.TimeoutException:
        log("⏱️ LLM timeout - returning fallback")
        return "İsteğiniz zaman aşımına uğradı. Lütfen tekrar deneyin."
    except Exception as e:
        log(f"❌ LLM error: {str(e)}")
        return "Bir hata oluştu. Lütfen daha sonra tekrar deneyin."

# ─────────────────────────  ALLOWED INTENTS ───────────────────────── #
ALLOWED_INTENTS = {"flight-booking", "flight-info", "booking-cancel"}

# ─────────────────────────  FASTAPI ───────────────────────── #
router = APIRouter()

@router.get("/")
def health(): 
    return {"status": "ok", "sessions": len(session_store._sessions)}

class StartRequest(BaseModel): 
    project_name: str

class ChatRequest(BaseModel):  
    user_input: str

class ChatResponse(BaseModel):  
    session_id: str
    answer: str

@router.post("/start_session", response_model=ChatResponse)
async def start_session(req: StartRequest):
    """Create new session"""
    try:
        # Validate project exists
        project = next((p for p in cfg.projects if p.name == req.project_name and p.enabled), None)
        if not project:
            raise HTTPException(404, f"Project '{req.project_name}' not found or disabled")
        
        # Find published version
        version = next((v for v in project.versions if v.published), None)
        if not version:
            raise HTTPException(404, f"No published version for project '{req.project_name}'")
        
        # Create session with version config
        session = session_store.create_session(req.project_name, version)
        greeting = "Hoş geldiniz! Size nasıl yardımcı olabilirim?"
        session.add_turn("assistant", greeting)
        
        return ChatResponse(session_id=session.session_id, answer=greeting)
        
    except Exception as e:
        log(f"❌ Error creating session: {e}")
        raise HTTPException(500, str(e))

@router.post("/chat", response_model=ChatResponse)
async def chat(body: ChatRequest, x_session_id: str = Header(...)):
    """Process chat message"""
    try:
        # Get session
        session = session_store.get_session(x_session_id)
        if not session:
            raise HTTPException(404, "Session not found")
        
        user_input = body.user_input.strip()
        if not user_input:
            raise HTTPException(400, "Empty message")
            
        log(f"💬 User input: {user_input}")
        log(f"📊 Session state: {session.state}, last_intent: {session.last_intent}")
        log(f"📊 Session version: {session.version_number}")
        
        session.add_turn("user", user_input)
        
        # Get version config from session
        version = session.get_version_config()
        if not version:
            raise HTTPException(500, "Version configuration lost")

        # Handle based on state
        if session.state == "await_param":
            log(f"🔄 Handling parameter followup for missing: {session.awaiting_parameters}")
            answer = await _handle_parameter_followup(session, user_input)
        else:
            log("🆕 Handling new message")
            answer = await _handle_new_message(session, user_input)
        
        session.add_turn("assistant", answer)
        return ChatResponse(session_id=session.session_id, answer=answer)
        
    except HTTPException:
        raise
    except Exception as e:
        log(f"❌ Chat error: {e}")
        session.reset_flow()
        error_msg = "Bir hata oluştu. Lütfen tekrar deneyin."
        session.add_turn("assistant", error_msg)
        return ChatResponse(session_id=x_session_id, answer=error_msg)

# ─────────────────────────  MESSAGE HANDLERS ───────────────────────── #
async def _handle_new_message(session: Session, user_input: str) -> str:
    """Handle new message (not parameter followup)"""
    
    # Get version config from session
    version = session.get_version_config()
    if not version:
        log("❌ Version config not found")
        return "Bir hata oluştu. Lütfen tekrar deneyin."
    
    # Build intent detection prompt
    prompt = build_intent_prompt(
        version.general_prompt,
        session.chat_history,
        user_input,
        version.intents
    )
    
    # Get LLM response
    raw = await spark_generate(session, prompt, user_input)
    
    # Empty response fallback
    if not raw:
        log("⚠️ Empty response from LLM")
        return "Üzgünüm, mesajınızı anlayamadım. Lütfen tekrar dener misiniz?"
    
    # Check for intent
    if not raw.startswith("#DETECTED_INTENT"):
        # Small talk response
        log("💬 No intent detected, returning small talk")
        return _trim_response(raw)
    
    # Parse intent
    intent_name, tail = _safe_intent_parse(raw)
    
    # Validate intent
    if intent_name not in ALLOWED_INTENTS:
        log(f"⚠️ Invalid intent: {intent_name}")
        return _trim_response(tail) if tail else "Size nasıl yardımcı olabilirim?"
    
    # Short message guard (less than 3 words usually means incomplete request)
    if len(user_input.split()) < 3 and intent_name != "flight-info":
        log(f"⚠️ Message too short ({len(user_input.split())} words) for intent {intent_name}")
        return _trim_response(tail) if tail else "Lütfen talebinizi biraz daha detaylandırır mısınız?"
    
    # Find intent config
    intent_config = next((i for i in version.intents if i.name == intent_name), None)
    if not intent_config:
        log(f"❌ Intent config not found for: {intent_name}")
        return "Üzgünüm, bu işlemi gerçekleştiremiyorum."
    
    # Set intent in session
    session.last_intent = intent_name
    log(f"✅ Intent set: {intent_name}")
    
    # Log intent parameters
    log(f"📋 Intent parameters: {[p.name for p in intent_config.parameters]}")
    
    # Extract parameters
    return await _extract_parameters(session, intent_config, user_input)

async def _handle_parameter_followup(session: Session, user_input: str) -> str:
    """Handle parameter collection followup"""
    if not session.last_intent:
        log("⚠️ No last intent in session")
        session.reset_flow()
        return "Üzgünüm, hangi işlem için bilgi istediğimi unuttum. Baştan başlayalım."

    # Get version config from session
    version = session.get_version_config()
    if not version:
        log("❌ Version config not found")
        session.reset_flow()
        return "Bir hata oluştu. Lütfen tekrar deneyin."    
    
    # Get intent config
    intent_config = next((i for i in version.intents if i.name == session.last_intent), None)
    if not intent_config:
        log(f"❌ Intent config not found for: {session.last_intent}")
        session.reset_flow()
        return "Bir hata oluştu. Lütfen tekrar deneyin."
    
    # Smart parameter collection
    if cfg.global_config.parameter_collection_config.smart_grouping:
        return await _handle_smart_parameter_collection(session, intent_config, user_input)
    else:
        return await _handle_simple_parameter_collection(session, intent_config, user_input)

async def _handle_simple_parameter_collection(session: Session, intent_config, user_input: str) -> str:
    """Original simple parameter collection logic"""
    # Try to extract missing parameters
    missing = session.awaiting_parameters
    log(f"🔍 Trying to extract missing params: {missing}")
    
    prompt = build_parameter_prompt(intent_config, missing, user_input, session.chat_history, intent_config.locale)
    raw = await spark_generate(session, prompt, user_input)
    
    # Try parsing with or without #PARAMETERS: prefix
    success = _process_parameters(session, intent_config, raw)
    
    if not success:
        # Increment miss count
        session.missing_ask_count += 1
        log(f"⚠️ No parameters extracted, miss count: {session.missing_ask_count}")
        
        if session.missing_ask_count >= 3:
            session.reset_flow()
            return "Üzgünüm, istediğiniz bilgileri anlayamadım. Başka bir konuda yardımcı olabilir miyim?"
        return "Üzgünüm, anlayamadım. Lütfen tekrar söyler misiniz?"
    
    # Check if we have all required parameters
    missing = _get_missing_parameters(session, intent_config)
    log(f"📊 Still missing params: {missing}")
    
    if missing:
        session.awaiting_parameters = missing
        param = next(p for p in intent_config.parameters if p.name == missing[0])
        return f"{param.caption} bilgisini alabilir miyim?"
    
    # All parameters collected, call API
    log("✅ All parameters collected, calling API")
    session.state = "call_api"
    return await _execute_api_call(session, intent_config)

async def _handle_smart_parameter_collection(session: Session, intent_config, user_input: str) -> str:
    """Smart parameter collection with grouping and retry logic"""
    
    # Try to extract missing parameters
    missing = session.awaiting_parameters
    log(f"🔍 Trying to extract missing params: {missing}")
    
    prompt = build_parameter_prompt(intent_config, missing, user_input, session.chat_history, intent_config.locale)
    raw = await spark_generate(session, prompt, user_input)
    
    # Try parsing with or without #PARAMETERS: prefix
    success = _process_parameters(session, intent_config, raw)
    
    # Hangi parametreler hala eksik?
    still_missing = _get_missing_parameters(session, intent_config)
    
    # Sorulan ama cevaplanmayan parametreleri belirle
    asked_but_not_answered = []
    for param in session.awaiting_parameters:
        if param in still_missing:
            asked_but_not_answered.append(param)
    
    # Cevaplanmayanları session'a kaydet
    if asked_but_not_answered:
        session.mark_parameters_unanswered(asked_but_not_answered)
        log(f"❓ Parameters not answered: {asked_but_not_answered}")
    
    # Cevaplananları işaretle
    for param in session.awaiting_parameters:
        if param not in still_missing:
            session.mark_parameter_answered(param)
            log(f"✅ Parameter answered: {param}")
    
    if still_missing:
        # Maksimum deneme kontrolü
        if session.missing_ask_count >= 3:
            session.reset_flow()
            return "Üzgünüm, istediğiniz bilgileri anlayamadım. Başka bir konuda yardımcı olabilir miyim?"
        
        # Smart parameter question oluştur
        return await _generate_smart_parameter_question(session, intent_config, still_missing)
    
    # Tüm parametreler toplandı
    log("✅ All parameters collected, calling API")
    session.state = "call_api"
    return await _execute_api_call(session, intent_config)

async def _generate_smart_parameter_question(session: Session, intent_config, missing_params: List[str]) -> str:
    """Generate smart parameter collection question"""
    
    # Kaç parametre soracağımızı belirle
    max_params = cfg.global_config.parameter_collection_config.max_params_per_question
    
    # Öncelik sırasına göre parametreleri seç
    params_to_ask = []
    
    # Önce daha önce sorulmamış parametreler
    for param in missing_params:
        if session.get_parameter_ask_count(param) == 0:
            params_to_ask.append(param)
            if len(params_to_ask) >= max_params:
                break
    
    # Hala yer varsa, daha önce sorulmuş ama cevaplanmamış parametreler
    if len(params_to_ask) < max_params and cfg.global_config.parameter_collection_config.retry_unanswered:
        for param in session.unanswered_parameters:
            if param in missing_params and param not in params_to_ask:
                params_to_ask.append(param)
                if len(params_to_ask) >= max_params:
                    break
    
    # Hala yer varsa, kalan parametreler
    if len(params_to_ask) < max_params:
        for param in missing_params:
            if param not in params_to_ask:
                params_to_ask.append(param)
                if len(params_to_ask) >= max_params:
                    break
    
    # Parametreleri session'a kaydet
    session.record_parameter_question(params_to_ask)
    session.awaiting_parameters = params_to_ask
    session.missing_ask_count += 1
    
    # Build smart question prompt
    collected_params = {
        p.name: session.variables.get(p.variable_name, "")
        for p in intent_config.parameters
        if p.variable_name in session.variables
    }
    
    question_prompt = build_smart_parameter_question_prompt(
        intent_config,
        params_to_ask,
        session.chat_history,
        collected_params,
        session.unanswered_parameters,
        cfg.global_config.parameter_collection_config.collection_prompt
    )
    
    # Generate natural question
    question = await spark_generate(session, question_prompt, "")
    
    # Clean up the response
    question = _trim_response(question)
    
    log(f"🤖 Generated smart question for {params_to_ask}: {question}")
    
    return question

# ─────────────────────────  PARAMETER HANDLING ───────────────────────── #
async def _extract_parameters(session: Session, intent_config, user_input: str) -> str:
    """Extract parameters from user input"""
    missing = _get_missing_parameters(session, intent_config)
    log(f"🔍 Missing parameters: {missing}")
    
    if not missing:
        # All parameters already available
        log("✅ All parameters already available")
        return await _execute_api_call(session, intent_config)
    
    # Build parameter extraction prompt
    prompt = build_parameter_prompt(intent_config, missing, user_input, session.chat_history)
    raw = await spark_generate(session, prompt, user_input)
    
    # Try processing with flexible parsing
    success = _process_parameters(session, intent_config, raw)
    
    if success:
        missing = _get_missing_parameters(session, intent_config)
        log(f"📊 After extraction, missing: {missing}")
    else:
        log("⚠️ Failed to extract parameters from response")
    
    if missing:
        # Smart parameter collection
        if cfg.global_config.parameter_collection_config.smart_grouping:
            # Reset parameter tracking for new intent
            session.reset_parameter_tracking()
            return await _generate_smart_parameter_question(session, intent_config, missing)
        else:
            # Simple parameter collection
            session.state = "await_param"
            session.awaiting_parameters = missing
            session.missing_ask_count = 0
            param = next(p for p in intent_config.parameters if p.name == missing[0])
            log(f"❓ Asking for parameter: {param.name} ({param.caption})")
            return f"{param.caption} bilgisini alabilir miyim?"
    
    # All parameters collected
    log("✅ All parameters collected after extraction")
    return await _execute_api_call(session, intent_config)

def _get_missing_parameters(session: Session, intent_config) -> List[str]:
    """Get list of missing required parameters"""
    missing = [
        p.name for p in intent_config.parameters 
        if p.required and p.variable_name not in session.variables
    ]
    log(f"📊 Session variables: {list(session.variables.keys())}")
    return missing

def _process_parameters(session: Session, intent_config, raw: str) -> bool:
    """Process parameter extraction response with flexible parsing"""
    try:
        # Try to parse JSON, handling both with and without #PARAMETERS: prefix
        json_str = raw
        if raw.startswith("#PARAMETERS:"):
            json_str = raw[len("#PARAMETERS:"):]
            log(f"🔍 Found #PARAMETERS: prefix, removing it")
        
        # Clean up any trailing content after JSON
        # Find the closing brace for the JSON object
        brace_count = 0
        json_end = -1
        in_string = False
        escape_next = False
        
        for i, char in enumerate(json_str):
            if escape_next:
                escape_next = False
                continue
                
            if char == '\\':
                escape_next = True
                continue
                
            if char == '"' and not escape_next:
                in_string = not in_string
                continue
                
            if not in_string:
                if char == '{':
                    brace_count += 1
                elif char == '}':
                    brace_count -= 1
                    if brace_count == 0:
                        json_end = i + 1
                        break
        
        if json_end > 0:
            json_str = json_str[:json_end]
            log(f"🔍 Cleaned JSON string: {json_str[:200]}")
        
        data = json.loads(json_str)
        
        extracted = data.get("extracted", [])
        log(f"📦 Extracted data: {extracted}")
        
        any_valid = False
        
        for param_data in extracted:
            param_name = param_data.get("name")
            param_value = param_data.get("value")
            
            if not param_name or not param_value:
                log(f"⚠️ Invalid param data: {param_data}")
                continue
            
            # Find parameter config
            param_config = next(
                (p for p in intent_config.parameters if p.name == param_name),
                None
            )
            if not param_config:
                log(f"⚠️ Parameter config not found for: {param_name}")
                continue
            
            # Validate parameter
            if validate(str(param_value), param_config):
                session.variables[param_config.variable_name] = str(param_value)
                any_valid = True
                log(f"✅ Extracted {param_name}={param_value} → {param_config.variable_name}")
            else:
                log(f"❌ Invalid {param_name}={param_value}")
        
        return any_valid
        
    except json.JSONDecodeError as e:
        log(f"❌ JSON parsing error: {e}")
        log(f"❌ Failed to parse: {raw[:200]}")
        return False
    except Exception as e:
        log(f"❌ Parameter processing error: {e}")
        return False

# ─────────────────────────  API EXECUTION ───────────────────────── #
async def _execute_api_call(session: Session, intent_config) -> str:
    """Execute API call and return humanized response"""
    try:
        session.state = "call_api"
        api_name = intent_config.action
        api_config = cfg.get_api(api_name)
        
        if not api_config:
            log(f"❌ API config not found: {api_name}")
            session.reset_flow()
            return intent_config.fallback_error_prompt or "İşlem başarısız oldu."
        
        log(f"📡 Calling API: {api_name}")
        log(f"📦 API variables: {session.variables}")
        
        # Execute API call with session
        response = execute_api(api_config, session)
        api_json = response.json()
        log(f"✅ API response: {api_json}")
        
        # Humanize response
        session.state = "humanize"
        if api_config.response_prompt:
            prompt = api_config.response_prompt.replace(
                "{{api_response}}", 
                json.dumps(api_json, ensure_ascii=False)
            )
            human_response = await spark_generate(session, prompt, json.dumps(api_json))
            session.reset_flow()
            return human_response if human_response else f"İşlem sonucu: {api_json}"
        else:
            session.reset_flow()
            return f"İşlem tamamlandı: {api_json}"
            
    except requests.exceptions.Timeout:
        log(f"⏱️ API timeout: {api_name}")
        session.reset_flow()
        return intent_config.fallback_timeout_prompt or "İşlem zaman aşımına uğradı."
    except Exception as e:
        log(f"❌ API call error: {e}")
        session.reset_flow()
        return intent_config.fallback_error_prompt or "İşlem sırasında bir hata oluştu."

# Initialize LLM on module load
setup_llm_provider()