Class SessionManagerImpl

Facade implementation of SessionManager.

Delegates to:

SessionStore for CRUD operations, queries, and broadcasting
SessionHousekeeper for background cleanup and heartbeat monitoring

Example

// HTTP mode — full background tasks
const manager = new SessionManagerImpl();

// Stdio mode — no background tasks
const manager = new SessionManagerImpl({
  cleanupIntervalMs: 0,
  keepAliveIntervalMs: 0,
  maxSessions: 1,
});

Implements

SessionManager

Index

Constructors

constructor

new SessionManagerImpl(config?: SessionConfigInput): SessionManagerImpl
Parameters
- Optionalconfig: SessionConfigInput
Returns SessionManagerImpl
- Defined in src/server/session/session-manager.ts:312

Accessors

size

get size(): number
Number of active sessions

Returns number
Implementation of SessionManager.size
- Defined in src/server/session/session-manager.ts:342

stats

get stats(): SessionStats
Current statistics

Returns SessionStats
Implementation of SessionManager.stats
- Defined in src/server/session/session-manager.ts:346

Methods

broadcastPromptListChanged

broadcastPromptListChanged(): void
Broadcasts prompt list changed notification to all sessions. Called when dynamic prompts are added/removed.

Returns void
Implementation of SessionManager.broadcastPromptListChanged
- Defined in src/server/session/session-manager.ts:515

broadcastResourceListChanged

broadcastResourceListChanged(): void
Broadcasts resource list changed notification to all sessions. Called when dynamic resources are added/removed.

Returns void
Implementation of SessionManager.broadcastResourceListChanged
- Defined in src/server/session/session-manager.ts:510

broadcastResourceUpdated

broadcastResourceUpdated(uri: string): void
Sends a resource updated notification to sessions subscribed to the given URI.

Only sessions that have called resources/subscribe for this URI receive the notifications/resources/updated notification.
Parameters
- uri: string
Returns void
Implementation of SessionManager.broadcastResourceUpdated
- Defined in src/server/session/session-manager.ts:520

broadcastToolListChanged

broadcastToolListChanged(): void
Broadcasts tool list changed notification to all sessions. Called when dynamic tools are added/removed.

Returns void
Implementation of SessionManager.broadcastToolListChanged
- Defined in src/server/session/session-manager.ts:505

close

close(sessionId: string, reason: SessionCloseReason): Promise<void>
Closes and removes a specific session.
Parameters
- sessionId: string
  Session identifier
- reason: SessionCloseReason
  Reason for closure
Returns Promise<void>
Implementation of SessionManager.close
- Defined in src/server/session/session-manager.ts:421

closeAll

closeAll(): Promise<void>
Closes all sessions during shutdown.

Returns Promise<void>
Implementation of SessionManager.closeAll
- Defined in src/server/session/session-manager.ts:449

create

create(options: CreateSessionOptions): Session | undefined
Creates and registers a new session.
Parameters
- options: CreateSessionOptions
  Session creation options
Returns Session | undefined
The created session, or undefined if at capacity
Implementation of SessionManager.create
- Defined in src/server/session/session-manager.ts:354

dispose

dispose(): void
Disposes of the manager and stops background tasks.

Returns void
Implementation of SessionManager.dispose
- Defined in src/server/session/session-manager.ts:479

filter

filter(predicate: (session: ReadonlySession) => boolean): Readonly<Session>[]
Finds sessions matching a predicate.
Parameters
- predicate: (session: ReadonlySession) => boolean
  Filter function
Returns Readonly<Session>[]
Array of matching sessions
Implementation of SessionManager.filter
- Defined in src/server/session/session-manager.ts:493

forEach

forEach(callback: (session: ReadonlySession, sessionId: string) => void): void
Iterates over all active sessions.
Parameters
- callback: (session: ReadonlySession, sessionId: string) => void
  Function to call for each session
Returns void
Implementation of SessionManager.forEach
- Defined in src/server/session/session-manager.ts:489

get

get(sessionId: string): Session | undefined
Gets a session by ID. Does NOT update activity time (use touch() for that).
Parameters
- sessionId: string
  Session identifier
Returns Session | undefined
The session if found and active
Implementation of SessionManager.get
- Defined in src/server/session/session-manager.ts:374

getByTransportType

getByTransportType(type: TransportType): Readonly<Session>[]
Gets all sessions of a specific transport type.
Parameters
- type: TransportType
  Transport type to filter by
Returns Readonly<Session>[]
Implementation of SessionManager.getByTransportType
- Defined in src/server/session/session-manager.ts:497

has

has(sessionId: string): boolean
Checks if a session exists and is active.
Parameters
- sessionId: string
  Session identifier
Returns boolean
Implementation of SessionManager.has
- Defined in src/server/session/session-manager.ts:378

hasCapacity

hasCapacity(): boolean
Checks if there's capacity for new sessions.

Returns boolean
Implementation of SessionManager.hasCapacity
- Defined in src/server/session/session-manager.ts:386

hasCapacityForTransport

hasCapacityForTransport(transportType: TransportType): boolean
Checks if there's capacity for a specific transport type. Enforces per-transport limits from config.
Parameters
- transportType: TransportType
Returns boolean
Implementation of SessionManager.hasCapacityForTransport
- Defined in src/server/session/session-manager.ts:394

touch

touch(sessionId: string): boolean
Updates the last activity time for a session. Also resets missed heartbeat count.
Parameters
- sessionId: string
  Session identifier
Returns boolean
true if session was touched
Implementation of SessionManager.touch
- Defined in src/server/session/session-manager.ts:382

Class SessionManagerImpl

Example

Implements

Index

Constructors

Accessors

Methods

Constructors

constructor

Parameters

Returns SessionManagerImpl

Accessors

size

Returns number

stats

Returns SessionStats

Methods

broadcastPromptListChanged

Returns void

broadcastResourceListChanged

Returns void

broadcastResourceUpdated

Parameters

Returns void

broadcastToolListChanged

Returns void

close

Parameters

Returns Promise<void>

closeAll

Returns Promise<void>

create

Parameters

Returns Session | undefined

dispose

Returns void

filter

Parameters

Returns Readonly<Session>[]

forEach

Parameters

Returns void

get

Parameters

Returns Session | undefined

getByTransportType

Parameters

Returns Readonly<Session>[]

has

Parameters

Returns boolean

hasCapacity

Returns boolean

hasCapacityForTransport

Parameters

Returns boolean

touch

Parameters

Returns boolean

Settings

On This Page