}
            sendBlockedResponse(httpResponse);
            return;
        }

        // Check rate limit
        if (!rateLimitHelper.allowRequest(clientIp)) {
            if (logger.isDebugEnabled()) {
                logger.debug("Rate limit exceeded: clientIp={}", clientIp);
            }
            sendRateLimitResponse(httpResponse, rateLimitHelper.getRetryAfterSeconds());

                final String clientIp = xRealIp.trim();
                if (logger.isDebugEnabled()) {
                    logger.debug("Client IP from X-Real-IP: clientIp={}, remoteAddr={}", clientIp, remoteAddr);
                }
                return clientIp;
            }
        }

        if (logger.isDebugEnabled()) {
            logger.debug("Client IP from remoteAddr: ip={}", remoteAddr);
        }

        final String userId;
        final HttpServletRequest request;
        final String clientIp;
        final String virtualHostKey;

        SearchLogContext(final FessConfig fessConfig, final String[] roles, final String userCode, final String userId,
                final HttpServletRequest request, final String clientIp, final String virtualHostKey) {
            this.fessConfig = fessConfig;
            this.roles = roles;

                null, // userCode
                null, // userId
                request, // request
                "127.0.0.1", // clientIp
                "" // virtualHostKey
        );
    }

    private SearchLog callCreateSearchLogAndGetResult(final String accessTypeAttribute) {
        if (accessTypeAttribute != null) {

    }

    // Test multiple instances
    @Test
    public void test_multipleInstances() {
        // Test that multiple instances can be created independently
        CrawlerEngineClient client1 = new CrawlerEngineClient();
        CrawlerEngineClient client2 = new CrawlerEngineClient();

        assertNotNull(client1);
        assertNotNull(client2);

                        client.isAvailable());
            }
            return client;
        }
        // Fallback: search registered clients
        for (final LlmClient client : clientList) {
            if (llmType.equals(client.getName())) {
                if (logger.isTraceEnabled()) {
                    logger.trace("[LLM] LlmClient found via registration. name={}", client.getName());
                }

     * @return the number of documents processed
     */
    public static long scroll(final String index, final Function<SearchHit, Boolean> callback) {
        final SearchEngineClient client = ComponentUtil.getSearchEngineClient();
        return client.<SearchHit> scrollSearch(index, searchRequestBuilder -> true, (searchResponse, hit) -> hit,
                hit -> callback.apply(hit));
    }

    /**

        assertEquals("https://accounts.google.com/o/oauth2/token", url);
    }

    @Test
    public void test_getOicClientId_default() {
        final String clientId = authenticator.getOicClientId();
        assertEquals("", clientId);
    }

    @Test
    public void test_getOicClientSecret_default() {
        final String secret = authenticator.getOicClientSecret();
        assertEquals("", secret);

    /**
     * Returns the name of this LLM client.
     *
     * @return the client name (e.g., "ollama", "openai", "gemini")
     */
    String getName();

    /**
     * Checks if this LLM client is available and properly configured.
     *
     * @return true if the client is available, false otherwise
     */
    boolean isAvailable();

    // RAG workflow methods

    /**
     * Retrieves the appropriate crawler client for the given URL based on configured rules.
     * This method uses client rules to determine which specific client implementation
     * should be used for crawling the URL, falling back to the default client if no
     * specific rule matches.
     *
     * @param url the URL to get a client for
     * @return the crawler client instance to use for the URL
     */
    @Override