handleFileUploadException(e);
        }
    }

    protected void prepareElementsHash() { // traditional name
        // #thinking jflute might lazy-loaded be unneeded? because created per request (2024/09/08)
        elementsAll = new HashMap<>();
        elementsText = new HashMap<>();
        elementsFile = new HashMap<>();
    }

/**/docs/src/snippets/**/build
/*/internal-android-performance-testing/build-android-libs
test-splits/
/gradle/verification-keyring.gpg

# Kotlin
# ------
.kotlin

# IDEA
# ----
!/.idea
/.idea/*
# Needed to track entry points and nullability annotations (see https://youtrack.jetbrains.com/issue/IDEA-354114 and https://youtrack.jetbrains.com/issue/IDEA-354115)
!/.idea/misc.xml
!/.idea/codeStyles
!/.idea/inspectionProfiles

    public void test_instanceFieldsInitialization() {
        // Test that instance fields are properly initialized
        assertNotNull(crawlerEngineClient);
        // The actual client initialization happens lazily when needed
    }

    // Test that close method exists (inherited)
    @Test
    public void test_closeMethodExists() {
        // Test that close method is available (inherited from parent)
        try {

                || url.startsWith("s3:") || url.startsWith("gcs:");
    }

    /**
     * Checks if the given URL represents a file system path for content serving.
     * Used to determine if special handling is needed for file system URLs.
     *
     * @param url the URL to check
     * @return true if the URL is a file system path (file, smb, smb1, ftp, storage, s3, gcs)
     */

## Log Message Guidelines

- Logger: `LogManager.getLogger(ClassName.class)`
- Format: `key=value` (e.g., `userId={}`, `url={}`)
- Prefix with `[name]` when context identification is needed
- Mask sensitive values (passwords, tokens)

## i18n / Localization

        session.addAssistantMessage("Assistant 2");
        session.addUserMessage("User 3");
        session.addAssistantMessage("Assistant 3");

        // Trimming to 4 starts at index 2 which is user - no skip needed
        session.trimHistory(4);

        final List<ChatMessage> messages = session.getMessages();
        assertEquals(4, messages.size());
        assertEquals(ChatMessage.ROLE_USER, messages.get(0).getRole());

    }

    // Helper method to create mock RequestManager
    private RequestManager createMockRequestManager() {
        return new SimpleRequestManager() {
            // No additional overrides needed for testing
        };
    }

                logger.debug("Cannot add message, session not found. sessionId={}", sessionId);
            }
            return false;
        }
        session.addMessage(message);

        // Trim history if needed
        final int maxMessages = getMaxHistoryMessages();
        session.trimHistory(maxMessages);

        if (logger.isDebugEnabled()) {

        // Get the queryProcessor that was registered in parent class
        queryProcessor = ComponentUtil.getComponent("queryProcessor");

        // Register all query commands needed for testing
        new TermQueryCommand().register();
        new MatchAllQueryCommand().register();
        new PhraseQueryCommand().register();
        new BooleanQueryCommand().register();

        }
    }

    @Test
    public void test_mimeTypeWithoutPlusCharacterWorksWithoutEscaping() {
        // Test MIME types without + character (no escaping needed)
        String[] mimeTypesWithoutPlus = { //
                "text/html", //
                "text/plain", //
                "application/pdf", //
                "application/xml", //