Skip to main content

Session lifecycle events

Session lifecycle events zijn events die je informeren over het aanmaken, verwijderen en bijwerken van sessions, en over voorgrond-/achtergrondstatuswijzigingen (in TUI+servermodus).

Eventtypes

Er zijn vijf eventtypes, gedefinieerd in de enum SessionLifecycleEventType.

Abonneren op events

Met de methode onLifecycle() kun je je abonneren op session lifecycle events.

SessionLifecycleEvent

SessionLifecycleEvent is een readonly class met de details van het lifecycle-event.

SessionLifecycleEventMetadata

Een klasse met de metadata van de session (niet aanwezig bij een verwijder-event).

Voorgrondsessions beheren

Als je verbonden bent met een server die in TUI+servermodus (--ui-server) draait, kun je de voorgrondsession beheren.

De huidige voorgrondsession ophalen

De voorgrondsession instellen

ForegroundSessionInfo

Een readonly class met informatie over de voorgrondsession.

Gebruik in TCP-modus

Je kunt lifecycle-events benutten door de Copilot CLI in TUI+servermodus te starten en er vanuit de SDK mee te verbinden.

Aandachtspunten

  • De events session.foreground en session.background treden alleen op in TUI+servermodus
  • Bij het verwijderen van een session (session.deleted) is de property metadata null
  • onLifecycle() retourneert een callback-functie om het abonnement op te zeggen
  • Dit is losstaande functionaliteit van onSessionStart en onSessionEnd van Session hooks
Raadpleeg de GitHub-repository voor de meest actuele informatie.
Laatst gewijzigd op 6 september 2026