Class SessionManager

Creates and manages the full lifecycle of a single tutoring session.

const manager = new SessionManager(config);
manager.onEvent((e) => analytics.track(e));
await manager.start();
// … session runs …
await manager.end('completed');

Index

Constructors

constructor

Methods

end getSession getSessionId onEvent pause resume start

Constructors

constructor

new SessionManager(config: SessionConfig): SessionManager
Creates a new SessionManager from the provided session configuration. Does not start the session — call start for that.
Parameters
- config: SessionConfig
  Immutable session settings (student, subject, persona, etc.).
Returns SessionManager
- Defined in apps/tutor/src/session/SessionManager.ts:63

Methods

end

end(reason: "completed" | "timeout" | "error" | "aborted"): Promise<void>
Gracefully terminates the session — stops audio, closes the bridge, saves a final checkpoint, and transitions the FSM to TERMINATED.
Parameters
- reason: "completed" | "timeout" | "error" | "aborted"
  Why the session is ending; recorded in the final checkpoint.
Returns Promise<void>
Resolves once all subsystems are torn down.
- Defined in apps/tutor/src/session/SessionManager.ts:84

getSession

getSession(): Session
Returns a snapshot of the live session state.

Returns Session
The current Session object.
- Defined in apps/tutor/src/session/SessionManager.ts:111

getSessionId

getSessionId(): SessionId
Returns the unique identifier of the active session.

Returns SessionId
The SessionId assigned at construction time.
- Defined in apps/tutor/src/session/SessionManager.ts:120

onEvent

onEvent(cb: SessionEventCallback): void
Registers a callback that receives all SessionEvents.
Parameters
- cb: SessionEventCallback
  Called synchronously each time an event fires.
Returns void
- Defined in apps/tutor/src/session/SessionManager.ts:129

pause

pause(): Promise<void>
Pauses the session — suspends audio capture and freezes the session clock.

Returns Promise<void>
Resolves when the session is fully paused.
- Defined in apps/tutor/src/session/SessionManager.ts:93

resume

resume(): Promise<void>
Resumes a paused session.

Returns Promise<void>
Resolves when audio capture and the clock are running again.
- Defined in apps/tutor/src/session/SessionManager.ts:102

start

start(): Promise<void>
Initialises all subsystems, opens the bridge connection to the edge device, starts audio capture, and transitions the FSM to ACTIVE.

Returns Promise<void>
Resolves once the session is fully running.
- Defined in apps/tutor/src/session/SessionManager.ts:73

Class SessionManager

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns SessionManager

Methods

end

Parameters

Returns Promise<void>

getSession

Returns Session

getSessionId

Returns SessionId

onEvent

Parameters

Returns void

pause

Returns Promise<void>

resume

Returns Promise<void>

start

Returns Promise<void>

Settings

On This Page