/**
     * Creates a derived session using the given local repository.
     *
     * @param localRepository the new local repository
     * @return the derived session
     * @throws NullPointerException if {@code localRepository} is null
     */
    @Nonnull
    Session withLocalRepository(@Nonnull LocalRepository localRepository);

    /**
     * Creates a derived session using the given remote repositories.
     *

        MavenSession msession =
                new MavenSession(getContainer(), session, mavenExecutionRequest, new DefaultMavenExecutionResult());
        DefaultSession iSession = new DefaultSession(
                msession, resolverRepositorySystem, null, mavenRepositorySystem, new DefaultLookup(container), null);
        InternalSession.associate(session, iSession);

        SessionScope sessionScope = container.lookup(SessionScope.class);

    }

    // Test addFinishedSessionId with multiple sessions
    public void test_addFinishedSessionId_multiple() {
        indexUpdater.addFinishedSessionId("session1");
        indexUpdater.addFinishedSessionId("session2");
        indexUpdater.addFinishedSessionId("session3");

        assertEquals(3, indexUpdater.finishedSessionIdList.size());

    // Force reuse. This appears flaky (30% of the time) even though sessions are reused.
    // javax.net.ssl.SSLHandshakeException: No new session is allowed and no existing
    // session can be resumed
    //
    // Report https://bugs.java.com/bugdatabase/view_bug.do?bug_id=JDK-8264944
    // Sessions improvement https://bugs.java.com/bugdatabase/view_bug.do?bug_id=JDK-8245576

    }

    /**
     * Retrieves or creates the result document IDs cache from the session.
     * The cache is implemented as an LRU map to limit memory usage.
     *
     * @param session the HTTP session
     * @return the result document IDs cache map
     */
    private Map<String, String[]> getResultDocIdsCache(final HttpSession session) {
        @SuppressWarnings("unchecked")

        // Simulate session already in use by adding a session
        Field sessionsField = SmbTransportImpl.class.getDeclaredField("sessions");
        sessionsField.setAccessible(true);
        @SuppressWarnings("unchecked")
        List<Object> sessions = (List<Object>) sessionsField.get(first);
        sessions.add(new Object()); // Add one session to reach the limit

    }

    /**
     * Retrieves the parameters from the most recent crawling session for a given session ID.
     * Returns an empty list if no crawling information is found for the session.
     *
     * @param sessionId the session identifier to find the latest crawling parameters for
     * @return a list of CrawlingInfoParam entities from the latest session, or empty list if none found
     */

                    log.trace("Reusing existing session " + ssn);
                }
                return ssn.acquire();
            }
            if (log.isTraceEnabled()) {
                log.trace("Existing session " + ssn + " does not match " + tf.getCredentials());
            }
        }

        /* logoff old sessions */

                } catch (final IOException ioe) {}
                throw new SmbException("EOF during NetBIOS session request");
            }
            switch (sbuf[0] & 0xFF) {
            case SessionServicePacket.POSITIVE_SESSION_RESPONSE:
                if (LogStream.level >= 4) {
                    log.println("session established ok with " + address);
                }
                return;

    }

    /**
     * Extracts the canonical session ID by removing any suffix after the first hyphen.
     * If the session ID contains a hyphen, returns the portion before the first hyphen.
     * Otherwise, returns the original session ID.
     *
     * @param sessionId the session ID to process
     * @return the canonical session ID (portion before first hyphen, or original if no hyphen)
     */