this.intent = intent;
        this.query = query;
        this.documentUrl = documentUrl;
        this.reasoning = reasoning;
    }

    /**
     * Returns the detected intent type.
     *
     * @return the intent type
     */
    public ChatIntent getIntent() {
        return intent;
    }

    /**
     * Returns the Fess query string for search.
     *

     */
    public static ChatIntent fromValue(final String value) {
        if (value == null) {
            return UNCLEAR;
        }
        for (final ChatIntent intent : values()) {
            if (intent.value.equalsIgnoreCase(value.trim())) {
                return intent;
            }
        }
        return UNCLEAR;
    }

 */
public interface ChatPhaseCallback {

    /** Phase name for intent detection */
    String PHASE_INTENT = "intent";

    /** Phase name for document search */
    String PHASE_SEARCH = "search";

    /** Phase name for result evaluation */
    String PHASE_EVALUATE = "evaluate";

    /** Phase name for content retrieval */
    String PHASE_FETCH = "fetch";

    /** Phase name for answer generation */

    boolean isAvailable();

    // RAG workflow methods

    /**
     * Detects the intent of a user message.
     *
     * @param userMessage the user's message
     * @return the detected intent with extracted keywords
     */
    IntentDetectionResult detectIntent(String userMessage);

    /**
     * Detects the intent of a user message with conversation history context.
     *
     * @param userMessage the user's message

            public void onPhaseComplete(String phase) {
                events.add("complete:" + phase);
            }

            @Override
            public void onChunk(String content, boolean done) {
                events.add("chunk:" + content + ":" + done);
            }

            @Override
            public void onError(String phase, String errorMessage) {
                events.add("error:" + phase + ":" + errorMessage);

        final IntentDetectionResult result = IntentDetectionResult.faq(query, "faq intent");

        assertEquals(ChatIntent.FAQ, result.getIntent());
        assertEquals(query, result.getQuery());
        assertNull(result.getDocumentUrl());
        assertEquals("faq intent", result.getReasoning());
    }

    @Test
    public void test_faq_withEmptyQuery() {

    }

    /**
     * Registers this ingester with the ingest factory.
     * This makes the ingester available for processing documents.
     */
    public void register() {
        getIngestFactory().add(this);
    }

    /**
     * Gets the ingest factory instance for managing ingesters.
     *
     * @return the ingest factory instance
     */
    protected IngestFactory getIngestFactory() {

    public String getContent() {
        checkSpecifiedProperty("content");
        return convertEmptyToNull(content);
    }

    public void setContent(String value) {
        registerModifiedProperty("content");
        this.content = value;
    }

    public String getCreatedBy() {
        checkSpecifiedProperty("createdBy");

<a href="fess-ingest-logger/" title="fess-ingest-logger/">fess-ingest-logger/</a>                                              -         -      
<a href="fess-ingest-ndjson/" title="fess-ingest-ndjson/">fess-ingest-ndjson/</a>                                              -         -      

import jakarta.annotation.PostConstruct;

/**
 * Helper class for managing related content configurations.
 * This class provides functionality to load, cache, and retrieve related content
 * based on search queries and virtual host configurations. It supports both exact
 * term matching and regex pattern matching for flexible content association.
 */
public class RelatedContentHelper extends AbstractConfigHelper {

    /**