RPC types are defined in src/types/rpc.ts and snapshot-related fields in src/types/snapshot.ts.

Core concepts

  • ObservatorySnapshot: aggregated payload sent to the client panel.
  • ServerFunctions: host-side handlers (snapshot and command handling).
  • ClientFunctions: iframe-side event receiver methods.

Typical flow

  1. Runtime registries update state as instrumented events happen.
  2. Host plugin builds a fresh snapshot.
  3. Snapshot is sent over the bridge to the Observatory client.
  4. Client store updates panel views.

Stability note

Treat snapshot fields as an internal-but-documented contract for this module version line. When changing fields, update docs and tests in the same PR.