*/
    IntentDetectionResult detectIntent(String userMessage);

    /**
     * Detects the intent of a user message with conversation history context.
     *
     * @param userMessage the user's message
     * @param history the conversation history for context
     * @return the detected intent with extracted keywords
     */

    /**
     * The user's message/question.
     */
    @Size(max = 4000)
    public String message;

    /**
     * The session ID for conversation continuity.
     */
    @Size(max = 100)
    public String sessionId;

    /**
     * Flag to clear the conversation history.
     */
    public boolean clearHistory;

        }
        return getAvailableClient().detectIntent(userMessage);
    }

    /**
     * Detects the intent of a user message with conversation history context.
     *
     * @param userMessage the user's message
     * @param history the conversation history for context
     * @return the detected intent with extracted keywords
     * @throws LlmException if LLM is not available
     */

    }

    /**
     * Adds conversation history as structured messages for intent detection.
     *
     * @param request the LLM chat request
     * @param history the conversation history
     */
    protected void addIntentHistory(final LlmChatRequest request, final List<LlmMessage> history) {

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.llm;

import java.io.Serializable;

/**
 * Represents a message in a chat conversation.
 *
 * @author FessProject
 */
public class LlmMessage implements Serializable {

    private static final long serialVersionUID = 1L;

    /** The role identifier for system messages. */

import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.List;
import java.util.UUID;
import java.util.concurrent.CopyOnWriteArrayList;

/**
 * Represents a chat session containing conversation history.
 *
 * @author FessProject
 */
public class ChatSession {

    /** The unique session identifier. */
    private String sessionId;

    /** The user ID associated with this session. */

This policy protects our limited review budget, allowing us to invest our attention wisely.

A pull request is not a finished product—it is the start of a conversation, and an implied contract: we promise to provide thoughtful feedback, and we expect the contributor to engage with us in return.

## What we expect from contributors

package org.codelibs.fess.entity;

import java.io.Serializable;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;

/**
 * Represents a message in a chat conversation.
 *
 * @author FessProject
 */
public class ChatMessage implements Serializable {

    private static final long serialVersionUID = 1L;

    /** The role identifier for user messages. */

Use the chat only for other general conversations.

///

### Don't use the chat for questions { #dont-use-the-chat-for-questions }

Keep in mind that as chats allow more "free conversation", it's easy to ask questions that are too general and more difficult to answer, so, you might not receive answers.

        }
    }

    /**
     * Extracts conversation history from a chat session as LlmMessage list.
     * The assistant message content in history is controlled by the
     * {@code rag.chat.history.assistant.content} configuration property.
     *
     * @param session the chat session
     * @return the list of LlmMessages representing the conversation history
     */