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<>();
    }

     *
     * @return a new access context arranger
     */
    @Override
    protected AccessContextArranger newAccessContextArranger() { // for framework
        // fess does not use DBFlute, and this is unneeded so dummy
        return resource -> {
            final AccessContext context = new AccessContext();
            context.setAccessLocalDateTimeProvider(() -> timeManager.currentDateTime());

/**/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

    ├── stemmer_override.txt
    └── protwords.txt
```

## Important Notes

### No Database Changes Required

- Language configuration is entirely file-based
- No database or OpenSearch index updates needed
- Settings are loaded at application startup and cached

### Fallback Mechanism

     * Compares this CharMappingItem with another object for equality.
     * Two CharMappingItem objects are equal if they have the same inputs and output.
     * Note: inputs arrays are sorted in the constructor, so no sorting is needed here.
     *
     * @param obj the object to compare with
     * @return true if the objects are equal, false otherwise
     */
    @Override
    public boolean equals(final Object obj) {

        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
        };
    }