* In addition to low-level chat operations, this interface defines
 * high-level RAG workflow methods that allow each provider to optimize
 * prompt construction, parameter tuning, and response parsing.
 */
public interface LlmClient {

    /**
     * Performs a chat completion request.
     *
     * @param request the chat request containing messages and parameters
     * @return the chat response from the LLM

     */
    public LlmClient getClient() {
        final String llmType = getLlmType();
        final String name = llmType + "LlmClient";
        if (ComponentUtil.hasComponent(name)) {
            final LlmClient client = ComponentUtil.getComponent(name);
            if (logger.isTraceEnabled()) {

import org.codelibs.fess.Constants;
import org.codelibs.fess.annotation.Secured;
import org.codelibs.fess.app.web.base.FessAdminAction;
import org.codelibs.fess.helper.SystemHelper;
import org.codelibs.fess.llm.LlmClient;
import org.codelibs.fess.llm.LlmClientManager;
import org.codelibs.fess.mylasta.direction.FessConfig;
import org.codelibs.fess.mylasta.mail.TestmailPostcard;
import org.codelibs.fess.util.ComponentUtil;

import org.codelibs.fess.helper.MarkdownRenderer;
import org.codelibs.fess.llm.ChatIntent;
import org.codelibs.fess.llm.IntentDetectionResult;
import org.codelibs.fess.llm.LlmChatResponse;
import org.codelibs.fess.llm.LlmClient;
import org.codelibs.fess.llm.LlmClientManager;
import org.codelibs.fess.llm.LlmException;
import org.codelibs.fess.llm.LlmMessage;
import org.codelibs.fess.llm.LlmStreamCallback;

 * default implementations of RAG workflow methods with injectable prompt templates.
 * Subclasses implement provider-specific chat/streamChat and checkAvailabilityNow.
 */
public abstract class AbstractLlmClient implements LlmClient {

    private static final Logger logger = LogManager.getLogger(AbstractLlmClient.class);

    /** Shared ObjectMapper instance for JSON processing. */