package com.pablotj.ai.chat.domain.service;

import com.pablotj.ai.chat.domain.model.ConversationMessage;
import com.pablotj.ai.chat.domain.model.MessageContent;
import java.util.List;

/**
 * Domain service interface for AI conversation processing.
 * Defines the contract for AI-powered conversation capabilities.
 */
public interface AiConversationService {

    /**
     * Generates an AI response based on the conversation context.
     *
     * @param conversationHistory the complete conversation history
     * @param userMessage         the latest user message
     * @return the AI-generated response content
     */
    MessageContent generateResponse(List<ConversationMessage> conversationHistory, ConversationMessage userMessage);

    /**
     * Checks if the AI service is available and ready to process requests.
     *
     * @return true if the service is available, false otherwise
     */
    boolean isAvailable();

    /**
     * Gets information about the current AI model being used.
     *
     * @return model information as a string
     */
    String getModelInfo();
}
