The renderer-agnostic contract for digital-twin avatars.
Aeon Avatar owns ambient context governance, signal provenance, consent-aware channel routing, and the canonical puppet frame shared by aeon-avatar-3d, Gnosis, and any later non-Three hosts.
AvatarAmbientContext groups ambient channels for environment, body, cognition, and operations — one shared contract for everything a digital-twin avatar reacts to.
Provenance & consent per signal
AvatarAmbientChannel carries per-signal provenance, consent, confidence, freshness, and visibility metadata, so every channel knows where it came from and where it is allowed to surface.
Deterministic governance
classifyAvatarAmbientContext(...) deterministically governs expressive, operational, HUD-only, and stale channels — consent-aware routing without per-renderer guesswork.
Renderer-agnostic puppet frame
AvatarManifest and AvatarPuppetFrame are renderer-agnostic asset and control contracts — the canonical frame shared by aeon-avatar-3d, Gnosis, and later non-Three hosts.
Quickstart
Wire an avatar contract
# add the contract package
pnpm add @a0n/aeon-avatar
import { classifyAvatarAmbientContext } from '@a0n/aeon-avatar';
// deterministic governance over ambient channels:
// expressive, operational, HUD-only, and stale
const classified = classifyAvatarAmbientContext(context);
FAQ
Common questions
Nothing — it is renderer-agnostic. It owns the contracts: ambient context, signal provenance and consent, channel routing, and the canonical puppet frame. Hosts like aeon-avatar-3d and Gnosis consume those contracts to render.
AvatarManifest and AvatarPuppetFrame are the renderer-agnostic avatar asset and control contracts — the shared frame so multiple hosts drive the same avatar without each inventing its own format.
Each AvatarAmbientChannel carries provenance, consent, confidence, freshness, and visibility. classifyAvatarAmbientContext deterministically sorts channels into expressive, operational, HUD-only, and stale, so consent and freshness drive what a renderer is allowed to show.