Package at.aimon.session.web.builder

Class WebAgentSessionManagerBuilder

java.lang.Object

at.aimon.session.web.builder.WebAgentSessionManagerBuilder

public final class WebAgentSessionManagerBuilder
extends Object

Fluent builder for WebAgentSessionManager (design §11.2).

Required collaborators: AgentSessionFactory, ConversationRepository. SPIs (ConversationLock, ConversationSignalBus, ConversationInbox, IdempotencyStore) are injected explicitly in DeploymentMode.DISTRIBUTED mode and default to in-memory implementations in SINGLE_NODE.

Operational tunables (idleTtl, maxCachedSessions, lockLease, lockExtendInterval, holderLossSweepInterval, idempotencyPrimaryTtl, idempotencySecondaryTtl) carry sensible defaults. Internal components (LeaseRenewer, InProcessEventPublisher, LocalSessionCache, BindingResolver) are managed by the manager and never injected from outside.

In DISTRIBUTED mode the builder fails fast at build() when any SPI is missing or nodeId is unset — this prevents accidentally running with an in-memory SPI on a multi-node deployment.

Field Summary

Fields

Modifier and Type	Field	Description
static final Duration	DEFAULT_HOLDER_LOSS_SWEEP_INTERVAL
static final Duration	DEFAULT_IDEMPOTENCY_PRIMARY_TTL
static final Duration	DEFAULT_IDEMPOTENCY_SECONDARY_TTL
static final Duration	DEFAULT_IDLE_TTL
static final Duration	DEFAULT_LOCK_EXTEND_INTERVAL
static final Duration	DEFAULT_LOCK_LEASE
static final int	DEFAULT_MAX_CACHED_SESSIONS
static final Duration	DEFAULT_RELEASE_INTERRUPT_TIMEOUT

Constructor Summary

Constructors

Constructor	Description
WebAgentSessionManagerBuilder()

Method Summary

Modifier and Type	Method	Description
WebAgentSessionManager	build()
WebAgentSessionManagerBuilder	conversationInbox(ConversationInbox v)
WebAgentSessionManagerBuilder	conversationLock(ConversationLock v)
WebAgentSessionManagerBuilder	conversationRepository(at.aimon.core.agent.conversation.ConversationRepository v)
WebAgentSessionManagerBuilder	holderLossSweepInterval(Duration v)
WebAgentSessionManagerBuilder	idempotencyPrimaryTtl(Duration v)
WebAgentSessionManagerBuilder	idempotencySecondaryTtl(Duration v)
WebAgentSessionManagerBuilder	idempotencyStore(IdempotencyStore v)
WebAgentSessionManagerBuilder	idleTtl(Duration v)
WebAgentSessionManagerBuilder	lockExtendInterval(Duration v)
WebAgentSessionManagerBuilder	lockLease(Duration v)
WebAgentSessionManagerBuilder	maxCachedSessions(int v)
WebAgentSessionManagerBuilder	metrics(SessionMetrics v)
WebAgentSessionManagerBuilder	mode(DeploymentMode v)
WebAgentSessionManagerBuilder	nodeId(String v)
WebAgentSessionManagerBuilder	releaseInterruptTimeout(Duration v)
WebAgentSessionManagerBuilder	sessionFactory(at.aimon.core.agent.session.AgentSessionFactory v)
WebAgentSessionManagerBuilder	signalBus(ConversationSignalBus v)

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_IDLE_TTL

public static final Duration DEFAULT_IDLE_TTL

DEFAULT_MAX_CACHED_SESSIONS

public static final int DEFAULT_MAX_CACHED_SESSIONS

See Also:

• Constant Field Values

DEFAULT_LOCK_LEASE

public static final Duration DEFAULT_LOCK_LEASE

DEFAULT_LOCK_EXTEND_INTERVAL

public static final Duration DEFAULT_LOCK_EXTEND_INTERVAL

DEFAULT_HOLDER_LOSS_SWEEP_INTERVAL

public static final Duration DEFAULT_HOLDER_LOSS_SWEEP_INTERVAL

DEFAULT_IDEMPOTENCY_PRIMARY_TTL

public static final Duration DEFAULT_IDEMPOTENCY_PRIMARY_TTL

DEFAULT_IDEMPOTENCY_SECONDARY_TTL

public static final Duration DEFAULT_IDEMPOTENCY_SECONDARY_TTL

DEFAULT_RELEASE_INTERRUPT_TIMEOUT

public static final Duration DEFAULT_RELEASE_INTERRUPT_TIMEOUT

Constructor Details

WebAgentSessionManagerBuilder

public WebAgentSessionManagerBuilder()

Method Details

sessionFactory

public WebAgentSessionManagerBuilder sessionFactory(at.aimon.core.agent.session.AgentSessionFactory v)

conversationRepository

public WebAgentSessionManagerBuilder conversationRepository(at.aimon.core.agent.conversation.ConversationRepository v)

conversationLock

public WebAgentSessionManagerBuilder conversationLock(ConversationLock v)

signalBus

public WebAgentSessionManagerBuilder signalBus(ConversationSignalBus v)

conversationInbox

public WebAgentSessionManagerBuilder conversationInbox(ConversationInbox v)

idempotencyStore

public WebAgentSessionManagerBuilder idempotencyStore(IdempotencyStore v)

mode

public WebAgentSessionManagerBuilder mode(DeploymentMode v)

nodeId

public WebAgentSessionManagerBuilder nodeId(String v)

idleTtl

public WebAgentSessionManagerBuilder idleTtl(Duration v)

maxCachedSessions

public WebAgentSessionManagerBuilder maxCachedSessions(int v)

lockLease

public WebAgentSessionManagerBuilder lockLease(Duration v)

lockExtendInterval

public WebAgentSessionManagerBuilder lockExtendInterval(Duration v)

holderLossSweepInterval

public WebAgentSessionManagerBuilder holderLossSweepInterval(Duration v)

idempotencyPrimaryTtl

public WebAgentSessionManagerBuilder idempotencyPrimaryTtl(Duration v)

idempotencySecondaryTtl

public WebAgentSessionManagerBuilder idempotencySecondaryTtl(Duration v)

releaseInterruptTimeout

public WebAgentSessionManagerBuilder releaseInterruptTimeout(Duration v)

metrics

public WebAgentSessionManagerBuilder metrics(SessionMetrics v)

build

public WebAgentSessionManager build()