Events

The client SDK streams telemetry events continuously to the session actor.

Event types

• navigation — Page navigations (URL changes)
• net.request — Outgoing network requests
• net.response — Network responses (URL, status, method, headers)
• console — Console messages from the webview
• error.uncaught — Uncaught JavaScript errors
• performance — Performance timing entries

Deduplication

Events include a clientSeq sequence number. The session actor deduplicates events to handle retransmission during reconnection.

Storage

All events are persisted in the session actor’s database. They are the source of truth for yieldToUser condition evaluation.

Retrieving events

Events can be fetched via the API:

• Session Service: GET /sessions/:id/events
• Platform Service: GET /v1/sessions/:id/events

Next steps

• Yield to User — How events drive yield conditions
• Protocol: Events — Wire format for event messages