Skip to main content

Discovery and capabilities

Three independent checks protect an optional PAPER feature:

  1. Table extent: the function pointer exists in this provider build.
  2. Provider feature: the provider advertises that family.
  3. Granted capability: this owner may call it.

The descriptor-first PaperApi::initialize checks version and extent. Named supports…V1 helpers cover animation evidence/telemetry, reload stages, native pose, motion catalog/diagnostics/manipulation, and development capture.

Capability map

CapabilityPurpose
RuntimeStateRuntime/configuration snapshots.
CapturedTransformsNative animation node capture.
NativeHandPoseHand-in-weapon and 15 finger-local transforms.
AnimationAuthorityAnimation ownership arbitration.
FrameCallbacksEvent callback registration.
ReloadObservationsReload catalogs and frame observations.
ReloadEvidenceGeometryEvidence point clouds.
ReloadAnimationEvidencePassive data plus exact evidence demand.
ReloadAnimationTelemetryPassive/live animation data only.
ReloadStageIdentificationAggregate/per-part semantic stages.
NativePosePipelineResolved pose diagnostics.
WeaponMotionCatalogParts, stages, path keys and followers.
WeaponMotionDiagnosticsLearning and compiled-store diagnostics.
WeaponManipulationTelemetryPer-hand path projection.
DevelopmentCaptureControlBounded development activation leases.

Do not request All. ReloadAnimationTelemetry is intentionally distinct from ReloadAnimationEvidence: telemetry must never start exact off-screen preharvest, while evidence can express that demand when the user's policy allows it.

Registration returns the actual granted mask. Treat missing required bits as a failed integration, unregister the partial owner, and report which feature is unavailable.