protected abstract int getEvaluationMaxRelevantDocs();

    /**
     * Gets the maximum number of characters for evaluation description.
     *
     * @return the maximum number of characters
     */
    protected abstract int getEvaluationDescriptionMaxChars();

    /**
     * Gets the maximum characters for conversation history in LLM requests.

     */
    public void setEncodeUrlLink(final boolean encodeUrlLink) {
        this.encodeUrlLink = encodeUrlLink;
    }

    /**
     * Sets the character encoding for URL links.
     *
     * @param urlLinkEncoding the character encoding to use
     */
    public void setUrlLinkEncoding(final String urlLinkEncoding) {
        this.urlLinkEncoding = urlLinkEncoding;
    }

    /**

     * @param mode the content mode (full, smart_summary, source_titles, source_titles_and_urls, truncated, none)
     * @param assistantMaxChars the maximum characters for truncated mode
     * @param summaryMaxChars the maximum characters for summary modes
     * @return the content string for history, or null if the message should be excluded
     */

crawler.document.duplicate.term.removed=false
# Unicode space characters for document parsing.
crawler.document.space.chars=u0009u000Au000Bu000Cu000Du001Cu001Du001Eu001Fu0020u00A0u1680u180Eu2000u2001u2002u2003u2004u2005u2006u2007u2008u2009u200Au200Bu200Cu202Fu205Fu3000uFEFFuFFFDu00B6
# Unicode full stop characters for document parsing.
crawler.document.fullstop.chars=u002eu06d4u2e3cu3002
# Encoding for crawling data.

            return replaceWithUnderscores(value);
        }
        return value;
    }

    /**
     * Replaces special characters in a string with underscores for group names.
     *
     * @param value the string to process
     * @return the string with special characters replaced by underscores
     */
    protected String replaceWithUnderscores(final String value) {

     *
     * @param urlList the list to add URLs to
     * @param url the base URL for resolving relative URLs
     * @param attrValue the attribute value containing the URL
     * @param encoding the character encoding
     */
    @Override
    protected void addChildUrlFromTagAttribute(final List<String> urlList, final URL url, final String attrValue, final String encoding) {
        final String urlValue = attrValue.trim();

        }

        @Override
        public String getIndexExportFormat() {
            return "html";
        }
    }

    // --- buildFilePath() regression tests for special characters ---

    @Test
    public void test_buildFilePath_withBrackets() {
        final Path result =

        String[] spaces = (String[]) propMap.get(CRAWLER_DOCUMENT_SPACES);
        if (spaces == null) {
            spaces = Arrays.stream(getCrawlerDocumentSpaceCharsAsArray()).mapToObj(Character::toString).toArray(n -> new String[n]);
            propMap.put(CRAWLER_DOCUMENT_SPACES, spaces);
        }
        return spaces;
    }

        assertFalse(id1.contains("-"));
    }

    @Test
    public void test_generateId_format() {
        String id = queryHelper.generateId();
        // UUID without dashes should be 32 characters
        assertEquals(32, id.length());
        assertTrue(id.matches("[a-f0-9]{32}"));
    }

    @Test
    public void test_addDefaultSort_singleField() {