Skip to main content
Synheart Core’s internal state model is HSV (Human State Vector). HSV is designed for fast, type-safe, on-device computation inside the SDK (Dart/Kotlin/Swift). When Synheart Core needs to interoperate with external systems, it exports HSV as HSI 1.0 (a JSON wire format). If you’re looking for the general, SDK-agnostic HSI contract, start here:

​
What HSV is (in Synheart Core)

At a high level, HSV represents human state as:
  • Axes: conceptual dimensions (e.g. affect / engagement / activity / context)
  • Indices: convenient derived scalars (e.g. arousalIndex, engagementStability)
  • Windows: time-scoped summaries (e.g. 30s / 5m / 1h / 24h)
  • Embedding (optional): a compact vector representation used for downstream heads (and optionally export, subject to consent/capability)

​
HSV → HSI

Synheart Core can export internal HSV into HSI 1.0 payloads for interoperability.
Last Updated: 2025-12-29