Class SessionRegistry.Builder

java.lang.Object

ai.singlr.runtime.SessionRegistry.Builder

Enclosing class:

SessionRegistry

public static final class SessionRegistry.Builder
extends Object

Fluent builder for SessionRegistry.

Method Summary

Modifier and Type	Method	Description
SessionRegistry	build()	Build the immutable registry.
SessionRegistry.Builder	withClock(Clock clock)	Override the clock used to stamp terminal sessions.
SessionRegistry.Builder	withFactory(Function<ai.singlr.session.SessionOptions, ai.singlr.session.AgentSession> factory)	Override the session factory.
SessionRegistry.Builder	withMaxSessions(int maxSessions)	Cap registered sessions.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

withFactory

public SessionRegistry.Builder withFactory(Function<ai.singlr.session.SessionOptions, ai.singlr.session.AgentSession> factory)

Override the session factory. Production code keeps the default; tests supply a stub.

Parameters:

factory - non-null factory

Returns:

this builder

Throws:

NullPointerException - if factory is null

withClock

public SessionRegistry.Builder withClock(Clock clock)

Override the clock used to stamp terminal sessions. Tests use a fixed clock for deterministic eviction; production keeps Clock.systemUTC().

Parameters:

clock - non-null clock

Returns:

this builder

Throws:

NullPointerException - if clock is null

withMaxSessions

public SessionRegistry.Builder withMaxSessions(int maxSessions)

Cap registered sessions. When SessionRegistry.create(SessionOptions) would push the count over this number, the registry evicts the oldest terminal session first; if no terminal session is available, the create call throws.

Parameters:

maxSessions - positive cap

Returns:

this builder

Throws:

IllegalArgumentException - if maxSessions is not positive

build

public SessionRegistry build()

Build the immutable registry.

Returns:

a fresh registry