24 lines
950 B
Markdown
24 lines
950 B
Markdown
---
|
|
name: shd-realtime-activity
|
|
description: Use when the user asks to inspect SHD realtime events, start or terminate a realtime session, or review operational activity and audit history.
|
|
---
|
|
|
|
# SHD realtime and activity
|
|
|
|
See `references/realtime-contract.md` for session lifecycle and event handling.
|
|
|
|
## Read and observe
|
|
|
|
- Resolve the authorized project/module scope before reading events or audit
|
|
history.
|
|
- Use bounded event reads and preserve event IDs, cursors and timestamps.
|
|
- Distinguish historical audit records from a live realtime session; do not
|
|
claim that an event stream is complete when it was truncated or disconnected.
|
|
|
|
## Session lifecycle
|
|
|
|
Starting or terminating a realtime session is a stateful operation. Require an
|
|
explicit request, retain the returned session ID and scope, avoid duplicate
|
|
starts on retry, and terminate only the requested session. Report connection
|
|
or terminal state rather than fabricating an event.
|