Status: Active
Date: April 10, 2026
Owners: OSHUN Metis Engineering, OSHUN Psyche, OSHUN Aja, OSHUN Safety, OSHUN Legal and Rights Governance
Related:
docs/releases/v1/specs/metis-avatar-teacher-profile-contract.mddocs/releases/v1/specs/metis-media-runtime-tiers.mddocs/releases/v1/reports/metis-v1-scorecard.mddocs/releases/v1/specs/todos.mdservices/psyche/voice-engine/src/voice_engine/tts/voice_cloning.pylibs/aja/consent-management/src/types.tsservices/metis/src/metis/services/admin_service.py
1. Purpose#
This document defines the canonical VoiceLikenessConsentRecord contract for
Metis V1.
Metis currently reviews generic likeness-consent records and Psyche voice-clone consents separately, but the educational product still lacks one explicit record that answers:
- whose voice or recognizable vocal likeness is involved
- who granted the permission
- what Metis teacher modes are allowed
- what territories, durations, and surfaces are allowed
- what must happen when consent expires or is revoked
VoiceLikenessConsentRecord is the Metis-owned rights-and-safety record for
voice and vocal-likeness use in teacher representations.
2. Contract Role in the Media Stack#
Order of responsibility:
- Aja owns generic consent primitives.
- Psyche owns low-level
VoiceConsentand clone provisioning checks. - Metis owns the educational consent record that governs teacher voice use across tutoring and lecture modes.
Rule:
- A voice pack must not ship into Metis teacher experiences without at least one
active
VoiceLikenessConsentRecordthat covers the intended use.
3. Canonical Contract#
3.1 Identity#
type VoiceLikenessConsentRecordId = `vlcr_${string}`;
type VoiceLikenessConsentVersionId = `vlcrv_${string}`;
type VoicePackRefId = string;
type AvatarTeacherProfileRefId = string;
3.2 Top-Level Shape#
interface VoiceLikenessConsentRecord {
id: VoiceLikenessConsentRecordId;
versionId: VoiceLikenessConsentVersionId;
subject: VoiceLikenessConsentSubject;
grant: VoiceLikenessConsentGrant;
scope: VoiceLikenessConsentScope;
verification: VoiceLikenessConsentVerification;
linkedAssets: VoiceLikenessLinkedAssets;
lifecycle: VoiceLikenessConsentLifecycle;
createdAt: string;
updatedAt: string;
}
3.3 Subject#
interface VoiceLikenessConsentSubject {
subjectId: string;
subjectType: 'natural_person' | 'rights_holder' | 'institutional_program';
displayName: string;
sourceIdentityReference: string | null;
likenessKinds: ('voice' | 'speech_pattern' | 'name_and_voice_association')[];
}
3.4 Grant#
interface VoiceLikenessConsentGrant {
grantedById: string;
grantRelationship:
| 'self'
| 'legal_guardian'
| 'rights_holder'
| 'institutional_delegate';
consentStatus: 'granted' | 'pending' | 'revoked' | 'expired' | 'denied';
collectionMethod:
| 'written'
| 'signature'
| 'verbal_recording'
| 'api'
| 'form';
allowedUses: (
| 'live_voice_tutor'
| 'live_avatar_tutor'
| 'prerecorded_lecturer'
| 'multilingual_dubbing'
| 'captioned_export'
)[];
prohibitedUses: (
| 'marketing'
| 'general_voice_clone_marketplace'
| 'cross_domain_reuse'
| 'third_party_training'
)[];
restrictions: string[];
}
3.5 Scope#
interface VoiceLikenessConsentScope {
territoryScope: string[] | 'global';
productScope: ('metis_only' | 'oshun_multi_domain')[];
organizationScopeIds: string[];
expiresAt: string | null;
reviewByAt: string | null;
revocationPropagationRequired: boolean;
}
3.6 Verification#
interface VoiceLikenessConsentVerification {
verified: boolean;
verificationMethod:
| 'signature'
| 'biometric'
| 'email'
| 'institutional_attestation';
verifiedAt: string | null;
verifierId: string | null;
evidenceReferences: string[];
}
3.7 Linked Assets#
interface VoiceLikenessLinkedAssets {
voicePackIds: VoicePackRefId[];
avatarTeacherProfileIds: AvatarTeacherProfileRefId[];
psycheVoiceConsentIds: string[];
}
3.8 Lifecycle#
interface VoiceLikenessConsentLifecycle {
active: boolean;
revokedAt: string | null;
revokedById: string | null;
revocationReason: string | null;
auditTrailRequired: boolean;
operatorReviewRequired: boolean;
}
4. Required Invariants#
The contract is invalid if any of the following are false:
- If
grant.consentStatus === 'granted',verification.verifiedmust betrue. - If
grant.allowedUsescontainslive_avatar_tutor, it must also permit eitherlive_voice_tutoror explicitly reference a linked avatar teacher profile inlinkedAssets.avatarTeacherProfileIds. linkedAssets.voicePackIdsmust be non-empty for any consent record used to ship a voice pack.- If
scope.expiresAtis in the past,grant.consentStatusmust beexpiredorlifecycle.activemust befalse. - If
lifecycle.revokedAtis non-null,lifecycle.activemust befalse. grant.prohibitedUsesmust includethird_party_trainingunless the record explicitly states otherwise ingrant.restrictionsand passes separate legal review.scope.productScopemust includemetis_onlyunless cross-domain reuse was explicitly approved.
5. Mapping to Existing Runtime Truth#
VoiceLikenessConsentRecord aligns existing seams that are currently split
across systems:
VoiceLikenessConsentRecord field |
Existing seam |
|---|---|
grant.collectionMethod, scope.*, and verification posture |
libs/aja/consent-management/src/types.ts |
linkedAssets.psycheVoiceConsentIds and voice-clone consent details |
services/psyche/voice-engine/src/voice_engine/tts/voice_cloning.py |
linkedAssets.voicePackIds and educational runtime release review |
Metis admin voice_pack review queue in services/metis/src/metis/services/admin_service.py |
| operator review and blocker posture | Metis admin likeness_consent_record review queue in services/metis/src/metis/services/admin_service.py |
6. Consumer Rules#
6.1 Voice Pack Approval#
A voice pack may not move to approved Metis release unless all linked
VoiceLikenessConsentRecord objects are active and cover the intended product
tier.
6.2 Avatar Teacher Approval#
An AvatarTeacherProfile that references a consent-bound voice pack must
inherit the linked consent record as a release dependency.
6.3 Revocation#
When lifecycle.active becomes false, Metis must treat linked voice packs and
avatar teacher profiles as blocked or restricted until a replacement consent
record is attached and reviewed.
7. Ownership Boundary#
Metis owns:
- educational-use allow lists
- release blocking and revocation propagation
- linkage from consent to teacher profiles and voice packs
Aja owns:
- generic consent primitives and broad consent taxonomy
Psyche owns:
- low-level voice clone consent checks
- clone lifecycle and provider integration
8. Implementation Direction#
V1-MET-090 is complete when Metis docs, review flows, and future runtime
models use VoiceLikenessConsentRecord as the canonical consent object for
teacher voice use instead of treating generic consent rows and Psyche
VoiceConsent entries as sufficient on their own.