Package at.aimon.session.web

package at.aimon.session.web

Web-facing agent session manager primitives.

This package hosts the WebAgentSessionManager interface plus its public value types (WebSubmitRequest, WebSubmitOutcome, LocalSessionCache). The manager wraps AgentSession with the cross-node concerns required by a multi-instance web deployment: distributed locking, cross-node signal fan-out, mailbox hand-off for inputs that arrive at non-holder nodes, and idempotency.

SPI interfaces and their in-memory reference implementations live in at.aimon.session.web.spi / at.aimon.session.web.spi.inmemory. Internal bridge components live in at.aimon.session.web.internal. The cross-node mailbox envelope lives in at.aimon.session.web.inbox.

Design reference: docs/design/implemented/web-agent-session-manager-design.md.

Related Packages

Package	Description
at.aimon.session.web.builder
at.aimon.session.web.exception
at.aimon.session.web.inbox
at.aimon.session.web.internal
at.aimon.session.web.metrics
at.aimon.session.web.spi

Class	Description
AgentSessionOpener	Strategy used by LocalSessionCache to lazily open an AgentSession.
DeploymentMode	Deployment topology declared at builder time.
LocalSessionCache	Per-node, per-conversation session cache backed by Caffeine.
LocalSessionCache.SessionEntry	Live entry held by the cache: exposes the AgentSession and ensures idempotent close.
WebAgentSessionManager	Multi-instance-ready agent session manager facade.
WebSubmitOutcome	Outcome of WebAgentSessionManager.submit(WebSubmitRequest).
WebSubmitOutcome.Kind	Distinguishes the two manager-level outcomes.
WebSubmitRequest	Immutable submit request envelope for WebAgentSessionManager.submit(WebSubmitRequest).
WebSubmitRequest.Builder	Builder for WebSubmitRequest.