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	Narrow strategy used by LocalSessionCache to lazily open a session.
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.