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).

Exactly one of sessionFactory(AgentSessionFactory) or sessionOpener(AgentSessionOpener) must be configured — they are mutually exclusive. The factory path is the simple lambda-friendly way to wire a stateless AgentSessionFactory; the opener path lets callers thread caller-domain attributes (tenant id, organization unit, ...) from the WebSubmitRequest into the per-conversation context build via OpenAttributes.

Other required collaborators: 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.

AgentExecutionContext ownership. The manager built here does not own the AgentExecutionContext: neither the sessionFactory(...) adapter nor the sessionOpener(...) path closes agent-scoped resources, and WebAgentSessionManager.close() only releases per-conversation collaborators (cache, schedulers, subscriptions). The application bootstrap is responsible for registering each agent's context once via OrcaAgentExecutionContextManager.getOrCreateContext(bundle, ...) and for closing it at shutdown via destroyContext(id) — otherwise MCP clients and other ContextScoped resources leak. See AgentSessionOpener for the per-call contract and docs/design/agent-execution-context-rescoping.md for the full lifecycle.