* Handles encoding detection from parent URLs and configuration settings.
     *
     * @param url the URL to decode
     * @param escapePlus whether to escape plus signs before decoding
     * @return the decoded URL name, or original URL if decoding fails
     */
    default String decodeUrlAsName(final String url, final boolean escapePlus) {
        if (url == null) {

        dataMap1.put("url", "http://example.com/test1");
        indexUpdateCallback.store(paramMap, dataMap1);
        assertEquals(1, indexingHelper.sendDocumentsCalled);

        // Add second document - should trigger indexing again
        Map<String, Object> dataMap2 = new HashMap<>();
        dataMap2.put("url", "http://example.com/test2");
        indexUpdateCallback.store(paramMap, dataMap2);

        // Note: Set-based O(1) lookup should be much faster than O(n) array iteration
        assertTrue("Set-based lookup should complete quickly (duration: " + duration / 1_000_000 + "ms)", duration < 1_000_000_000); // 1 second (relaxed from 100ms for CI)
    }

    /**
     * Test convertWithFieldCheck() with DEFAULT_FIELD.
     */
    @Test
    public void test_convertWithFieldCheck_withDefaultField() {

        List<Map<String, Object>> page1 = JsonPath.from(response).getList("response.logs");

        logger.info("Page 1: {}", page1);

        // Get second page
        searchBody.put("page", 2);
        response = checkMethodBase(searchBody).get(API_PATH + "/logs").asString();
        List<Map<String, Object>> page2 = JsonPath.from(response).getList("response.logs");

            final Long begin = data.remove(BEGIN_KEY);
            if (begin != null) {
                printStats(e.getKey(), data, begin, false);
            }
        });

    }

    /**
     * Begins statistics tracking for the specified crawler object.
     * Creates a new statistics object in the cache and starts timing.
     *
     * @param keyObj the crawler object to track (UrlQueue, StatsKeyObject, String, or Number)

        String result = pythonJob.execute();

        assertNotNull(result);
        assertTrue(result.contains("Session Id:"));
        assertTrue(result.contains("Process is terminated due to 60 second exceeded") || result.contains("Process terminated"));
    }

    // Test executePython with blank filename
    @Test
    public void test_executePython_blankFilename() {
        pythonJob.filename("");

        updateItem2.setNewInputs(new String[] { "p", "q" });
        updateItem2.setNewOutput("r");

        // First update should succeed
        charMappingFile.update(updateItem1);

        // Second update should fail due to mismatch
        try {
            charMappingFile.update(updateItem2);
            fail("Should throw DictionaryException");
        } catch (DictionaryException e) {

        assertEquals(0, session.getMessageCount());

        session.addUserMessage("First");
        assertEquals(1, session.getMessageCount());

        session.addAssistantMessage("Second");
        assertEquals(2, session.getMessageCount());
    }

    @Test
    public void test_getMessageCountWithNullMessages() {
        final ChatSession session = new ChatSession();

        RankFusionProcessor processor = new RankFusionProcessor();
        processor.setSearcher(new TestSearcher(100));
        processor.init();

        // First close
        processor.close();
        // Second close - should not throw exception
        processor.close();
    }

    /**
     * Test searcher that returns configurable number of documents.
     */

     *
     * @param zos the ZIP output stream to write to
     * @param id the diagnostic ID for organizing files in the ZIP
     * @param v1 the first part of the API path (e.g., "cluster", "nodes")
     * @param v2 the second part of the API path (e.g., "health", "stats")
     */
    protected void writeElastisearchJsonApi(final ZipOutputStream zos, final String id, final String v1, final String v2) {