Skip to main content

Eventos del ciclo de vida de sesión

Los eventos del ciclo de vida de sesión notifican la creación, eliminación y actualización de sesiones, así como los cambios de estado foreground/background (en modo TUI+servidor).

Tipos de evento

Hay 5 tipos de evento definidos en el enum SessionLifecycleEventType.

Suscribirse a eventos

Puedes suscribirte a los eventos del ciclo de vida con el método onLifecycle().

SessionLifecycleEvent

SessionLifecycleEvent es una readonly class con el detalle del evento del ciclo de vida.

SessionLifecycleEventMetadata

Clase con los metadatos de la sesión (no se incluye en el evento de eliminación).

Gestión de la sesión foreground

Cuando estás conectado a un servidor en modo TUI+servidor (--ui-server), puedes gestionar la sesión foreground.

Obtener la sesión foreground actual

Establecer la sesión foreground

ForegroundSessionInfo

Readonly class con la información de la sesión foreground.

Uso en modo TCP

Puedes aprovechar los eventos del ciclo de vida arrancando Copilot CLI en modo TUI+servidor y conectando desde el SDK.

Consideraciones

  • Los eventos session.foreground y session.background solo se producen en modo TUI+servidor
  • En la eliminación de sesión (session.deleted), la propiedad metadata es null
  • onLifecycle() devuelve un callback para cancelar la suscripción
  • Es una funcionalidad distinta a onSessionStart y onSessionEnd de los Hooks de sesión
Consulta la información más reciente en el repositorio de GitHub.
Última modificación el 13 de julio de 2026