Interface Session

A unified session representing a single connected MCP client.

The Session is the source of truth for everything related to a client connection. It directly owns the MCP session (SDK bridge), transport context, and auth context.

Composition

Session
├── id            (unique identifier)
├── state         (lifecycle: created → active → closing → closed)
├── transport     → TransportContext (type, instance, heartbeat)
├── mcpSession    → McpSession (SDK server, request manager)
├── auth          → AuthContext (SDK AuthInfo + framework permissions)
├── clientInfo    → ClientInfo (name, version, remoteAddress)
└── metadata      → SessionMetadata (createdAt, lastActivityAt)
Copy