}

    /**
     * Returns the reasoning for the detected intent.
     *
     * @return the reasoning
     */
    public String getReasoning() {
        return reasoning;
    }

    /**
     * Creates a search intent result with a Fess query.
     *
     * @param query the Fess query string
     * @param reasoning the detection reasoning
     * @return the search intent result
     */

        final IntentDetectionResult result = IntentDetectionResult.search(query, "test reasoning");

        assertEquals(ChatIntent.SEARCH, result.getIntent());
        assertEquals(query, result.getQuery());
        assertNull(result.getDocumentUrl());
        assertEquals("test reasoning", result.getReasoning());
    }

    @Test
    public void test_search_withEmptyQuery() {

            final String reasoning = extractJsonString(response, "reasoning");

            if (intent == ChatIntent.SEARCH) {
                return IntentDetectionResult.search(query, reasoning);
            } else if (intent == ChatIntent.FAQ) {
                return IntentDetectionResult.faq(query, reasoning);
            } else if (intent == ChatIntent.SUMMARY) {

during compilation indicate errors in your style and can be viewed in the
`checkstyle-result.xml` file.

Some general advice

- Don’t change public API lightly, avoid if possible, and include your reasoning in the PR if essential.  It causes pain for developers who use OkHttp and sometimes runtime errors.

    @Test
    public void test_detectIntent_withHistory_usesStructuredMessages() {
        // Set up chat to return a valid JSON response
        client.setChatResponse("{\"intent\":\"search\",\"query\":\"Fess Docker\",\"reasoning\":\"Follow-up about Docker\"}");

        final List<LlmMessage> history = new ArrayList<>();
        history.add(LlmMessage.user("What is Fess?"));

then KEEP those additional abbr elements in the translation. Do not remove them. Except when you remove the whole sentence from the translation, because the whole sentence was removed from the English text, then also remove the abbr element. The reasoning for this rule is, that such additional abbr elements are manually added by the human editor of the translation, in order to translate or explain an English word to the human readers of the translation. These additional abbr elements would not make...

            callback.onPhaseComplete(ChatPhaseCallback.PHASE_INTENT);

            if (logger.isDebugEnabled()) {
                logger.debug("[RAG] Phase {} completed. intent={}, query={}, reasoning={}, phaseElapsedTime={}ms",
                        ChatPhaseCallback.PHASE_INTENT, intentResult.getIntent(), intentResult.getQuery(), intentResult.getReasoning(),
                        System.currentTimeMillis() - phaseStartTime);